Class FinSecurityMediaRDH

Implements the IFinSecurityMedia and IFinSecurityMediaSetup interfaces for RDH files as defined by the DDBAC.

Inheritance
System.Object
FinSecurityMediaRDH
Implements
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.ToString()
Namespace: Subsembly.FinTS
Assembly: Subsembly.FinTS.Core.dll
Syntax
public class FinSecurityMediaRDH : IFinSecurityMedia

Constructors

FinSecurityMediaRDH()

Declaration
public FinSecurityMediaRDH()

Properties

Capabilities

Declaration
public FinSecurityMediaCaps Capabilities { get; }
Property Value
Type Description
FinSecurityMediaCaps

ContactCapacity

Always returns 1.

Declaration
public int ContactCapacity { get; }
Property Value
Type Description
System.Int32

MaxKeyLength

Declaration
public int MaxKeyLength { get; }
Property Value
Type Description
System.Int32

PassphraseFlags

Always returns CanChange.

Declaration
public FinSecurityMediaPassphraseFlags PassphraseFlags { get; }
Property Value
Type Description
FinSecurityMediaPassphraseFlags

PassphraseMaxLength

Always returns 256.

Declaration
public int PassphraseMaxLength { get; }
Property Value
Type Description
System.Int32

PassphraseMinLength

Always returns 0.

Declaration
public int PassphraseMinLength { get; }
Property Value
Type Description
System.Int32

SecurityMediaID

Provides the filename of the currently selected keyfile. Returns null if none was selected so far.

Declaration
public string SecurityMediaID { get; }
Property Value
Type Description
System.String

SecurityMediaType

Always returns KeyFile.

Declaration
public FinSecurityMediaType SecurityMediaType { get; }
Property Value
Type Description
FinSecurityMediaType

SecurityProfiles

Always just returns "RDH-1".

Declaration
public FinSecurityProfile[] SecurityProfiles { get; }
Property Value
Type Description
FinSecurityProfile[]

State

Indicates the current state of this FinSecurityMediaRDH instance.

Declaration
public FinSecurityMediaState State { get; }
Property Value
Type Description
FinSecurityMediaState

Methods

Authenticate(String, String)

Authenticate access to secure keys on keyfile with the given passphrase.

Declaration
public FinAuthenticateResult Authenticate(string sUserName, string sPassphrase)
Parameters
Type Name Description
System.String sUserName
System.String sPassphrase
Returns
Type Description
FinAuthenticateResult

AuthenticateAdmin(String, String)

Declaration
public FinAuthenticateResult AuthenticateAdmin(string sUserName, string sAdminPassphrase)
Parameters
Type Name Description
System.String sUserName
System.String sAdminPassphrase
Returns
Type Description
FinAuthenticateResult

AuthenticateSecure()

Always just returns AuthenticateSecureNotSupported

Declaration
public FinAuthenticateResult AuthenticateSecure()
Returns
Type Description
FinAuthenticateResult

CanAuthenticateSecure()

Declaration
public bool CanAuthenticateSecure()
Returns
Type Description
System.Boolean

Cancel()

Declaration
public void Cancel()

CanChangePassphraseSecure()

Declaration
public bool CanChangePassphraseSecure()
Returns
Type Description
System.Boolean

ChangePassphrase(String, String, String)

Declaration
public FinAuthenticateResult ChangePassphrase(string sUserName, string sOldPassphrase, string sNewPassphrase)
Parameters
Type Name Description
System.String sUserName
System.String sOldPassphrase
System.String sNewPassphrase
Returns
Type Description
FinAuthenticateResult

ChangePassphraseSecure()

Always just returns AuthenticateSecureNotSupported

Declaration
public FinAuthenticateResult ChangePassphraseSecure()
Returns
Type Description
FinAuthenticateResult

Create(String, String, String)

Creates a new RDH key file in the DDBAC standard format.

Declaration
public void Create(string sSecurityMediaID, string sUserName, string sPassphrase)
Parameters
Type Name Description
System.String sSecurityMediaID
System.String sUserName
System.String sPassphrase

CreateContact()

Declaration
public FinContact CreateContact()
Returns
Type Description
FinContact

Decrypt(FinContact, FinSecureKey, FinOperationMode, Byte[])

Declaration
public byte[] Decrypt(FinContact aContact, FinSecureKey aKey, FinOperationMode nOpMode, byte[] vbCrypt)
Parameters
Type Name Description
FinContact aContact
FinSecureKey aKey
FinOperationMode nOpMode
System.Byte[] vbCrypt
Returns
Type Description
System.Byte[]

ElevateKey(FinContact, FinSecureKey, FinSecureKeyState)

Declaration
public void ElevateKey(FinContact aContact, FinSecureKey aKey, FinSecureKeyState nNewKeyState)
Parameters
Type Name Description
FinContact aContact
FinSecureKey aKey
FinSecureKeyState nNewKeyState

Encrypt(FinContact, FinSecureKey, FinOperationMode, Byte[])

Declaration
public byte[] Encrypt(FinContact aContact, FinSecureKey aKey, FinOperationMode nOpMode, byte[] vbData)
Parameters
Type Name Description
FinContact aContact
FinSecureKey aKey
FinOperationMode nOpMode
System.Byte[] vbData
Returns
Type Description
System.Byte[]

EraseContact(Int32)

Declaration
public void EraseContact(int nContactIndex)
Parameters
Type Name Description
System.Int32 nContactIndex

EraseKey(FinContact, FinSecureKey)

Declaration
public void EraseKey(FinContact aContact, FinSecureKey aKey)
Parameters
Type Name Description
FinContact aContact
FinSecureKey aKey

GenerateKey(FinContact, FinSecureKeyType, Int32, Int32, Int32)

Generates a new public/private key pair.

Declaration
public FinSecureKey GenerateKey(FinContact aContact, FinSecureKeyType nKeyType, int nKeyLength, int nKeyNumber, int nKeyVersion)
Parameters
Type Name Description
FinContact aContact
FinSecureKeyType nKeyType
System.Int32 nKeyLength
System.Int32 nKeyNumber
System.Int32 nKeyVersion
Returns
Type Description
FinSecureKey

InitPassphrase(String, String)

Always throws a NotSupportedException.

Declaration
public FinAuthenticateResult InitPassphrase(string sUserName, string sPassphrase)
Parameters
Type Name Description
System.String sUserName
System.String sPassphrase
Returns
Type Description
FinAuthenticateResult

ObtainContact(Int32)

Declaration
public FinContact ObtainContact(int nContactIndex)
Parameters
Type Name Description
System.Int32 nContactIndex
Returns
Type Description
FinContact

ObtainKey(FinContact, FinSecureKeyType, Int32, Int32)

Declaration
public FinSecureKey ObtainKey(FinContact aContact, FinSecureKeyType nKeyType, int nKeyNumber, int nKeyVersion)
Parameters
Type Name Description
FinContact aContact
FinSecureKeyType nKeyType
System.Int32 nKeyNumber
System.Int32 nKeyVersion
Returns
Type Description
FinSecureKey

Release()

Declaration
public void Release()

ResetKey(FinContact, FinSecureKey)

Declaration
public void ResetKey(FinContact aContact, FinSecureKey aKey)
Parameters
Type Name Description
FinContact aContact
FinSecureKey aKey

Select(String)

Selects a key file for subsequent access through this FinSecurityMediaRDH instance.

Declaration
public FinAuthenticateResult Select(string sSecurityMediaID)
Parameters
Type Name Description
System.String sSecurityMediaID
Returns
Type Description
FinAuthenticateResult

SignHash(FinContact, FinSecureKey, FinOperationMode, FinHash, Byte[])

Declaration
public byte[] SignHash(FinContact aContact, FinSecureKey aKey, FinOperationMode nOpMode, FinHash nHash, byte[] vbHash)
Parameters
Type Name Description
FinContact aContact
FinSecureKey aKey
FinOperationMode nOpMode
FinHash nHash
System.Byte[] vbHash
Returns
Type Description
System.Byte[]

StoreContact(Int32, FinContact)

Stores or updates the contact data record on the security media.

Declaration
public void StoreContact(int nContactIndex, FinContact aContact)
Parameters
Type Name Description
System.Int32 nContactIndex
FinContact aContact

StoreKey(FinContact, FinSecureKey)

Stores or updates the public bank key on the security media.

Declaration
public void StoreKey(FinContact aContact, FinSecureKey aKey)
Parameters
Type Name Description
FinContact aContact
FinSecureKey aKey

Verify(FinContact, FinSecureKey, FinOperationMode, FinHash, Byte[], Byte[])

Declaration
public bool Verify(FinContact aContact, FinSecureKey aKey, FinOperationMode nOpMode, FinHash nHash, byte[] vbHash, byte[] vbSignature)
Parameters
Type Name Description
FinContact aContact
FinSecureKey aKey
FinOperationMode nOpMode
FinHash nHash
System.Byte[] vbHash
System.Byte[] vbSignature
Returns
Type Description
System.Boolean

Implements