package mirage-crypto
Install
Dune Dependency
Authors
Maintainers
Sources
sha256=bfb530fa169cd905ebc7e2449f3407cfbd67023ac0b291b8b6f4a1437a5d95b1
sha512=7b6f4e8128622b53eb2176881b5d6160f224e8606c7dd21aaf47974f15db7aa475cffaff3214aaaabba0f8986398f159c1fbb1bff29228c9b0a3fae67ef8d731
Description
Mirage-crypto provides symmetric ciphers (DES, AES, RC4, ChaCha20/Poly1305), and hashes (MD5, SHA-1, SHA-2).
Published: 27 Feb 2024
README
mirage-crypto - Cryptographic primitives for MirageOS
v0.11.3
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)
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 (module Mirage_crypto_rng.Fortuna)
Unix:
let () = Mirage_crypto_rng_unix.initialize (module Mirage_crypto_rng.Fortuna)
Dependencies (5)
-
eqaf
>= "0.8" & < "0.10"
-
cstruct
>= "6.0.0"
-
dune-configurator
>= "2.0.0"
-
dune
>= "2.7"
-
ocaml
>= "4.08.0"
Dev Dependencies (1)
-
ounit2
with-test
Used by (45)
-
albatross
>= "1.1.0" & < "2.2.0"
-
awa
< "0.4.0"
-
builder-web
< "0.2.0"
-
ca-certs
< "1.0.0"
-
ca-certs-nss
< "3.104"
-
caldav
< "0.2.3"
-
capnp-rpc-net
>= "0.9.0"
- chacha
-
cohttp-async
>= "3.0.0"
- conex-mirage-crypto
-
current_git
>= "0.5"
-
current_github
>= "0.2"
-
current_web
>= "0.4"
-
dkim
< "0.7.0"
-
dns-cli
>= "4.4.0" & < "9.0.0"
-
dns-tsig
>= "4.4.0" & < "9.0.0"
-
dnssec
< "9.0.0"
-
dream
< "1.0.0~alpha7"
-
git-mirage
>= "3.7.0" & < "3.17.0"
-
hkdf
= "1.0.4"
-
jose
>= "0.5.0"
-
letsencrypt
>= "0.2.1" & < "1.0.0"
-
mirage-block-ccm
>= "2.0.0"
-
mirage-crypto-ec
= "0.11.3"
-
mirage-crypto-pk
= "0.11.3"
-
mirage-crypto-rng
= "0.11.3"
-
mirage-crypto-rng-async
= "0.11.3"
-
mirage-crypto-rng-lwt
= "0.11.3"
- ocluster
- oidc
-
opium
>= "0.19.0"
-
otr
>= "0.3.7"
-
pbkdf
>= "1.1.0" & < "2.0.0"
- random
-
rfc6287
>= "1.0.4"
-
riot
>= "0.0.8"
-
salsa20
>= "1.1.0"
-
scrypt-kdf
>= "1.1.0"
-
session
>= "0.5.0"
-
spoke
>= "0.0.2"
-
ssh-agent
>= "0.2.1"
-
tls
>= "0.12.3" & < "1.0.0"
-
tls-mirage
< "1.0.0"
- twostep
-
x509
>= "0.10.0" & < "1.0.0"
Conflicts (2)
-
result
< "1.5"
- ocaml-freestanding