joken

v0.16.1

Joken.Signer

Signer is the JWK (JSON Web Key) and JWS (JSON Web Signature) configuration of Joken.

JWK is used by JWS to generate a token signature that is appended to the end of the token compact representation.

Joken uses https://hex.pm/packages/jose to do signing and verification.

Summary

Types

jwk()
jws()
t()

Functions

es(alg, key)

Convenience for generating an ES* Joken.Signer

hs(alg, secret)

Convenience for generating an HS* Joken.Signer

ps(alg, key)

Convenience for generating an PS* Joken.Signer

rs(alg, key)

Convenience for generating an RS* Joken.Signer

sign(token)

Signs a payload (JOSE header + claims) with the configured signer

sign(token, signer)

Signs a payload (JOSE header + claims) with the given signer

verify(token, signer \\ nil, options \\ [])

Verifies a token signature and decodes its payload. This assumes a signer was configured. It raises if there was none

Types 

jwk :: %{}
jws :: %{}
t :: %Joken.Signer{jwk: jwk, jws: jws}

Functions

es(alg, key)

Specs

es(binary, map) :: Joken.Signer.t

Convenience for generating an ES* Joken.Signer

hs(alg, secret)

Specs

hs(binary, binary) :: Joken.Signer.t

Convenience for generating an HS* Joken.Signer

ps(alg, key)

Specs

ps(binary, map) :: Joken.Signer.t

Convenience for generating an PS* Joken.Signer

rs(alg, key)

Specs

rs(binary, map) :: Joken.Signer.t

Convenience for generating an RS* Joken.Signer

sign(token)

Specs

sign(Joken.Token.t) :: Joken.Token.t

Signs a payload (JOSE header + claims) with the configured signer.

It raises ArgumentError if no signer was configured.

sign(token, signer)

Specs

sign(Joken.Token.t, Joken.Signer.t) :: Joken.Token.t

Signs a payload (JOSE header + claims) with the given signer.

This will override the configured signer.

verify(token, signer \\ nil, options \\ [])

Specs

verify(Joken.Token.t, Joken.Signer.t | nil, Keyword.t) :: Joken.Token.t

Verifies a token signature and decodes its payload. This assumes a signer was configured. It raises if there was none.