RSA BSAFE Cert-C Micro Edition

The power of PKI for the smallest of devices

Cryptographic Operation Property Identifiers

This section details the defines used in the setting and/or retrieval of data from the cryptographic object. The following table details the data types to pass into param when calling R_CR_get_info().

Identifier	Param Data Type
R_CR_INFO_ID_SUPPORTED	long *
R_CR_INFO_ID_KEY_LEN	int *
R_CR_INFO_ID_IS_EXPORT	long *
R_CR_INFO_ID_CIPHER_EXP_KEY_LEN	int *
R_CR_INFO_ID_CIPHER_IV_LEN	int *
R_CR_INFO_ID_CIPHER_PARAM	long *
R_CR_INFO_ID_CIPHER_ROUNDS	long *
R_CR_INFO_ID_CIPHER_BLOCK_SIZE	int *
R_CR_INFO_ID_DIGEST_MAC_LEN	int *
R_CR_INFO_ID_DIGEST_BLOCK_SIZE	int *
R_CR_INFO_ID_CIPHER_BITS	long *
R_CR_INFO_ID_SURRENDER	R_SURRENDER **
R_CR_INFO_ID_CRYPTO_TYPE	int *
R_CR_INFO_ID_CRYPTO_ID	int *
R_CR_INFO_ID_CRYPTO_SUB	int *
R_CR_INFO_ID_BLOCK_PADDING	int *
R_CR_INFO_ID_FLAGS	int *
R_CR_INFO_ID_PUBLIC_KEY	unsigned long *
R_CR_INFO_ID_PRIVATE_KEY	unsigned long *
R_CR_INFO_ID_DSA_P	R_ITEM *
R_CR_INFO_ID_DSA_Q	R_ITEM *
R_CR_INFO_ID_DSA_G	R_ITEM *
R_CR_INFO_ID_DSA_PARAMETERS	R_PKEY *
R_CR_INFO_ID_SIGNATURE	int *
R_CR_INFO_ID_RAND_ENTROPY_FUNC	R_RAND_ENT_FUNC_T *

The following table details the data types to pass into param when calling R_CR_set_info().

Identifier	Param Data Type
R_CR_INFO_ID_CIPHER_ROUNDS	int *
R_CR_INFO_ID_CIPHER_BITS	int *
R_CR_INFO_ID_SURRENDER	R_SURRENDER *
R_CR_INFO_ID_BLOCK_PADDING	int *
R_CR_INFO_ID_FLAGS	int
R_CR_INFO_ID_NUM_BITS	unsigned int *
R_CR_INFO_ID_NUM_PRIMES	unsigned int *
R_CR_INFO_ID_PUBLIC_KEY	unsigned long *
R_CR_INFO_ID_PRIVATE_KEY	unsigned long *
R_CR_INFO_ID_DSA_P	R_ITEM *
R_CR_INFO_ID_DSA_Q	R_ITEM *
R_CR_INFO_ID_DSA_G	R_ITEM *
R_CR_INFO_ID_DH_PRIME_LENGTH	unsigned long *
R_CR_INFO_ID_DH_GENERATOR_ORDER	unsigned long *
R_CR_INFO_ID_RSA_E	unsigned long *
R_CR_INFO_ID_DSA_PARAMETERS	R_PKEY *
R_CR_INFO_ID_SIGNATURE	int *
R_CR_INFO_ID_RAND_ADD_ENTROPY	int *
R_CR_INFO_ID_RAND_LOAD_FILE	char *
R_CR_INFO_ID_RAND_ENTROPY_FUNC	R_RAND_ENT_FUNC_T *

Defines
#define	R_CR_INFO_ID_SUPPORTED
	A cryptographic identifier which indicates that the algorithm is supported.
#define	R_CR_INFO_ID_KEY_LEN
	A cryptographic identifier which indicates the key length.
#define	R_CR_INFO_ID_IS_EXPORT
	A cryptographic identifier which indicates the export strength cipher.
#define	R_CR_INFO_ID_KE_AUTHENTICATE
	A cryptographic identifier which indicates key agreement authentication.
#define	R_CR_INFO_ID_KE_TYPE
	A cryptographic identifier which indicates the key agreement type.
#define	R_CR_INFO_ID_CIPHER_EXP_KEY_LEN
	A cryptographic identifier which indicates the export strength key length.
#define	R_CR_INFO_ID_CIPHER_IV_LEN
	A cryptographic identifier which indicates the Initialization Vector (IV) length.
#define	R_CR_INFO_ID_CIPHER_PARAM
	A cryptographic identifier which indicates the symmetric cipher parameter.
#define	R_CR_INFO_ID_CIPHER_ROUNDS
	A cryptographic identifier which indicates the symmetric cipher rounds.
#define	R_CR_INFO_ID_CIPHER_TYPE
	A cryptographic identifier which indicates the symmetric cipher type.
#define	R_CR_INFO_ID_CIPHER_BLOCK_SIZE
	A cryptographic identifier which indicates the symmetric cipher block size.
#define	R_CR_INFO_ID_DIGEST_MAC_LEN
	A cryptographic identifier which indicates the digest or Message Authentication Code (MAC) length.
#define	R_CR_INFO_ID_CTX_RANDOM
	A cryptographic identifier which indicates the random context.
#define	R_CR_INFO_ID_DIGEST_BLOCK_SIZE
	A cryptographic identifier which indicates the digest block size.
#define	R_CR_INFO_ID_CIPHER_BITS
	A cryptographic identifier which indicates the symmetric cipher bits.
#define	R_CR_INFO_ID_OAEP_PARAM
	A cryptographic identifier which indicates the PKCS #1 Optimal Asymmetric Encryption Padding (OAEP) parameter.
#define	R_CR_INFO_ID_SURRENDER
	A cryptographic identifier which indicates the surrender function.
#define	R_CR_INFO_ID_CRYPTO_TYPE
	A cryptographic identifier which indicates the cryptographic type.
#define	R_CR_INFO_ID_CRYPTO_ID
	A cryptographic identifier which indicates the cryptographic identifier.
#define	R_CR_INFO_ID_CRYPTO_SUB
	A cryptographic identifier which indicates the cryptographic operation subtype.
#define	R_CR_INFO_ID_BLOCK_PADDING
	A cryptographic identifier which indicates the block padding.
#define	R_CR_INFO_ID_FLAGS
	A cryptographic identifier which indicates the flags.
#define	R_CR_INFO_ID_NUM_BITS
	A cryptographic identifier which indicates the number of bits of the asymmetric key.
#define	R_CR_INFO_ID_NUM_PRIMES
	A cryptographic identifier which indicates the number of primes (RSA MultiPrime).
#define	R_CR_INFO_ID_PUBLIC_KEY
	A cryptographic identifier which indicates the asymmetric public key.
#define	R_CR_INFO_ID_PRIVATE_KEY
	A cryptographic identifier which indicates the asymmetric private key.
#define	R_CR_INFO_ID_DSA_P
	A cryptographic identifier which indicates the Digital Signature Algorithm (DSA) prime number (P).
#define	R_CR_INFO_ID_DSA_Q
	A cryptographic identifier which indicates the Digital Signature Algorithm (DSA) factor of the prime number (Q).
#define	R_CR_INFO_ID_DSA_G
	A cryptographic identifier which indicates the Digital Signature Algorithm (DSA) generator (G).
#define	R_CR_INFO_ID_DH_PRIME_LENGTH
	A cryptographic identifier which indicates the Diffie-Hellman prime length.
#define	R_CR_INFO_ID_DH_GENERATOR_ORDER
	A cryptographic identifier which indicates the Diffie-Hellman generator order.
#define	R_CR_INFO_ID_RSA_E
	A cryptographic identifier which indicates the RSA public exponent (E).
#define	R_CR_INFO_ID_DSA_PARAMETERS
	A cryptographic identifier which indicates the Digital Signature Algorithm (DSA) parameters.
#define	R_CR_INFO_ID_SIGNATURE
	A cryptographic identifier which indicates the signature.
#define	R_CR_INFO_ID_RAND_FILE_NAME
	A cryptographic identifier which indicates the random seed file name.
#define	R_CR_INFO_ID_RAND_WRITE_FILE
	A cryptographic identifier which indicates the random seed write file.
#define	R_CR_INFO_ID_RAND_ADD_ENTROPY
	A cryptographic identifier which indicates to add entropy to random generator.
#define	R_CR_INFO_ID_RAND_LOAD_FILE
	A cryptographic identifier which indicates to load seed file into random generator.
#define	R_CR_INFO_ID_RAND_ENTROPY_FUNC
	A cryptographic identifier which indicates the random entropy collection function.

---

Copyright (c) 1999-2002 RSA Security Inc. All rights reserved. 061-001005-150-001-000-3768 - 1.5