xml.CryptoKey.deriveKey

Derives the symmetric or HMAC CryptoKey object using the given method identifier and concatenating the optional label, the mandatory seed value and the optional created date as initial random value.

Syntax

deriveKey(
   url STRING,
   label STRING,
   seed STRING,
   created STRING,
   offset INTEGER,
   bytes INTEGER )
  1. url defines the identifier of the algorithm to apply to the password and its inputs.
  2. label defines the optional label input.
  3. seed defines the mandatory seed input as a valid Base64 string representing random binary data obtained with the security.RandomGenerator.CreateRandomNumber helper method.
  4. created defines the optional created date input.
  5. offset defines the number of bytes the resulting octet stream must be shifted to obtain the derived key.
  6. bytes defines the number of bytes of the resulting derived key.

Usage

If it is a symmetric key, the size can be 0, or must match the original key depending on the identifier of the key type.

See Derived keys for more details.

In case of error, the method throws an exception and sets the STATUS variable. Depending on the error, a human-readable description of the problem is available in the SQLCA.SQLERRM register. See Error handling in GWS calls (STATUS).