Manuals / RSA Security / TV and Video / Projection Television

RSA Security 5 manual Crypto-C, Cryptographic Components for C

Models: 5

1 376

Download 376 pages 51.16 Kb

<>

Characteristic Password Crypto-C Error Types 351 Airesetiv Other procedures BKeyAgreePhase1 How to BDecodeUpdate Non-zero Cancel operation

Page 1

RSA BSAFE®

Crypto-C

Cryptographic Components for C

Library Reference Manual

Version 5.0

Page 2

Image 1

RSA Security 5 manual Crypto-C, Cryptographic Components for C

Page 2

Related pages Consumer Support Troubleshooting for GE JT930 Physical specifications for HP 3900 USB eModule Error Messages for Acer X5812 Schematic Diagram BD 1/2 Section for Sony MDS-PC2 When the Enter Personal Code screen appears for Clarion CX609E Verification after installation Windows for Trust Computer Products 1290Z Parts List for Sears 625.34842 Printing out the department code list for Kyocera KM-C830 Contents for Hoover 33800318 What are the best practices for installing a Yankee Pellet Stove?

Contents

Cryptographic Components for C Crypto-C Copyright Notice Contents Page N t e n t s Key Info Types 245 Details of Crypto-C Functions 289 Crypto-C Error Types 351 References 359 Index 361 Page Introduction Organization Crypto-C Environment Memory Management Code Example Break If status = BEncryptInit Code Example As shown in , page 85, the format of info supplied to Algorithm Object Key Object Defining an Algorithm Chooser Bdemo Algorithm Chooser Algorithm Chooser Surrender Function Surrender Non-zero Cancel operationSurrender function callback must have the following form Continue with operation Item Structure Algorithm Info Types 1Sample Algorithm Type Pointer to a Bsecretsharingparams structure see above AIBSSecretSharing Output considerations AICBCIV8 On the algorithm object are undefined AICBCIV16 Pointer to a BBSAFE1ENCRYPTIONPARAMS structure see above AIDESCBCBSAFE1For all randomAlgorithm arguments Input constraints AIDESCBCIV8 Input that is a multiple of 8 bytes Token-based algorithm methods AIDESCBCPadBER Key info types for keyObject in BEncryptInit or BDecryptInit AIDESCBCPadIV8 AIDESCBCPadBER, AIDESCBCPadPEM AIDESCBCPadPEM AIDESCBCPadIV8, AIDESCBCPadBER Decryption AIDESEDE3CBCIV8 Token-based algorithm methods AIDESEDE3CBCPadBER AIDESEDE3CBCPadIV8 AIDESEDE3CBCPadIV8 AIDESEDE3CBCPadBER AIDESXCBCBSAFE1 Input constraints AIDESXCBCIV8 Key info types for keyObject in BEncryptInit or BDecryptInit AIDESXCBCPadBER AIDESXCBCPadIV8 AIDESXCBCPadIV8 AIDESXCBCPadBER Pointer to an Adhkeyagreeparams structure AIDHKeyAgree Initialized random algorithm to BKeyAgreePhase1 AIDHKeyAgreeBER AIDHKeyAgree Pointer to an Adhparamgenparams structure AIDHParamGenExponentBits must be less than primeBits Pointer to an Adhparamgenparams structure see above Key info types for keyObject in BVerifyInit Aidsa Input constraints Pointer to an Adsaparams structure AIDSAKeyGenPointer to an Adsaparams structure see above Amdsakeygen Pointer to a Bdsaparamgenparams structure AIDSAParamGenPointer to a Bdsaparamgenparams structure see above Size of the subprime is always 160 bits AIDSAWithSHA1 AIDSAWithSHA1BER AIDSAWithSHA1BER AIDSAWithSHA1 Pointer to an Item holding the accelerator table AIECAcceleratorTableNone Pointer to a Becparams structure AIECBuildAcceleratorTable Size of the accelerator table may be found through a call to An Aecparams structure AIECBuildPubKeyAccelTable Crypto-C procedures to use with algorithm object AIECDHKeyAgree AIECDHKeyAgree Aiecdsa KIECPrivate or KIECPrivateBER Pointer to a Bdigestspecifier structure AIECDSAWithDigest Key info types for keyObject in BSignInit Aieces AIECKeyGen Characteristic Pointer to an Aecparams structure AIECParameters Argument Values Comments Set the arguments as follows FTX962NAMEDCURVETYPE Possible values for FTX962NAMEDCURVETYPE are Pointer to an Aecparams structure see above AIECParametersBER AIECParametersBER Pointer to a Becparamgenparams structure AIECParamGen FieldType = FTF2ONB Pointer to a Becparamgenparams structure see above Crypto-C procedures to use with algorithm object Pointer to an Aecpublickey structure AIECPubKey Can get this info type if algorithm object already has AIECPubKeyBER Descriptor for block ciphers with feedback, as defined AIFeedbackCipherPointer to a structure of type Bblkcipherwfeedbackparams Type of padding schemes available AIFeedbackCipher 2Algorithm methods for feedback modes Depends on cipher type, as follows CFB modes require a Bcfbparams structure Compatible representations Aihmac Output considerations AIHWRandom Other proceduresRandom bytes generated by your hardware device AIKeypairTokenGen Where Akeypairdefiner is defined byPointer to an Akeypairspecifier structure Pointer to an Akeypairspecifier structure see above Key-pair generation AM specified by cipherName Aimac Message digest MD algorithm as defined by Bsafe AimdOutput of BDigestFinal will be 16 bytes long MD2 message digest algorithm as defined in RFC AIMD2 Output considerations AIMD2BER A p t e r 2 a l g o r i t h m I n f o Ty p e s 101 AIMD2PEM A p t e r 2 a l g o r i t h m I n f o Ty p e s 103 AIMD2Random Pointer to a Bpbeparams structure AIMD2WithDESCBCPadPointer to a Bpbeparams structure see above KIItem that gives the password AIMD2WithDESCBCPadBER AIMD2WithDESCBCPad Pointer to a BRC2PBEPARAMS structure AIMD2WithRC2CBCPad Pointer to a BRC2PBEPARAMS structure see above AIMD2WithRC2CBCPadBER AIMD2WithRC2CBCPad AIMD2WithRSAEncryption KIRSAPublic, KIRSAPublicBER, or KIRSAPublicBSAFE1 AIMD2WithRSAEncryptionBER AIMD2WithRSAEncryption MD5 message digest algorithm as defined in RFC AIMD5 AIMD5BER A p t e r 2 a l g o r i t h m I n f o Ty p e s 119 AIMD5PEM A p t e r 2 a l g o r i t h m I n f o Ty p e s 121 MD5-Random algorithm for generating pseudo-random numbers AIMD5Random AIMD5WithDESCBCPad AIMD5WithDESCBCPadBER AIMD5WithDESCBCPadBER AIMD5WithDESCBCPad AIMD5WithRC2CBCPad AIMD5WithRC2CBCPadBER A p t e r 2 a l g o r i t h m I n f o Ty p e s 129 AIMD5WithRC2CBCPadBER A p t e r 2 a l g o r i t h m I n f o Ty p e s 131 AIMD5WithRSAEncryption A p t e r 2 a l g o r i t h m I n f o Ty p e s 133 AIMD5WithRSAEncryptionBER A p t e r 2 a l g o r i t h m I n f o Ty p e s 135 AIMD5WithXOR A p t e r 2 a l g o r i t h m I n f o Ty p e s 137 AIMD5WithXORBER A p t e r 2 a l g o r i t h m I n f o Ty p e s 139 AIPKCSOAEPRSAPrivate Pkcs Oaep RSA Parameter Default Value Default Params Pointer to an Apkcsoaepparams structure Format of info supplied to BGetAlgorithmInfo A p t e r 2 a l g o r i t h m I n f o Ty p e s 143 AIPKCSOAEPRSAPrivateBER General syntax is Simple DER encoding for the default algorithm Sequence Following procedures perform Oaep padding with encryption AIPKCSOAEPRSAPublic Pkcs Oaep RSA Parameter Default Value Default Parameters A p t e r 2 a l g o r i t h m I n f o Ty p e s 149 Amrsaencrypt A p t e r 2 a l g o r i t h m I n f o Ty p e s 151 AIPKCSOAEPRSAPublicBER A p t e r 2 a l g o r i t h m I n f o Ty p e s 153 Sequence A p t e r 2 a l g o r i t h m I n f o Ty p e s 155 Input constraints AIPKCSOAEPRecode Following parameters are employed when Nullptr is specifiedEither Pointer to an Apkcsoaepparams structure A p t e r 2 a l g o r i t h m I n f o Ty p e s 159 AIPKCSOAEPRecodeBER AIPKCSOAEPRecodeBER General syntax is A p t e r 2 a l g o r i t h m I n f o Ty p e s 163 Format of info supplied to BGetAlgorithmInfo A p t e r 2 a l g o r i t h m I n f o Ty p e s 165 AIPKCSRSAPrivate A p t e r 2 a l g o r i t h m I n f o Ty p e s 167 AIPKCSRSAPrivateBER A p t e r 2 a l g o r i t h m I n f o Ty p e s 169 AIPKCSRSAPrivatePEM A p t e r 2 a l g o r i t h m I n f o Ty p e s 171 Amrsaencrypt for encryption or Amrsadecrypt for decryption AIPKCSRSAPublic A p t e r 2 a l g o r i t h m I n f o Ty p e s 173 AIPKCSRSAPublicBER Amrsaencrypt for encryption and Amrsadecrypt for decryption AIPKCSRSAPublicPEM A p t e r 2 a l g o r i t h m I n f o Ty p e s 177 Pointer to an ARC2CBCPARAMS structure AIRC2CBCPointer to an ARC2CBCPARAMS structure see above When used with one of the should be used with AIRC2CBCBSAFE1 A p t e r 2 a l g o r i t h m I n f o Ty p e s 181 AIRC2CBCPad A p t e r 2 a l g o r i t h m I n f o Ty p e s 183 AIRC2CBCPadBER A p t e r 2 a l g o r i t h m I n f o Ty p e s 185 AIRC2CBCPadPEM A p t e r 2 a l g o r i t h m I n f o Ty p e s 187 RC4 encryption algorithm AIRC4AMRC4ENCRYPT for encryption and AMRC4DECRYPT for decryption KIItem that gives the address and length of the RC4 key A p t e r 2 a l g o r i t h m I n f o Ty p e s 189 AIRC4BER A p t e r 2 a l g o r i t h m I n f o Ty p e s 191 Pointer to a BRC4WITHMACPARAMS structure AIRC4WithMACPointer to a BRC4WITHMACPARAMS structure see above A p t e r 2 a l g o r i t h m I n f o Ty p e s 193 AIRC4WithMACBER A p t e r 2 a l g o r i t h m I n f o Ty p e s 195 Pointer to an ARC5CBCPARAMS structure AIRC5CBCPointer to an ARC5CBCPARAMS structure see above KIItem, that gives the address and length of the RC5 key AIRC5CBC may be used to access the hardware-related Bhapi AIRC5CBCPad A p t e r 2 a l g o r i t h m I n f o Ty p e s 199 AIRC5CBCPadBER KIItem, which gives the address and length of the RC5 key Pointer to an ARC6CBCPARAMS structure AIRC6CBCPointer to an ARC6CBCPARAMS structure see above KIItem, that gives the address and length of the RC6 key Pointer to an ARC6CBCPARAMS structure AIRC6CBCPad A p t e r 2 a l g o r i t h m I n f o Ty p e s 205 Pointer to an Item Airesetiv AIRFC1113Recode Pointer to an Arsakeygenparams structure AIRSAKeyGen A p t e r 2 a l g o r i t h m I n f o Ty p e s 209 RSA algorithm for performing raw private-key encryption AIRSAPrivate AIRSAPrivate may include the hardware algorithm method AIRSAPrivateBSAFE1 Integer at the beginning of the buffer RSA algorithm for performing raw public-key decryption AIRSAPublic A p t e r 2 a l g o r i t h m I n f o Ty p e s 215 AIRSAPublicBSAFE1 A p t e r 2 a l g o r i t h m I n f o Ty p e s 217 AIRSAStrongKeyGen A p t e r 2 a l g o r i t h m I n f o Ty p e s 219 AISETOAEPRSAPrivate For the randomAlgorithm argument in BDecryptUpdate Input considerations AISETOAEPRSAPublic A p t e r 2 a l g o r i t h m I n f o Ty p e s 223 Output of BDigestFinal will be 20 bytes long AISHA1 AISHA1BER AISHA1 AISHA1Random AISHA1WithDESCBCPad KIItem that gives the address and length of the password AISHA1WithDESCBCPadBER A p t e r 2 a l g o r i t h m I n f o Ty p e s 231 AISHA1WithRSAEncryption A p t e r 2 a l g o r i t h m I n f o Ty p e s 233 AISHA1WithRSAEncryptionBER A p t e r 2 a l g o r i t h m I n f o Ty p e s 235 Pointer to a Bsignverifyparams structure AISignVerifySet the arguments for Bsignverifyparams as follows Pointer to a Bsignverifyparams structure see above Set the arguments for AX931PARAMS as followsAX931PARAMS Key info types for keyObject in BSignInit or BVerifyInit AISymKeyTokenGen AISymKeyTokenGen Seed AIX931Random Bsafe procedures to use with algorithm object SHA1 pseudo-random generator as defined AIX962RandomV0Pointer to an Asharandomparams structure Amsharandom Key Info Types 1Sample Key Info Type Pointer to an unsigned char array that holds the 8 bytes KI8Byte Byte value for symmetric keys such as Desede KI24BytePointer to an unsigned char array that holds the 24 bytes KI24Byte, KIItem if the length of the Item is 24, Kidesx KIDES8 KIDES8Strong KIDES24Strong Bsafe 1.x encoding of a DES key KIDESBSAFE1 Pointer to an Adesxkey structure Kidesx Bsafe 1.x encoding of a Desx key KIDESXBSAFE1 KIDSAPrivate Where Adsaparams is defined asPointer to an Adsaprivatekey structure KIDSAPrivate, KIDSAPrivateBER, or KIDSAPrivateX957BER KIDSAPrivateBER KIDSAPrivateX957BER Pointer to an Adsapublickey structure KIDSAPublic KIDSAPublic, KIDSAPublicBER, KIDSAPublicX957BER KIDSAPublicBER KIDSAPublicX957BER Pointer to an Aecprivatekey structure KIECPrivate KIECPrivateBER An elliptic curve private key without its curve parameters KIECPrivateComponent KIECPrivateComponentBER KIECPublic KIECPublicBER An elliptic curve public key without its curve parameters KIECPublicComponent KIECPublicComponentBER KIExtendedToken Where AX509ATTRIBINFO is defined byPointer to a Kiextendedtokeninfo structure Pointer to a Kiextendedtokeninfo structure see above Pointer to an Item structure KIItemPointer to an Item structure see above Pointer to a Kikeypairtokeninfo structure KIKeypairTokenAkeypairdefiner is defined by For Pointer to an Apkcsrsaprivatekey structure KIPKCSRSAPrivate A p t e r 3 K e y I n f o Ty p e s 277 KIPKCSRSAPrivateBER KIRC2BSAFE1 KIRC2WithBSAFE1Params Pointer to an Arsacrtkey structure Kirsacrt Pointer to an Arsakey structure KIRSAPrivate A p t e r 3 K e y I n f o Ty p e s 283 Bsafe 1.x encoding of an RSA private key KIRSAPrivateBSAFE1 Arsakey KIRSAPublic KIRSAPublicBER Bsafe 1.x encoding of an RSA public key KIRSAPublicBSAFE1 Pointer to a Kitokeninfo structure KITokenPointer to a Kitokeninfo structure see above Details of Crypto-C Functions Int BBuildTableFinal BBuildTableFinal Int BBuildTableGetBufSize BBuildTableGetBufSize BBuildTableInit Int BCreateAlgorithmObject BCreateAlgorithmObject Int BCreateKeyObject BCreateKeyObject Int BCreateSessionChooser BCreateSessionChooser Int BDecodeDigestInfo BDecodeDigestInfo Int BDecodeFinal BDecodeFinal Int BDecodeInit BDecodeInit Int BDecodeUpdate BDecodeUpdate Int BDecryptFinal BDecryptFinal BDecryptInit Int BDecryptUpdate BDecryptUpdate Void BDestroyAlgorithmObject There is no return value Void BDestroyKeyObject BDestroyKeyObject Int BDigestFinal BDigestFinal Int BDigestInit BDigestInit Int BDigestUpdate BDigestUpdate Int BEncodeDigestInfo BEncodeDigestInfo Int BEncodeFinal BEncodeFinal Int BEncodeInit BEncodeInit Int BEncodeUpdate BEncodeUpdate Int BEncryptFinal BEncryptFinal BEncryptInit Int BEncryptUpdate BEncryptUpdate Int BFreeSessionChooser BFreeSessionChooser BGenerateInit Int BGenerateKeypair BGenerateKeypair Int BGenerateParameters BGenerateParameters Int BGenerateRandomBytes BGenerateRandomBytes Int BGetAlgorithmInfo BGetAlgorithmInfo Void BGetExtendedErrorInfo BGetExtendedErrorInfo Void BGetKeyExtendedErrorInfo BGetKeyExtendedErrorInfo Int BGetKeyInfo BGetKeyInfo BIntegerBits BKeyAgreeInit Int BKeyAgreePhase1 BKeyAgreePhase1 Int BKeyAgreePhase2 BKeyAgreePhase2 Int BRandomInit BRandomInit Int BRandomUpdate BRandomUpdate Int BSetAlgorithmInfo BSetAlgorithmInfo Int BSetKeyInfo BSetKeyInfo BSignFinal Int BSignInit BSignInit BSignUpdate Int BSymmetricKeyGenerate BSymmetricKeyGenerate Initializes key generation object BSymmetricKeyGenerateInitInt BSymmetricKeyGenerateInit Int BVerifyFinal BVerifyFinal Int BVerifyInit BVerifyInit Int BVerifyUpdate BVerifyUpdate Void Tfree Tfree Tmalloc Blocks are equal Tmemcmp Tmemcpy Void Tmemmove Tmemmove Tmemset Pointer Trealloc Trealloc Int Tstrcmp Tstrcmp Destination string Tstrcpy Number of characters in the string Tstrlen Tstrlen Crypto-C Error Types Crypto-C Error Types P e n d i x a C r y p t o C Error Ty p e s 353 Page UINT2 PointerUINT2 value is a 16-bit unsigned integer UINT4 value is a 32-bit unsigned integer Example UINT4 Crypto-C defines one string constant Bsafeversion Otherwise Protolist should be defined asPage Operation. December National Bureau of Standards. Fips Publication 46-1 DataP1363 Draft D1 December 509 209X9.31 X9.44 Draft Index AMMD2RANDOM D e 363 Page D e 365

Top Page Image Contents