ocadotechnology / sttp-oauth2

OAuth2 client library implemented in Scala using sttp

Version Matrix

sttp-oauth2 - OAuth2 client library for Scala

This library aims to provide easy integration with OAuth2 providers based on OAuth2 RFC using sttp client. It uses circe for JSON serialization/deserialization.

Currently it supports methods (grant types) for obtaining authorization:


Each grant is implemented in an object with explicit return and error types on methods and additionally, TaglessFinal friendly *Provider interface.

  • AuthorizationCode and AuthorizationCodeProvider - provide functionality for:
    • generating login and logout redirect links,
    • authCodeToToken for converting authorization code to token,
    • refreshAccessToken for performing a token refresh request
  • PasswordGrant and PasswordGrantProvider, capable of performing requestToken to convert user login and password to oauth2 token
  • ClientCredentials and ClientCredentialsProvider expose methods that:
    • Obtain token via requestToken
    • introspect the token for it's details like UserInfo

The library is using sttp 3. The latest version which is using sttp 2 is 0.4.0.


Feel free to submit feature requests and bug reports under Issues.


sttp-oauth2 is licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License.

Copyright © 2020 Ocado