#signature #ed25519 #cryptography #security #edcert

edcert-letter

This crate provides an abstraction over Edcert. You can use the Letter type to sign and verify content using Edcert Certificates.

9 releases (stable)

Uses old Rust 2015

2.0.0 Oct 22, 2016
1.1.0 Oct 14, 2016
1.0.4 Apr 5, 2016
1.0.0 Mar 28, 2016
0.1.1 Mar 21, 2016

#41 in #ed25519

37 downloads per month

MIT license

11KB
135 lines

Build Status

Hi and welcome on the git page of my crate "edcert-letter".

Edcert is a simple library for certification and authentication of data. edcert-letter provides a Letter type, which can be used for simple validation of content.

How Edcert works

  1. You create a master keypair. This will be used to sign the highest certificate.
  2. You create a root certificate. Sign this with the master key.
  3. You can now create other certificates and use certificates to sign each other.
  4. Transmit your certificates in a json-encoded format over the network.
  5. Sign and verify data with the certificates using the ".sign" and ".verify" methods.

The design uses the "super-secure, super-fast" elliptic curve Ed25519, which you can learn more about here

For cryptography it uses the sodiumoxide library, which is based on NaCl, the well known cryptography libraray by Dan Bernstein et al.

How Letter works

You can use Letter with a Ed25519 Keypair directly:

// You generate a ed25519 keypair
let (public_key, private_key) = ed25519::generate_keypair();

// Sign the letter with the private key
let test_str = "hello world";
let mut letter = Letter::with_private_key(test_str, &private_key);

// Now you can transport the letter and validate it using the public key.
assert_eq!(true, letter.is_valid(&public_key).is_ok());
letter.content = "world hello";
assert_eq!(false, letter.is_valid(&public_key).is_ok());

Or you can use Edcert Certificates:

// (let meta = ..., let expires = ...)
let (public_key, private_key) = ed25519::generate_keypair();
let mut cert = Certificate::generate_random(meta, expires);
cert.sign_with_master(&private_key);

let test_str = "hello world";
let mut letter = Letter::with_certificate(test_str, &cert);

assert_eq!(true, letter.is_valid(&public_key).is_ok());
letter.content = "world hello";
assert_eq!(false, letter.is_valid(&public_key).is_ok());

License

MIT

That means you can use this code in open source projects and/or commercial projects without any problems. Please read the license file "LICENSE" for details

Dependencies

~9.5MB
~103K SLoC