The Ash Authentication framework
Find a file
2023-01-27 18:30:42 -05:00
.devcontainer chore(devcontainer): store Dialyzer PLTs in a volume. 2022-12-16 11:49:39 +13:00
.github chore(CI): fix typo on release configuration. 2023-01-16 08:58:11 +13:00
config improvement(AuthenticationFailed): store a caused_by value in authentication failures. (#145) 2023-01-19 11:32:37 +13:00
dev improvement!: Major redesign of DSL and code structure. (#35) 2022-11-23 09:09:41 +13:00
documentation chore: give the select fields option a better name, add it to guide 2023-01-27 18:30:42 -05:00
lib chore: give the select fields option a better name, add it to guide 2023-01-27 18:30:42 -05:00
priv improvement(TokenResource)!: Store the token subject in the token resource. (#133) 2023-01-13 17:21:57 +13:00
test feat(PasswordValidation): Add a validation which can check a password. (#144) 2023-01-18 14:46:22 +13:00
.doctor.exs feat(PasswordReset): allow users to request and reset their password. (#22) 2022-11-02 18:18:20 +13:00
.formatter.exs feat(GitHub)!: Add GitHub authentication strategy. (#125) 2023-01-12 17:23:40 +13:00
.gitignore chore: install and configure dialyxir. 2022-09-28 10:11:00 +13:00
.tool-versions chore: update .tool-versions to elixir 25.2 and elixir 1.14.2. 2022-12-16 11:49:39 +13:00
CHANGELOG.md chore: release version v3.7.3 2023-01-18 23:08:08 +00:00
LICENSE improvement!: Major redesign of DSL and code structure. (#35) 2022-11-23 09:09:41 +13:00
mix.exs docs: don't show readme on ash_hq (#160) 2023-01-26 11:51:03 +13:00
mix.lock chore(deps): bump ash from 2.5.8 to 2.5.9 (#159) 2023-01-24 09:07:10 +13:00
README.md docs: remove guide that has been moved to ash-authentication-phoenix (#161) 2023-01-27 09:31:26 +13:00

AshAuthentication

Ash Authentication Logo

Elixir CI License: MIT Hex version badge

AshAuthentication provides drop-in support for user authentication for users of the Ash framework. It is designed to be highly configurable, with sensible defaults covering the most common use-cases.

Warning

This is not beta software, but it is still relatively young, and authentication is a very critical flow in any application, that touches on many aspects of security. We highly encourage considering how you configure this package very carefully, and testing its behavior in your own application. Those tests will also help ensure that any custom behavior you implement by modifying your resources does not break your authentication flows. Even though we do our best to prevent that situation with compile time validations, its not always possible.

Installation

The package can be installed by adding ash_authentication to your list of dependencies in mix.exs:

def deps do
  [
    {:ash_authentication, "~> 3.7.0"}
  ]
end

Documentation

See the official documentation for more.

Additionally, documentation for the latest release will be available on hexdocs and for the main branch.

Contributing

  • To contribute updates, fixes or new features please fork and open a pull-request against main.
  • Please use conventional commits - this allows us to dynamically generate the changelog.
  • Feel free to ask any questions on out GitHub discussions page.

Licence

AshAuthentication is licensed under the terms of the MIT license. See the LICENSE file in this repository for details.