Intel® Integrated Performance Primitives Cryptography Developer Reference Intel IPP 2017 Update 2 Legal Information Contents Contents Legal Information.............................................................................. 13 Getting Help and Support................................................................... 15 Introducing Cryptography for Intel® Integrated Performance Primitives....................................................................................... 17 What's New........................................................................................ 19 Notational Conventions...................................................................... 21 Related Products................................................................................ 23 Chapter 1: Overview Basic Features......................................................................................... 25 Function Context Structures...................................................................... 25 Data Security Considerations..................................................................... 26 Chapter 2: Symmetric Cryptography Primitive Functions Block Cipher Modes of Operation................................................................27 Rijndael Functions....................................................................................28 AESGetSize.....................................................................................28 AESInit...........................................................................................29 AESSetKey......................................................................................30 AESPack, AESUnpack....................................................................... 30 AESEncryptECB............................................................................... 31 AESDecryptECB............................................................................... 32 AESEncryptCBC............................................................................... 33 AESDecryptCBC...............................................................................34 AESEncryptCFB............................................................................... 34 AESDecryptCFB............................................................................... 35 AESEncryptOFB............................................................................... 36 AESDecryptOFB...............................................................................37 AESEncryptCTR............................................................................... 38 AESDecryptCTR............................................................................... 39 AESEncryptXTS_Direct, AESDecryptXTS_Direct....................................40 Example of Using AES Functions........................................................ 42 AES-CCM Functions.................................................................................. 43 AES_CCMGetSize.............................................................................43 AES_CCMInit...................................................................................44 AES_CCMStart................................................................................ 45 AES_CCMEncrypt.............................................................................45 AES_CCMDecrypt.............................................................................46 AES_CCMGetTag..............................................................................47 AES_CCMMessageLen.......................................................................48 AES_CCMTagLen..............................................................................48 AES-GCM Functions..................................................................................49 AES_GCMGetSize.............................................................................50 AES_GCMInit.................................................................................. 50 AES_GCMStart................................................................................ 51 3 Cryptography for Intel® Integrated Performance Primitives Developer Reference AES_GCMReset............................................................................... 52 AES_GCMProcessIV..........................................................................53 AES_GCMProcessAAD.......................................................................53 AES_GCMEncrypt.............................................................................54 AES_GCMDecrypt............................................................................ 55 AES_GCMGetTag..............................................................................56 AES-SIV Functions................................................................................... 56 AES_S2V_CMAC.............................................................................. 56 AES_SIVEncrypt.............................................................................. 57 AES_SIVDecrypt..............................................................................58 Usage Example................................................................................60 TDES Functions....................................................................................... 61 DESGetSize ................................................................................... 62 DESInit.......................................................................................... 62 DESPack, DESUnpack.......................................................................63 TDESEncryptECB............................................................................. 64 TDESDecryptECB............................................................................. 65 TDESEncryptCBC............................................................................. 65 TDESDecryptCBC.............................................................................66 TDESEncryptCFB............................................................................. 67 TDESDecryptCFB............................................................................. 68 TDESEncryptOFB............................................................................. 70 TDESDecryptOFB.............................................................................71 TDESEncryptCTR............................................................................. 72 TDESDecryptCTR............................................................................. 73 Example of Using TDES Functions...................................................... 74 SMS4 Functions....................................................................................... 75 SMS4GetSize.................................................................................. 75 SMS4Init........................................................................................ 76 SMS4SetKey................................................................................... 77 SMS4EncryptECB.............................................................................77 SMS4DecryptECB.............................................................................78 SMS4EncryptCBC.............................................................................79 SMS4DecryptCBC............................................................................ 80 SMS4EncryptCFB............................................................................. 81 SMS4DecryptCFB.............................................................................82 SMS4EncryptOFB.............................................................................82 SMS4DecryptOFB.............................................................................83 SMS4EncryptCTR.............................................................................84 SMS4DecryptCTR.............................................................................85 ARCFour Functions................................................................................... 86 ARCFourGetSize.............................................................................. 87 ARCFourCheckKey............................................................................87 ARCFourInit.................................................................................... 88 ARCFourPack, ARCFourUnpack...........................................................88 ARCFourEncrypt.............................................................................. 89 ARCFourDecrypt.............................................................................. 90 ARCFourReset................................................................................. 91 Chapter 3: One-Way Hash Primitives 4 Contents Hash Functions........................................................................................ 94 HashGetSize................................................................................... 95 HashInit......................................................................................... 96 HashPack, HashUnpack.....................................................................97 HashDuplicate................................................................................. 97 HashUpdate.................................................................................... 98 HashFinal....................................................................................... 99 HashGetTag...................................................................................100