Interface IEbicsSecurityMediumSignature

Namespace

Subsembly.EBICS

Assembly

Subsembly.EBICS.Core.dll

Interface for security media that needs a different password for digital signatures (A006, A005, or A004).

public interface IEbicsSecurityMediumSignature

Remarks

If this interface is implemented in parallel to IEbicsSecurityMedium, it implies that a separate digital signature password is needed for this security media. Through this interface a user entered digital signature password can be managed and presented to the implementation. Only after presenting a valid digital signature password, access to the digital signature keys is permitted.

For a software based security medium the initial password for a newly created security medium is equal to the authentication PIN that was provided to Create(string, string). If CanChangeSignaturePassword is true, it can then be changed to a different password by calling ChangeSignaturePassword(string, string).

Properties

CanChangeSignaturePassword

Indicates whether the digital signature password of the security medium can be changed via ChangeSignaturePassword(string, string).

bool CanChangeSignaturePassword { get; }

Property Value

bool

NeedAuthenticateSignature

Indicates whether the digital signature key must be authenticated via AuthenticateSignature(string) before a digital signature is computed.

bool NeedAuthenticateSignature { get; }

Property Value

bool

Remarks

This must be checked before each and every digital signature, because an authentication of the digital signature key may only be valid for computing a single digital signature.

Methods

AuthenticateSignature(string)

Provides the digital signature password for digital signatures.

bool AuthenticateSignature(string sPassword)

Parameters

sPassword string

The user provided digital signature password. This must not be null. This is not required to fulfill the requirements of the EbicsPasswordInfo returned by GetSignaturePasswordInfo(), because password policies may change.

Returns

bool

ChangeSignaturePassword(string, string)

Change the digital signature password.

bool ChangeSignaturePassword(string sOldPassword, string sNewPassword)

Parameters

sOldPassword string

The old digital signature password. This must not be null. This is not required to fulfill the requirements of the EbicsPasswordInfo returned by GetSignaturePasswordInfo(), because password policies may change.

sNewPassword string

The new digital signature password. This must not be null and must fulfill the requirements of the EbicsPasswordInfo returned by GetSignaturePasswordInfo().

Returns

bool

GetSignaturePasswordInfo()

Provides information about the digital signature password that must be passed to AuthenticateSignature(string).

EbicsPasswordInfo GetSignaturePasswordInfo()

Returns

EbicsPasswordInfo

An instance EbicsPasswordInfo that describes the digital signature password. The instance properties must not be changed. The return value is never null.

Remarks

The password policy restrictions (e.g. MinLength and MaxLength) shall only be applied for new passwords given to ChangeSignaturePassword(string, string).