Expand description
OAuth 2.0 helper for consumer cloud provider authentication.
Provides PKCE-based authorization code flow with a localhost callback server. Used by Google Drive, Dropbox, and OneDrive cloud home backends.
Structs§
- Authorize
Request - An authorization request the host drives itself: the URL to open plus the
PKCE verifier and state value coven checks during exchange. For hosts that
capture the redirect outside coven’s localhost callback server — e.g. a
mobile OS auth session (ASWebAuthenticationSession / Custom Tabs)
redirecting to a custom URI scheme, where binding a localhost port and
open::thatdon’t apply. - OAuth
Client Creds - OAuth client credentials for one provider — the consuming app’s registered OAuth application. coven ships no app credentials of its own.
- OAuth
Clients - The consuming app’s OAuth clients. Each Coven builder retains its own value, so unrelated apps in one process never share credentials.
- OAuth
Config - OAuth provider configuration.
- OAuth
Tokens - Tokens returned from an OAuth authorization or refresh.
Enums§
- OAuth
Callback Error - OAuth
Client Creds Error - An OAuth client set is missing a provider or names a provider that does not use OAuth.
- OAuth
Error
Functions§
- code_
challenge - Compute the S256 PKCE code challenge from a verifier.
- refresh
- Refresh an expired access token using a refresh token.