Authentication library for Phoenix, and other Plug-based, web applications


Keywords
elixir, phoenix-framework
License
BSD-3-Clause

Documentation

Phauxth

Hex.pm Version Build Status

Phauxth is an authentication library for Phoenix, and other Plug-based, web applications. It is designed to be secure, extensible, easy to use and well-documented.

For a general overview of some of the goals of Phauxth and its basic usage, see this post.

Upgrading from version 2.0 to 2.1

In version 2.1, you need to remove all the references to Comeonin. Make the following changes in your app (if necessary, replacing Argon2 with the hashing module you are using):

  • in the user context module, change Comeonin.Argon2.add_hash to Argon2.add_hash
  • if you are using a custom login module, remove alias Comeonin.Argon2
  • in the Phauxth config, replace Comeonin.Argon2 with Argon2

For more details, see the upgrade guide.

Getting started

This guide shows how you can set up a new Phoenix project with Phauxth.

Authentication and authorization

The core Phauxth library handles authentication, verifying who the user is.

For information about authorization, or access control, see the Authorization page in the wiki.

If you have set up your app using the Phauxth installer, the authorize.ex file in the controllers directory provides examples of functions you can use to authorize users' access to resources.

Example apps using Phauxth

Contributing

There are many ways you can contribute to the development of Comeonin, including:

Donations

This software is offered free of charge, but if you find it useful and you would like to buy me a cup of coffee, you can do so through paypal.

Documentation

http://hexdocs.pm/phauxth

License

BSD