Table of Contents
1 Introduction.......................................................................................................................................6
2 Getting Started...................................................................................................................................7
Example 1 – Basic .Net Project Using BC C# Assembly...........................................................7
2.1 Brief Introduction to Random Numbers....................................................................................8
Example 2 – Default C# PRNG..................................................................................................8
Example 3 – BC Default SecureRandom....................................................................................9
Example 4 – BC HMAC SecureRandom....................................................................................9
3 Symmetric Cipher Algorithms.........................................................................................................10
Example 5 – Random Symmetric Key Generation...................................................................10
Example 6 – Fixed Symmetric Key Generation........................................................................11
Example 7 – ECB Mode Symmetric Cipher.............................................................................11
3.1 Block Cipher Modes Of Operation..........................................................................................12
Example 8 – Key and Initialisation Vector Generation.............................................................14
Example 9 – CBC Mode Encryption/Decryption.....................................................................14
Example 10 – CFB Stream Mode Encryption/Decryption.......................................................15
Example 11 – CTR Mode Without Padding Encryption/Decryption........................................16
Example 12 – CCM AEAD Mode Without Padding Encryption/Decryption...........................17
3.2 Stream Ciphers.........................................................................................................................18
Example 13 – ChaCha Stream Cipher Encryption/Decryption.................................................18
Example 14 – HC128 Stream Cipher Encryption/Decryption..................................................19
3.3 AEAD Ciphers.........................................................................................................................19
Example 15 – GCM AEAD Mode Encryption/Decryption......................................................20
Example 16 – ASCON AEAD Encryption/Decryption............................................................21
Example 17 – ChaCha20Poly1305 AEAD Encryption/Decryption.........................................21
3.4 Format Preserving Encryption using AES...............................................................................22
Example 18 – FF3-1 FPE Mode Encryption/Decryption..........................................................23
4 Key Agreement and Exchange Algorithms.....................................................................................24
4.1 What Happended To the Asymmetric Ciphers?.......................................................................24
4.2 Diffie-Hellman Key Agreement...............................................................................................25
Example 19 – Generating DH Finite Field Parameters.............................................................25
Example 20 – Diffie-Hellman Key Pair Generation.................................................................26
Example 21 – Basic DH Key Agreement..................................................................................26
Example 22 – MTI/A0 DH Key Agreement.............................................................................27
4.3 Elliptic Curve Diffie-Hellman Key Agreement.......................................................................27
Example 23 – Generating EC GF (p) Parameters Directly.......................................................28
Example 24 – Generating Built In EC GF (p) Parameters........................................................28
Example 25 – Generating Binary EC Parameters Directly.......................................................29
Example 26 – Generating Built In Binary EC Parameters........................................................30
Example 27 – EC Diffie-Hellman Key Pair Generation...........................................................30
Example 28 – EC Diffie-Hellman Key Agreement...................................................................30
5 Key Encapsulation and Key Wrapping............................................................................................32
5.1 Key Wrapping Using Symmetric Keys....................................................................................33
Example 29 – RFC3394 Key Wrapping Default IV.................................................................33
Example 30 – RFC3394 Key Wrapping With IV......................................................................33
Appendix A – Built in Curves............................................................................................................35
Appendix A.1 – Prime Field Built in Curves.................................................................................35
Appendix A.2 – Binary Field Built in Curves...............................................................................36
Appendix C – References...................................................................................................................38
