mirage-crypto-pk

Simple public-key cryptography for the modern age
README

v0.8.5

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 ()
Install
Published
31 Aug 2020
Sources
mirage-crypto-v0.8.5.tbz
sha256=d357dd3524abb271089b26403e3bd1bdde465e17512ca69d6cc043f8ca07d850
sha512=80eab6c1f7d6ddc8332eef8f0a198e0568167f0c28ca4f68d4e6084a7c7f3455574b94ccab6924d94d5aa3910273fedc838ca4d81a47e3eddb3d529ecc75be93
Dependencies
Reverse Dependencies
albatross
< "1.3.0"
certify
>= "0.3.3"
dns-certify
>= "4.6.3"
dns-cli
>= "4.6.3"
letsencrypt
>= "0.2.1" & < "0.2.3"
otr
>= "0.3.7"
rfc6287
>= "1.0.4"
ssh-agent
>= "0.2.1"
tls
>= "0.11.0"
x509
>= "0.10.0" & != "0.12.0"