Class EbicsSecurityMediumSeccos

Inheritance
object
EbicsSecurityMediumSeccos
Implements
Inherited Members
Namespace: Subsembly.EBICS
Assembly: Subsembly.EBICS.SmartCard.dll
Syntax
public class EbicsSecurityMediumSeccos : IEbicsSecurityMedium, IEbicsSecurityOperations, IEbicsSecurityMediumClass2, IEbicsSecurityMediumSignaturePin
Remarks

Generally an IEbicsSecurityMedium implementation only supports a single authentication PIN. SECCOS smart cards, however, have two different PINs for authentication and digital signatures. The digital signature PIN can be provided to this implementation through the special method SetSignaturePIN(string). If this isn't done, then the implementation will attempt a secure PIN entry, if possible.

Fields

CLASSNAME

Declaration
public const string CLASSNAME = "Subsembly.EBICS.EbicsSecurityMediumSeccos"
Field Value
Type Description
string

Properties

CanChangePIN

Indicates whether the PIN can be changed.

Declaration
public bool CanChangePIN { get; }
Property Value
Type Description
bool
Remarks

This property is always true.

Only changing the CSA-PIN of a SECCOS smart card is supported by the SECCOS ChangePIN(string, string) implementation. Changing the Signatur-PIN is supported by the special ChangeSignaturePIN(string, string) method.

HaveSignaturePIN

Declaration
public bool HaveSignaturePIN { get; }
Property Value
Type Description
bool

IsClass2

Declaration
public bool IsClass2 { get; }
Property Value
Type Description
bool

LastError

Declaration
public EbicsSecurityMediumErrorCode LastError { get; }
Property Value
Type Description
EbicsSecurityMediumErrorCode

SecurityMedium

Declaration
public string SecurityMedium { get; }
Property Value
Type Description
string

SecurityMediumID

Declaration
public string SecurityMediumID { get; }
Property Value
Type Description
string

SecurityMediumType

Declaration
public EbicsSecurityMediumType SecurityMediumType { get; }
Property Value
Type Description
EbicsSecurityMediumType

State

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

SupportedSecurityCodes

Declaration
public EbicsSecurityCode SupportedSecurityCodes { get; }
Property Value
Type Description
EbicsSecurityCode

Methods

Authenticate(string)

Declaration
public bool Authenticate(string sPIN)
Parameters
Type Name Description
string sPIN

The CSA-PIN of the SECCOS card. If null, then this will try a secure authentication at the card reader PIN pad.
Returns
Type Description
bool
Remarks

If a digital signature shall be done, then it may be necessary to provide the digital signature PIN through SetSignaturePIN(string) in addition to the CSA-PIN.

AuthenticateSecure()

Declaration
public bool AuthenticateSecure()
Returns
Type Description
bool
See Also

ChangePIN(string, string)

Changes the CSA-PIN.

Declaration
public bool ChangePIN(string sOldPIN, string sNewPIN)
Parameters
Type Name Description
string sOldPIN

The old CSA-PIN or the Transport-CSA-PIN. This must not be null. The given PIN must have a length between four and eight digits.
string sNewPIN

The new CSA-PIN. This must not be null. This must have a length between six and eight digits.
Returns
Type Description
bool
Remarks

A SECCOS smart card has two different PINs, the CSA-PIN and the Signature-PIN. The method Authenticate(string) expects the CSA-PIN and therefore this method also changes the CSA-PIN. In order to change the Signature-PIN the special method ChangeSignaturePIN(string, string) is provided.

When this method returns the the security medium is still in the Selected state.

Exceptions
Type Condition
ArgumentNullException

One of the parameters was null.
ArgumentException

One of the given PINs has an inappropriate length.
InvalidOperationException

The current State was not Selected

ChangePINSecure()

Changes the CSA-PIN by using the PIN pad of a class 2 card reader.

Declaration
public bool ChangePINSecure()
Returns
Type Description
bool
See Also

ChangeSignaturePIN(string, string)

Changes the Signature-PIN.

Declaration
public bool ChangeSignaturePIN(string sOldPIN, string sNewPIN)
Parameters
Type Name Description
string sOldPIN

The current Signature PIN to be changed. This can be the initial five digit Transport PIN or a real PIN. The length of this PIN must be from four to twelve digits. A Transport PIN has five digits.
string sNewPIN

The new Signature PIN to use. The length of this PIN must be from six to twelve digits. A PIN length of six digits is recommended.
Returns
Type Description
bool
Remarks

When this method returns the the security medium is still in the Selected state.

Exceptions
Type Condition
ArgumentNullException

Either parameter was null.
ArgumentException

The length of either PIN was not within the requirements.
InvalidOperationException

The current State was not Selected

ChangeSignaturePINSecure()

Declaration
public bool ChangeSignaturePINSecure()
Returns
Type Description
bool

Create(string, string)

Not supported by smart cards and therefore returns always false.

Declaration
public bool Create(string sSecurityMediaID, string sPIN)
Parameters
Type Name Description
string sSecurityMediaID
string sPIN
Returns
Type Description
bool

Detect()

Detect SECCOS card in any connected card reader.

Declaration
public static string Detect()
Returns
Type Description
string

The card ID that must be passed to Select(string), if a SECCOS card was found. Or null if no card was found.
Remarks

If a SECCOS card is found then its unique card ID is returned. If no SECCOS card is found, then null is returned. If multiple SECCOS cards are available, then this method returns the first one that is found.

GetPasswordInfo()

Declaration
public EbicsPasswordInfo GetPasswordInfo()
Returns
Type Description
EbicsPasswordInfo

GetSecurityOperations(EbicsContact)

Declaration
public IEbicsSecurityOperations GetSecurityOperations(EbicsContact aContact)
Parameters
Type Name Description
EbicsContact aContact
Returns
Type Description
IEbicsSecurityOperations

Release()

Declaration
public void Release()

Select(string)

Declaration
public bool Select(string sSecurityMediaID)
Parameters
Type Name Description
string sSecurityMediaID
Returns
Type Description
bool

SetSignaturePIN(string)

Provide the Signature-PIN for accessing the digital signature key.

Declaration
public void SetSignaturePIN(string sPIN)
Parameters
Type Name Description
string sPIN

The PIN that shall be used when access to the digital signature key is required. If the value null is set, then a secure PIN entry is attempted instead.
Remarks

By default the digital signature PIN is not set, thus a secure PIN entry is attempted, whenever access to the digital signature key is required. By setting a PIN through this method, it is possible to provide a PIN for card readers that do not support a secure PIN entry.

Implements