Skip to content
This repository has been archived by the owner on Nov 25, 2018. It is now read-only.
/ macaroons-rs Public archive

Macaroons: bearer credentials with caveats for distributed authorization

License

Notifications You must be signed in to change notification settings

cryptosphere/macaroons-rs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Macaroons (for Rust!) Latest Version Build Status Apache 2 licensed

A better kind of cookie.

Macaroons are a bearer credential format built around "caveats", i.e. conditions that must hold for a particular credential to be authorized. Using neat crypto tricks, anyone holding a Macaroon can add more caveats to a Macaroon, but once caveats are added they cannot be removed.

http://macaroons.io

Is it any good?

Yes.

Is it "Production Ready™"?

The library is ready for eager early adopters. If you're using Rust, you're probably one of those anyway.

The following features have been implemented:

  • Creating Macaroons
  • Verifying Macaroons
  • First-party caveats
  • Third-party caveats
  • Serializing to base64url-encoded binary format
  • Deserializing base64url-encoded Macaroons
  • Verifying first-party caveats

The following features still need to be implemented:

  • Discharge macaroons
  • Verifying third-party caveats

Additional planned work:

  • Nom-based parser (may require API changes)

V2 Format Support

The Macaroons format is changing!

A specification for a new, more compact "V2" format has been published.

This library has begun to implement it. In the process, the API is changing so that it can support both the old and new formats.

Pardon our dust.

Help and Discussion

Interested in Macaroons? Join the Macaroons Google Group:

https://groups.google.com/forum/#!forum/macaroons

You can also join by email by sending an email message here:

macaroons+subscribe@googlegroups.com

We're also on IRC at #macaroons on irc.freenode.net.

Usage

Coming soon!

Additional Reading

License

Copyright (c) 2015-2016 Tony Arcieri. Distributed under the MIT License. See LICENSE.txt for further details.

About

Macaroons: bearer credentials with caveats for distributed authorization

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages