OCRA Configuration

The component accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the component, access to these internal properties is provided through the Config method.

OCRA Configuration Settings

CounterHex: The counter value as a hexadecimal string.

This setting may be used instead of Counter to supply the counter value. This is specified as a Hexadecimal string and may be used to provide large values like "FFFFFFFFFFFFFFFF".

PasswordHashAlgorithm: The password hash algorithm.

This setting specifies the password hash algorithm. Possible values are:


0 (default)	SHA1
1	SHA-256
2	SHA-512

TimeStepSize: The time step.

The size of the time step. The default value is 1.

TimeStepUnit: The time step unit.

This setting specifies the time step unit. Possible values are:


0	Seconds
1 (default)	Minutes
2	Hours

CurrentTime: The current time in milliseconds.

This setting specifies the current time in milliseconds since the Unix epoch (January 1, 1970). By default the component will use the system time when CalculateResponse or VerifyResponse is called and RequireTimeStamp is True. This setting overrides the value returned by the system.

RequireSessionInfo: Whether to use session information.

This setting specifies whether session info is required to create the response.

This may be set before calling CreateChallenge, when the OCRASuite is generated.

When OCRASuite is assigned this value is updated to reflect the options specified in the OCRASuite

SessionInfoLength: The length of the session information.

This setting specifies the length of the session information.

This may be set before calling CreateChallenge, when the OCRASuite is generated.

When OCRASuite is assigned this value is updated to reflect the options specified in the OCRASuite

Common values are 64, 128, 256, and 512.

SessionInfo: The session information.

This setting specifies the session info when RequireSessionInfo is set to True. This value should be specified before calling CalculateResponse or VerifyResponse, and should be of length SessionInfoLength.

Base Configuration Settings


	GUIAvailable: Tells the component whether or not a message loop is available for processing events. In a GUI-based application, long-running blocking operations may cause the application to stop responding to input until the operation returns. The component will attempt to discover whether or not the application has a message loop and, if one is discovered, it will process events in that message loop during any such blocking operation. In some non-GUI applications an invalid message loop may be discovered that will result in errant behavior. In these cases, setting GuiAvailable to false will ensure that the component does not attempt to process external events.
	UseBackgroundThread: Whether threads created by the component are background threads. If set to True, when the component creates a thread the thread's IsBackground property will be explicitly set to True. By default this setting is False.
	UseManagedSecurityAPI: Tells the component whether or not to use the system security libraries or a managed implementation. By default the component will use the system security libraries to perform cryptographic functions. This means calls to unmanaged code will be made. In certain environments this is not desirable. To use a completely managed security implementation set this setting to True. Setting this to True tells the component to use the internal managed implementation instead of using the system's security API. Note that when this value is set the product's system dll is no longer required as a reference, as all unmanaged code is stored in this file.