package mirage-crypto

  1. Overview
  2. Docs
Simple symmetric cryptography for the modern age

Install

Dune Dependency

Authors

Maintainers

Sources

mirage-crypto-0.10.7.tbz
sha256=3e818a760c235c5b684c7b6b43b1cdd2a7dd04e0105b680d524f836eb988a69c
sha512=e9c3e6ac0fa3dae2dda9e91d5362ad08aaa65241b968a0c12484db4042146d6af7b46910784ce41bdd68783eede93f35a81aa37a2cd125dfc43503c78007b8b9

Description

Mirage-crypto provides symmetric ciphers (DES, AES, RC4, ChaCha20/Poly1305), and hashes (MD5, SHA-1, SHA-2).

Published: 14 Sep 2022

README

mirage-crypto - Cryptographic primitives for MirageOS

v0.10.7

mirage-crypto is a small cryptographic library that puts emphasis on the applicative style and ease of use. It includes basic ciphers (AES, 3DES, RC4, ChaCha20/Poly1305), hashes (MD5, SHA1, SHA2 family), AEAD primitives (AES-GCM, AES-CCM), public-key primitives (RSA, DSA, DH) and a strong RNG (Fortuna).

RSA timing attacks are countered by blinding. AES timing attacks are avoided by delegating to AES-NI.

Mirage-crypto is a fork of the ocaml-nocrypto written by David Kaloper. It was forked with the permission of the original author in order to facilitate changes (e.g. build system) required by Mirage that the upstream didn't have time to keep up with.

Mirage-crypto-rng embeds the former mirage-entropy opam package, which implements various entropy sources:

  • non-deterministic execution time (used at initial seeding, see the whirlwind RNG paper)

  • a hook into the Lwt event loop that collects a timestamp of each event

  • rdseed and rdrand (x86/x86-64 only)

API documentation online

Build

dune build
dune runtest

FAQ

RNG seeding

If RNG fails with Fatal error: exception Unseeded_generator, you need to seed it.

Lwt:

let () = Mirage_crypto_rng_lwt.initialize ()

Unix:

let () = Mirage_crypto_rng_unix.initialize ()

Dependencies (6)

  1. eqaf >= "0.8" & < "0.10"
  2. cstruct >= "6.0.0"
  3. dune-configurator >= "2.0.0"
  4. dune >= "2.6"
  5. ocaml >= "4.08.0"
  6. conf-pkg-config build

Dev Dependencies (1)

  1. ounit2 with-test

Used by (42)

  1. albatross >= "1.1.0" & < "2.2.0"
  2. awa < "0.4.0"
  3. builder-web < "0.2.0"
  4. ca-certs < "1.0.0"
  5. ca-certs-nss < "3.104"
  6. caldav < "0.2.3"
  7. capnp-rpc-net >= "0.9.0" & < "1.2.4"
  8. chacha
  9. cohttp-async >= "3.0.0" & < "6.0.0"
  10. conex-mirage-crypto
  11. current_git >= "0.5"
  12. current_github >= "0.2"
  13. current_web >= "0.4"
  14. dkim < "0.7.0"
  15. dns-cli >= "4.4.0" & < "9.0.0"
  16. dns-tsig >= "4.4.0" & < "9.0.0"
  17. dnssec < "9.0.0"
  18. dream < "1.0.0~alpha7"
  19. git-mirage >= "3.7.0" & < "3.17.0"
  20. hkdf = "1.0.4"
  21. jose >= "0.5.0"
  22. letsencrypt >= "0.2.1" & < "1.0.0"
  23. mirage-block-ccm = "1.1.0"
  24. mirage-crypto-ec = "0.10.7"
  25. mirage-crypto-pk = "0.10.7"
  26. mirage-crypto-rng = "0.10.7"
  27. mirage-crypto-rng-async = "0.10.7"
  28. ocluster
  29. oidc
  30. opium >= "0.19.0"
  31. otr >= "0.3.7" & < "1.0.0"
  32. pbkdf >= "1.1.0" & < "2.0.0"
  33. rfc6287 >= "1.0.4"
  34. salsa20 >= "1.1.0"
  35. scrypt-kdf >= "1.1.0"
  36. session >= "0.5.0"
  37. spoke < "0.0.2"
  38. ssh-agent >= "0.2.1"
  39. tls >= "0.12.3" & < "0.16.0"
  40. tls-mirage < "1.0.0"
  41. twostep
  42. x509 >= "0.10.0" & < "1.0.0"

Conflicts (2)

  1. ocaml-freestanding < "0.6.0"
  2. mirage-xen < "6.0.0"
OCaml

Innovation. Community. Security.