Class FinSecurityMediaZKA

Implements the IFinSecurityMedia interface for SECCOS (FinTS 3.0) cards.

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

Constructors

FinSecurityMediaZKA()

Declaration
public FinSecurityMediaZKA()

Methods

OnChangePin(String, String)

Declaration
protected override FinAuthenticateResult OnChangePin(string sOldPin, string sNewPin)
Parameters
Type Name Description
System.String sOldPin

The old PIN must consist of at least 4 and at most 8 characters. If an old PIN with any other length is provided, then BadPassphrase is returned.
System.String sNewPin

The new PIN must consist of at least 6 and at most 8 characters. If a new PIN with any other length is provided, then BadPassphrase is returned.
Returns
Type Description
FinAuthenticateResult
Overrides

OnChangePinSecure()

Declaration
protected override FinAuthenticateResult OnChangePinSecure()
Returns
Type Description
FinAuthenticateResult
Overrides

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

Declaration
protected override byte[] OnDecrypt(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[]
Overrides

OnEraseContact(Int32)

Declaration
protected override void OnEraseContact(int nContactIndex)
Parameters
Type Name Description
System.Int32 nContactIndex
Overrides

OnGetCapabilities()

Declaration
protected override FinSecurityMediaCaps OnGetCapabilities()
Returns
Type Description
FinSecurityMediaCaps

Returns a constant value that combines the flags CanStoreContact, CanUpdateUserKeys, and CanVerifyEncrypt.
Overrides

OnGetContactCapacity()

Declaration
protected override int OnGetContactCapacity()
Returns
Type Description
System.Int32

Currently always returns the constant value 5.
Overrides

OnGetMaxKeyLength()

Declaration
protected override int OnGetMaxKeyLength()
Returns
Type Description
System.Int32

Always returns 500, which is the theoretical maximum key length of the most advanced SECCOS card type. In reality, a particular SECCOS card may have a much shorter maximum key length.
Overrides

OnGetPassphraseFlags()

Declaration
protected override FinSecurityMediaPassphraseFlags OnGetPassphraseFlags()
Returns
Type Description
FinSecurityMediaPassphraseFlags

Returns CanChange, because the CSA password can be changed and can contain any ASCII characters.
Overrides

OnGetPassphraseMaxLength()

Declaration
protected override int OnGetPassphraseMaxLength()
Returns
Type Description
System.Int32

Always returns 8.
Overrides

OnGetPassphraseMinLength()

Declaration
protected override int OnGetPassphraseMinLength()
Returns
Type Description
System.Int32

Always returns 4, which is the absolute min length of the CSA password. Note that in order to be usable, a CSA password must consist of at least 6 characters. Shorter CSA passwords are only used as transport passwords.
Overrides

OnGetSecurityProfiles()

Declaration
protected override FinSecurityProfile[] OnGetSecurityProfiles()
Returns
Type Description
FinSecurityProfile[]
Overrides

OnInitContact(FinContact)

Declaration
protected override void OnInitContact(FinContact aContact)
Parameters
Type Name Description
FinContact aContact
Overrides

OnReadContact(FinContact, Int32)

Declaration
protected override void OnReadContact(FinContact aContact, int nContactIndex)
Parameters
Type Name Description
FinContact aContact
System.Int32 nContactIndex
Overrides

OnReadKey(FinContact, FinSecureKeyType, Int32, Int32)

Declaration
protected override FinSecureKey OnReadKey(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
Overrides

OnReleaseCard(CardExpress)

Declaration
protected override void OnReleaseCard(CardExpress aCard)
Parameters
Type Name Description
Subsembly.SmartCard.CardExpress aCard
Overrides

OnSelectCard(CardExpress)

Declaration
protected override byte[] OnSelectCard(CardExpress aCard)
Parameters
Type Name Description
Subsembly.SmartCard.CardExpress aCard
Returns
Type Description
System.Byte[]
Overrides

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

Declaration
protected override byte[] OnSignHash(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[]
Overrides

OnUpdateKeyState(FinContact, FinSecureKey)

Declaration
protected override void OnUpdateKeyState(FinContact aContact, FinSecureKey aKey)
Parameters
Type Name Description
FinContact aContact
FinSecureKey aKey
Overrides

OnVerifyPin(String)

Declaration
protected override FinAuthenticateResult OnVerifyPin(string sPin)
Parameters
Type Name Description
System.String sPin
Returns
Type Description
FinAuthenticateResult
Overrides

OnVerifyPinSecure()

Declaration
protected override FinAuthenticateResult OnVerifyPinSecure()
Returns
Type Description
FinAuthenticateResult
Overrides

OnWriteContact(FinContact, Int32)

Declaration
protected override void OnWriteContact(FinContact aContact, int nContactIndex)
Parameters
Type Name Description
FinContact aContact
System.Int32 nContactIndex
Overrides

Implements