-
Notifications
You must be signed in to change notification settings - Fork 85
Home
- Frequently Asked Questions about RbNaCl
- Projects Using RbNaCl
Think of SecretBox like a safe: you can put information inside of it, and anyone with the combination can open it.
- Crypto::SecretBox: Authenticated secret-key encryption
Box works similarly to GPG: anyone can publish a public key, and if you have someone's public key, you can put messages into the box, but once closed, only the holder of the private key can open it.
- Crypto::Box: Authenticated public-key encryption
- Crypto::PrivateKey: Private keys for Crypto::Box
- Crypto::PublicKey: Public keys for Crypto::Box
In the real world, signatures help uniquely identify people because everyone's signature is unique. Digital signatures work similarly in that they are unique to holders of a private key, but unlike real world signatures, digital signatures are unforgeable.
- Crypto::SigningKey: Create digital signatures
- Crypto::VerifyKey: Verify digital signatures
HMAC provides hash-based [message authentication codes]((http://en.wikipedia.org/wiki/Message_authentication_code), the symmetric equivalent to digital signatures. Anyone who knows a particular secret value can use that value to generate MACs or verify the authenticity of a MAC for a given message.
- Crypto::HMAC::SHA256: Create 256-bit MACs with SHA256
- Crypto::HMAC::SHA512256: Create 256-bit MACs with SHA512
Cryptographic hash functions compute a secure, fixed-length output from an arbitrarily long input. These functions are designed to keep the actual data being hashed confidential.
- Crypto::Hash: Compute SHA256/512 and Blake2b digests
- Crypto::Point: Raw access to NaCl's Curve25519 elliptic curve cryptography
- Raw access to the Poly1305 one-time MAC function used by Crypto::Box and Crypto::SecretBox to authenticate messages
RbNaCl supports serializing keys and other values in a variety of different formats, including hex, base32, and base64.
Miscellaneous features which can be used in conjunction with the cryptographic features:
- Random number generation
- Constant-time string comparison
Learn how to test your RbNaCl projects under Travis CI
*NOTE: crypto is really, really, really, really, really hard