Class FinTanProcInfo

Simple class that collects the information required when presenting a TAN procedure for user selection.

Inheritance
object
FinTanProcInfo
Inherited Members
Namespace: Subsembly.FinTS
Assembly: Subsembly.FinTS.Core.dll
Syntax
public class FinTanProcInfo
Remarks

This class provides the Description which contains a user readable string that is suitable for a combo box or other selection GUI.

Constructors

FinTanProcInfo(FinTanProcessParameters)

Declaration
public FinTanProcInfo(FinTanProcessParameters aTanProc)
Parameters
Type Name Description
FinTanProcessParameters aTanProc

Properties

Description

User readable description of this TAN procedure.

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

The description is just a combination of Name and TechnicalIdentification. Thus, the value is never null or an empty string.

Name

The user readable name of the TAN procedure.

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

This value is never null or an empty string.

SecurityFunction

The security function code of the TAN procedure.

Declaration
public int SecurityFunction { get; }
Property Value
Type Description
int

The value zero means that the security function code is not known. The value 999 indicates the simple one-step TAN procedure. Other codes in the range from 900 through 997 indicate special two step TAN procedures.

TanMediaClass

The TAN media class.

Declaration
public string TanMediaClass { get; }
Property Value
Type Description
string
Remarks

If a TAN media class could be determined, then this is either "G" for a TAN Generator (chipTAN, SmartTAN) or "M" for Mobile-TAN (smsTAN). If the TAN media class could not be determined, then null is returned.

See Also

TanMediaNameReqd

Declaration
public int TanMediaNameReqd { get; }
Property Value
Type Description
int

TanProcType

Declaration
public FinTanProcType TanProcType { get; }
Property Value
Type Description
FinTanProcType

TanProcessParameters

The TAN process parameters of this TAN procedure. May be null, if not applicable or unknown.

Declaration
public FinTanProcessParameters TanProcessParameters { get; }
Property Value
Type Description
FinTanProcessParameters

TechnicalIdentification

The technical identification of the TAN procedure.

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

The value null means that the technical identification is not known, or the simple one-step TAN procedure.

Methods

GetAllowedTanProcs(FinContact)

Determines an array of 2-step TAN procedures that are allowed for a particular contact.

Declaration
public static FinTanProcInfo[] GetAllowedTanProcs(FinContact aContact)
Parameters
Type Name Description
FinContact aContact

The contact for which to determine the allowed TAN procedures.
Returns
Type Description
FinTanProcInfo[]

If the given contact is not synchronised, and does not have any BPD, then null is returned. In any other case an array with all allowed TAN procedures is returned. The returned array may be empty. The classic TAN procedure 999 is never returned.
Exceptions
Type Condition
ArgumentNullException

The parameter aContact was null.
ArgumentException

The given contact does not use PIN/TAN security, i.e. IsPinTan is false.

GuessTanProcType(string)

Tries to classify a TANprocedured based on its technical identification.

Declaration
public static FinTanProcType GuessTanProcType(string sTechnicalIdentification)
Parameters
Type Name Description
string sTechnicalIdentification

The technical identification of a TAN procedure. If this is null, then Unknown is returned.
Returns
Type Description
FinTanProcType

ToString()

Always returns the value of Description.

Declaration
public override string ToString()
Returns
Type Description
string
Overrides