	RSA BSAFE Crypto-C	Cryptographic Components for C
		Search

AI_RC4

Performs RC4 encryption and decryption. As it is a stream cipher, there are no restrictions on the length of input data. AI_RC4WithMAC allows developers to authenticate the encrypted data.

info Format

B_SetAlgorithmInfo() NULL_PTR.

B_GetAlgorithmInfo() NULL_PTR.

AI_RC4 Information

Functions to use B_EncryptInit(), B_EncryptUpdate(), B_EncryptFinal(), B_DecryptInit(), B_DecryptUpdate(), B_DecryptFinal(), B_SetAlgorithmState() and B_GetAlgorithmState().
Pass (B_ALGORITHM_OBJ)NULL_PTR for all randomAlgorithm arguments.
Due to the nature of the RC4 algorithm, security is compromised if multiple data blocks are encrypted with the same RC4 key. Therefore, B_EncryptUpdate() cannot be called after B_EncryptFinal(). To begin an encryption operation for a new data block, call B_EncryptInit() and supply a new key.

AMs to include AM_RC4_ENCRYPT for encryption and AM_RC4_DECRYPT for decryption.

KIs for keyObject in B_EncryptInit() or B_DecryptInit() KI_Item that gives the address and length of the RC4 key.

Compatible representation AI_RC4_BER.

Token-based AMs AI_RC4 may be used to access the hardware-related algorithm methods AM_TOKEN_RC4_ENCRYPT and AM_TOKEN_RC4_DECRYPT, for use with the BHAPI.

Token-based KIs When used with one of the hardware AMs listed above, AI_RC4 should be used with KI_Token or KI_ExtendedToken.

B_SetAlgorithmInfo()	`NULL_PTR`.
B_GetAlgorithmInfo()	`NULL_PTR`.

Functions to use	B_EncryptInit(), B_EncryptUpdate(), B_EncryptFinal(), B_DecryptInit(), B_DecryptUpdate(), B_DecryptFinal(), B_SetAlgorithmState() and B_GetAlgorithmState(). Pass (`B_ALGORITHM_OBJ`)`NULL_PTR` for all randomAlgorithm arguments. Due to the nature of the RC4 algorithm, security is compromised if multiple data blocks are encrypted with the same RC4 key. Therefore, B_EncryptUpdate() cannot be called after B_EncryptFinal(). To begin an encryption operation for a new data block, call B_EncryptInit() and supply a new key.
AMs to include	`AM_RC4_ENCRYPT` for encryption and `AM_RC4_DECRYPT` for decryption.
KIs for keyObject in B_EncryptInit() or B_DecryptInit()	KI_Item that gives the address and length of the RC4 key.
Compatible representation	AI_RC4_BER.
Token-based AMs	AI_RC4 may be used to access the hardware-related algorithm methods `AM_TOKEN_RC4_ENCRYPT` and `AM_TOKEN_RC4_DECRYPT`, for use with the BHAPI.
Token-based KIs	When used with one of the hardware AMs listed above, AI_RC4 should be used with KI_Token or KI_ExtendedToken.