| 1 |
cipher: block cipher encryption modes |
| 2 |
|
| 3 |
The crypto::cipher module provides block cipher encryption modes. The [[block]] |
| 4 |
type provides an abstraction over a block cipher algorithm, and functions like |
| 5 |
[[cbc_decryptor]] create encryptors or decryptors for specific block encryption |
| 6 |
modes. |
| 7 |
|
| 8 |
Block ciphers in Hare rely upon caller-provided buffer allocations, and do not |
| 9 |
allocate memory at runtime. Consult the documentation for the underlying |
| 10 |
algorithm, e.g. [[crypto::aes::]], for the appropriate buffer sizes to use. |
| 11 |
|
| 12 |
This is a low-level module which implements cryptographic primitives. Direct use |
| 13 |
of cryptographic primitives is not recommended for non-experts, as incorrect use |
| 14 |
of these primitives can easily lead to the introduction of security |
| 15 |
vulnerabilities. Non-experts are advised to use the high-level operations |
| 16 |
available in the top-level [[crypto::]] module. |
| 17 |
|
| 18 |
Be advised that Hare's cryptography implementations have not been audited. |