spotless - v7.0.0

spotless/oauth_2_1

Types

App

</>

Configuration of a OAuth client

pub type App {
  App(
    client_type: ClientType,
    client_id: String,
    redirect_uris: non_empty_list.NonEmptyList(uri.Uri),
  )
}

Constructors

AuthorizationServer

</>

Metadata of an authorization server.

Names follow the RFC8414 specification. Where a list of values is expected and a server does not support the feature, e.g. PKCE, add an empty list

pub type AuthorizationServer {
  AuthorizationServer(
    issuer: String,
    authorization_endpoint: #(origin.Origin, String),
    token_endpoint: #(origin.Origin, String),
    scopes_supported: List(String),
    pushed_authorization_request_endpoint: option.Option(
      #(#(origin.Origin, String), Bool),
    ),
    code_challenge_methods_supported: List(String),
  )
}

Constructors 

  • AuthorizationServer(
  issuer: String,
  authorization_endpoint: #(origin.Origin, String),
  token_endpoint: #(origin.Origin, String),
  scopes_supported: List(String),
  pushed_authorization_request_endpoint: option.Option(
    #(#(origin.Origin, String), Bool),
  ),
  code_challenge_methods_supported: List(String),
)

ClientType

</> 
pub type ClientType {
  Public
  Confidential(client_secret: String)
}

Constructors 

  • Public
  • Confidential(client_secret: String)

Values

add_parameter

</> 
pub fn add_parameter(
  request: authorization.Request,
  key: String,
  value: String,
) -> authorization.Request

authorization_response_from_uri

</> 
pub fn authorization_response_from_uri(
  redirect: uri.Uri,
) -> Result(authorization.Response, String)

authorize

</> 
pub fn authorize(
  server: AuthorizationServer,
  client_id: String,
  redirect_uri: uri.Uri,
  keypair: option.Option(effect.KeyPair(key)),
  scope: List(String),
  state: String,
  code_challenge_method: proof_key_for_code_exchange.CodeChallengeMethod,
  context: context.Context(t, key),
) -> fn(fn(Result(token.Response, String)) -> t) -> t

get_token

</> 
pub fn get_token(
  code: String,
  server: AuthorizationServer,
  app: App,
  code_verifier: String,
  fetch: fn(request.Request(BitArray)) -> fn(
    fn(Result(response.Response(BitArray), effect.FetchError)) -> t,
  ) -> t,
) -> fn(fn(Result(token.Response, String)) -> t) -> t

Get a token response from a code. This endpoint is more useful that the grant function as working out which app and token verifier should be used depend on getting back a valid, signed, state

grant

</> 
pub fn grant(
  redirect: uri.Uri,
  server: AuthorizationServer,
  app: App,
  code_verifier: String,
  fetch: fn(request.Request(BitArray)) -> fn(
    fn(Result(response.Response(BitArray), effect.FetchError)) -> t,
  ) -> t,
) -> fn(
  fn(
    Result(
      #(
        token.Response,
        option.Option(String),
        option.Option(String),
      ),
      String,
    ),
  ) -> t,
) -> t

Copy/Paste of main authorize function but without DPoP and with state, iss returned

start

</> 
pub fn start(
  server: AuthorizationServer,
  client_id: String,
  redirect_uri: uri.Uri,
  scope: List(String),
  state: String,
  code_challenge_method: proof_key_for_code_exchange.CodeChallengeMethod,
  context: context.Context(t, key),
) -> fn(fn(#(authorization.Request, String)) -> t) -> t

token_response_from_http

</> 
pub fn token_response_from_http(
  response: response.Response(BitArray),
) -> Result(
  Result(token.Response, token.ErrorResponse),
  json.DecodeError,
)
✨ Search Document