View Source DSL: AshAuthentication

AshAuthentication provides a turn-key authentication solution for folks using Ash.


This package assumes that you have Ash installed and configured. See the Ash documentation for details.

Once installed you can easily add support for authentication by configuring the AshAuthentication extension on your resource:

defmodule MyApp.Accounts.User do
  use Ash.Resource,
    extensions: [AshAuthentication],
    domain: MyApp.Accounts

  attributes do
    uuid_primary_key :id
    attribute :email, :ci_string, allow_nil?: false
    attribute :hashed_password, :string, allow_nil?: false, sensitive?: true

  authentication do
    strategies do
      password :password do
        identity_field :email
        hashed_password_field :hashed_password

  identities do
    identity :unique_email, [:email]

If you plan on providing authentication via the web, then you will need to define a plug using AshAuthentication.Plug which builds a Plug.Router that routes incoming authentication requests to the correct provider and provides callbacks for you to manipulate the conn after success or failure.

If you're using AshAuthentication with Phoenix, then check out ash_authentication_phoenix which provides route helpers, a controller abstraction and LiveView components for easy set up.

Authentication Strategies

Currently supported strategies:

  1. AshAuthentication.Strategy.Password
    • authenticate users against your local database using a unique identity (such as username or email address) and a password.
  2. AshAuthentication.Strategy.OAuth2
  3. AshAuthentication.Strategy.MagicLink
    • authenticate by sending a single-use link to the user.


Add-ons are like strategies, except that they don't actually provide authentication - they just provide features adjacent to authentication. Current add-ons:

  1. AshAuthentication.AddOn.Confirmation
    • allows you to force the user to confirm changes using a confirmation token (eg. sending a confirmation email when a new user registers).


Some add-ons or strategies may require processes to be started which manage their state over the lifetime of the application (eg periodically deleting expired token revocations). Because of this you should add {AshAuthentication.Supervisor, otp_app: :my_app} to your application's supervision tree. See the Elixir docs for more information.


Configure authentication for this resource

Nested DSLs


subject_nameatomThe subject name is used anywhere that a short version of your resource name is needed. Must be unique system-wide and will be inferred from the resource name by default (ie MyApp.Accounts.User -> user).
domainmoduleThe name of the Ash domain to use to access this resource when doing anything authentication related.
get_by_subject_action_nameatom:get_by_subjectThe name of the read action used to retrieve records. If the action doesn't exist, one will be generated for you.
select_for_senderslist(atom)A list of fields that we will ensure are selected whenever a sender will be invoked. Defaults to [:email] if there is an :email attribute on the resource, and [] otherwise.


Configure JWT settings for this resource


token_resourcemodule | falseThe resource used to store token information, such as in-flight confirmations, revocations, and if store_all_tokens? is enabled, authentication tokens themselves.
enabled?booleanfalseShould JWTs be generated by this resource?
store_all_tokens?booleanfalseStore all tokens in the token_resource. See the tokens guide for more.
require_token_presence_for_authentication?booleanfalseRequire a locally-stored token for authentication. See the tokens guide for more.
signing_algorithmString.t"HS256"The algorithm to use for token signing. Available signing algorithms are; EdDSA, Ed448ph, Ed448, Ed25519ph, Ed25519, PS512, PS384, PS256, ES512, ES384, ES256, RS512, RS384, RS256, HS512, HS384 and HS256.
token_lifetimepos_integer | {pos_integer, :days | :hours | :minutes | :seconds}{14, :days}How long a token should be valid. See the tokens guide for more.
signing_secret(any, any -> any) | module | String.tThe secret used to sign tokens. Takes either a module which implements the AshAuthentication.Secret behaviour, a 2 arity anonymous function or a string.


Configure authentication strategies on this resource


Additional add-ons related to, but not providing authentication