package sihl-token

You can search for identifiers within the package.

in-package search v0.2.0

Token service implementations for Sihl

Install

Dune Dependency

github.com Readme Changelog Edit opam file Versions (20)

Authors

Maintainers

J

josef@oxidizing.io

Sources

2.0.1.tar.gz

md5=52b28d3faac0a2243735285aa3f962aa

sha512=e7ff89bdba9f1afa3b115a056ae3d403f602685187a968485ea64a7cd1a18791f66b7480b682bf66acd3564dd89139162779d58a43c2389d785c98e246094a18

doc/sihl-token/Sihl_token/PostgreSql/index.html

Module `Sihl_token.PostgreSql`Source

include Sihl.Contract.Token.Sig

Source

val create : 
  ?ctx:(string * string) list ->
  ?secret:string ->
  ?expires_in:Sihl__.Core_time.duration ->
  (string * string) list ->
  string Lwt.t

create ?ctx ?expires_in ?secret data returns a token that expires in expires_in with the associated data data. If no expires_in is set, the default is 7 days. An optional secret secret can be provided for the token signature, by default `SIHL_SECRET` is used.

Source

val read : 
  ?ctx:(string * string) list ->
  ?secret:string ->
  ?force:unit ->
  string ->
  k:string ->
  string option Lwt.t

read ?ctx ?secret ?force token k returns the value that is associated with the key k in the token token. If force is set, the value is read and returned even if the token is expired, deactivated and the signature is invalid. If the token is completely invalid and can not be read, no value is returned. An optional secret secret can be provided to override the default `SIHL_SECRET`.

Source

val read_all : 
  ?ctx:(string * string) list ->
  ?secret:string ->
  ?force:unit ->
  string ->
  (string * string) list option Lwt.t

read_all ?ctx ?secret ?force token returns all key-value pairs associated with the token token. If force is set, the values are read and returned even if the token is expired, deactivated and the signature is invalid. If the token is completely invalid and can not be read, no value is returned. An optional secret secret can be provided to override the default `SIHL_SECRET`.

Source

val verify : 
  ?ctx:(string * string) list ->
  ?secret:string ->
  string ->
  bool Lwt.t

verify ?ctx ?secret token returns true if the token has a valid structure and the signature is valid, false otherwise. An optional secret secret can be provided to override the default `SIHL_SECRET`.

Sourceval deactivate : ?ctx:(string * string) list -> string -> unit Lwt.t

deactivate ?ctx token deactivates the token. Depending on the backend of the token service a blacklist is used to store the token.

Sourceval activate : ?ctx:(string * string) list -> string -> unit Lwt.t

activate ?ctx token re-activates the token. Depending on the backend of the token service a blacklist is used to store the token.

Sourceval is_active : ?ctx:(string * string) list -> string -> bool Lwt.t

is_active ?ctx token returns true if the token is active, false if the token was deactivated. An expired token or a token that has an invalid signature is not necessarily inactive.

Source

val is_expired : 
  ?ctx:(string * string) list ->
  ?secret:string ->
  string ->
  bool Lwt.t

is_expired ?ctx token returns true if the token is expired, false otherwise. An optional secret secret can be provided to override the default `SIHL_SECRET`.

Source

val is_valid : 
  ?ctx:(string * string) list ->
  ?secret:string ->
  string ->
  bool Lwt.t

is_valid ?ctx token returns true if the token is not expired, active and the signature is valid and false otherwise. A valid token can safely be used. An optional secret secret can be provided to override the default `SIHL_SECRET`.

Sourceval register : unit -> Sihl__.Core_service.t

Sourceval lifecycle : Sihl__.Core_lifecycle.lifecycle

package sihl-token

Install

Dune Dependency

Authors

Maintainers

Sources

doc/sihl-token/Sihl_token/PostgreSql/index.html

Module Sihl_token.PostgreSqlSource

Module `Sihl_token.PostgreSql`Source