Repository files navigation

yup-oauth2 is a utility library which implements several OAuth 2.0 flows. It's mainly used bygoogle-apis-rs, to authenticate against Google services.(However, you're able to use it with raw HTTP requests as well; the flows are implemented as tokensources yielding HTTP Bearer tokens). Note that the newer, asynchronous versions of this crate(version 4) are not compatible withgoogle-apis-rs anymore/at the moment.

To use asynchronous APIs with the new yup-oauth2 (from version 4), use theasync-google-apis codegenerator, which generates asynchronous API stubs for Google APIs and otherproviders who provide Discovery documents for their REST APIs. (WARNING: thatproject is stillalpha-quality. Contributions are welcome)

The provider we have been testing the code against is also Google. However, the code itself isgeneric, and any OAuth provider behaving like Google will work as well. If you find one thatdoesn't, please let us know and/or contribute a fix!

• Device flow (user enters code on authorization page)
• Installed application flow (user visits URL, copies code to application, application usescode to obtain token). Used for services like GMail, Drive, ...
• Service account flow: Non-interactive authorization of server-to-server communication based onpublic key cryptography. Used for services like Cloud Pubsub, Cloud Storage, ...

• Version 1.x for Hyper versions below 12
• Version 2.x for Hyper versions 12 and above
• Version 3.x for historical interest
• Version 4.x for tokio 0.2/0.3
• Version 5.x for tokio 1.0

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE orhttp://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT orhttp://opensource.org/licenses/MIT)

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in thework by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without anyadditional terms or conditions.