Class FinSecurityMediaZKA

Namespace
Subsembly.FinTS
Assembly
Subsembly.FinTS.SmartCard.dll

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

public class FinSecurityMediaZKA : FinSecurityMediaSmartCard, IFinSecurityMedia, IFinSecurityMediaSmartCard
Inheritance
FinSecurityMediaZKA
Implements
Inherited Members

Constructors

FinSecurityMediaZKA()

public FinSecurityMediaZKA()

Methods

OnChangePin(string, string)

protected override FinAuthenticateResult OnChangePin(string sOldPin, string sNewPin)

Parameters

sOldPin string

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.

sNewPin string

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

FinAuthenticateResult

OnChangePinSecure()

protected override FinAuthenticateResult OnChangePinSecure()

Returns

FinAuthenticateResult

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

protected override byte[] OnDecrypt(FinContact aContact, FinSecureKey aKey, FinOperationMode nOpMode, byte[] vbCrypt)

Parameters

aContact FinContact
aKey FinSecureKey
nOpMode FinOperationMode
vbCrypt byte[]

Returns

byte[]

OnEraseContact(int)

protected override void OnEraseContact(int nContactIndex)

Parameters

nContactIndex int

OnGetCapabilities()

protected override FinSecurityMediaCaps OnGetCapabilities()

Returns

FinSecurityMediaCaps

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

OnGetContactCapacity()

protected override int OnGetContactCapacity()

Returns

int

Currently always returns the constant value 5.

OnGetMaxKeyLength()

protected override int OnGetMaxKeyLength()

Returns

int

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.

OnGetPassphraseFlags()

protected override FinSecurityMediaPassphraseFlags OnGetPassphraseFlags()

Returns

FinSecurityMediaPassphraseFlags

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

OnGetPassphraseMaxLength()

protected override int OnGetPassphraseMaxLength()

Returns

int

Always returns 8.

OnGetPassphraseMinLength()

protected override int OnGetPassphraseMinLength()

Returns

int

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.

OnGetSecurityProfiles()

protected override FinSecurityProfile[] OnGetSecurityProfiles()

Returns

FinSecurityProfile[]

OnInitContact(FinContact)

protected override void OnInitContact(FinContact aContact)

Parameters

aContact FinContact

OnReadContact(FinContact, int)

protected override void OnReadContact(FinContact aContact, int nContactIndex)

Parameters

aContact FinContact
nContactIndex int

OnReadKey(FinContact, FinSecureKeyType, int, int)

protected override FinSecureKey OnReadKey(FinContact aContact, FinSecureKeyType nKeyType, int nKeyNumber, int nKeyVersion)

Parameters

aContact FinContact
nKeyType FinSecureKeyType
nKeyNumber int
nKeyVersion int

Returns

FinSecureKey

OnReleaseCard(CardExpress)

protected override void OnReleaseCard(CardExpress aCard)

Parameters

aCard CardExpress

OnSelectCard(CardExpress)

protected override byte[] OnSelectCard(CardExpress aCard)

Parameters

aCard CardExpress

Returns

byte[]

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

protected override byte[] OnSignHash(FinContact aContact, FinSecureKey aKey, FinOperationMode nOpMode, FinHash nHash, byte[] vbHash)

Parameters

aContact FinContact
aKey FinSecureKey
nOpMode FinOperationMode
nHash FinHash
vbHash byte[]

Returns

byte[]

OnUpdateKeyState(FinContact, FinSecureKey)

protected override void OnUpdateKeyState(FinContact aContact, FinSecureKey aKey)

Parameters

aContact FinContact
aKey FinSecureKey

OnVerifyPin(string)

protected override FinAuthenticateResult OnVerifyPin(string sPin)

Parameters

sPin string

Returns

FinAuthenticateResult

OnVerifyPinSecure()

protected override FinAuthenticateResult OnVerifyPinSecure()

Returns

FinAuthenticateResult

OnWriteContact(FinContact, int)

protected override void OnWriteContact(FinContact aContact, int nContactIndex)

Parameters

aContact FinContact
nContactIndex int