elitau/ueberauth_example

Example Phoenix application using Überauth for authentication

Überauth Example

Using Überauth for authentication in Phoenix.

This project demonstrates how to use Überauth and multiple strategies to provide authentication for a Phoenix application. The project has been setup to run on Heroku can can be found at ueberauth-example.herokuapp.com.

In this example we'll use five strategies:

• Facebook (ueberauth_facebook)
• GitHub (ueberauth_github)
• Google (ueberauth_google)
• Slack (ueberauth_slack)
• Twitter (ueberauth_twitter)
• Identity (ueberauth_identity)

Setup

1. Ensure the following prerequisites are met/installed:

• Erlang 19
• Elixir 1.3

1. Retrieve app ids and secrets and set environment variables:

   • Facebook (https://developers.facebook.com)
     • FACEBOOK_APP_ID
     • FACEBOOK_APP_SECRET
   • GitHub (https://developer.github.com)
     • GITHUB_CLIENT_ID
     • GITHUB_CLIENT_SECRET

• Google (https://console.developers.google.com/home)
  • GOOGLE_CLIENT_ID
  • GOOGLE_CLIENT_SECRET
• Slack (https://api.slack.com/applications)
  • SLACK_CLIENT_ID
  • SLACK_CLIENT_SECRET
• Twitter (https://dev.twitter.com)
  • TWITTER_CONSUMER_KEY
  • TWITTER_CONSUMER_SECRET

1. Clone the project:

   $ git clone git@github.com:ueberauth/ueberauth_example.git
   $ cd ueberauth_example

2. Fetch dependecies:

   $ mix deps.get && npm install

3. Run server:

   $ mix phoenix.server

4. Authenticate at http://localhost:4000!

Configuration

See Überauth for detailed instructions.

License

Please see LICENSE for licensing details.