PBKDF Component

Properties Methods Events Configuration Settings Errors

The PBKDF component supports using PBKDF1 and PBKDF2 to derive a key using a variety of algorithms.

Syntax

TipcPBKDF

Remarks

The PBKDF component implements PBKDF2(Password-Based Key Derivation Function 2) and PBKDF1 described in RFC 2898.

The simplest way to use the component is to simply specify the Password and Salt and call CreateKey. Before calling CreateKey additional properties such as Algorithm, KeyLength, and Iterations may be set. The component supports a variety of algorithms including HMAC-SHA1, HMAC-SHA256, HMAC-MD5, and more.

The Version property controls whether PBKDF1 or PBKDF2 (default) is used, although it is recommended to use PBKDF2.

After calling CreateKey the derived key will be held in Key.

Code Example:

Pbkdf pbkdf = new Pbkdf();
pbkdf.Password = "password";
pbkdf.Salt = "0123456789ABCDEF";
pbkdf.KeyLength = 4096;
pbkdf.CreateKey();
      
//Now do something with pbkdf.Key

Property List

The following is the full list of the properties of the component with short descriptions. Click on the links for further details.


Algorithm	The underlying pseudorandom function.
Iterations	The number of iterations to perform.
Key	The derived key.
KeyLength	The desired length in bits of the derived key.
Password	The master password from which a derived key is generated.
Salt	The cryptographic salt.
UseHex	Whether the key is hex encoded.
Version	The PBKDF version.

Method List

The following is the full list of the methods of the component with short descriptions. Click on the links for further details.


Config	Sets or retrieves a configuration setting.
CreateKey	Creates a derived key.
Reset	Resets the component.

Event List

The following is the full list of the events fired by the component with short descriptions. Click on the links for further details.


Error	Information about errors during data delivery.

Configuration Settings

The following is a list of configuration settings for the component with short descriptions. Click on the links for further details.


AllowEmptyPassword	Whether an empty password can be used.
BuildInfo	Information about the product's build.
CodePage	The system code page used for Unicode to Multibyte translations.
LicenseInfo	Information about the current license.
UseInternalSecurityAPI	Tells the component whether or not to use the system security libraries or an internal implementation.