Bare Auth is a ready-to-deploy stateless authentication server.
This server supports various authentication strategies out of the box. You can enable the routes by supplying the specified environment variables below. You can also extend the server by requiring it directly.
You'll probably want to use the client-side libraries that accompany the server-side component for a seamless experience. You can find the client-side libraries for each provider below.
Usage
Pushing to a Dokku server:
git clone https://github.com/lapwinglabs/bare-auth.gitgit remote add dokku dokku@example.com:authgit push dokku master ssh dokku@example.com config:set auth JWT_SECRET=zippity-doo-da GOOGLE_CLIENT_SECRET=...Accepting PRs for Heroku instructions or a Heroku deploy button :-)
Design
The purpose of this server is to simply retrieve user data from 3rd party providers. It does not tie into your backend models at all and is not meant to store any user data.
Providers
| Provider | Author | Description | Environment Variables |
|---|---|---|---|
| Lapwing Labs | Log in with Google | GOOGLE_CLIENT_SECRET |
|
| Lapwing Labs | Log in with Twitter | TWITTER_CONSUMER_KEY, TWITTER_CONSUMER_SECRET |
|
| Lapwing Labs | Log in with Facebook | FACEBOOK_CLIENT_SECRET |
|
| Lapwing Labs | Log in with LinkedIn | LINKEDIN_CLIENT_SECRET |
If you create your own authentication strategy, submit a pull request!
JWT support
Bare Auth comes with built-in support for JSON Web Tokens.
To sign the response, simply add the JWT_SECRET environment variable.
You should pass this token to your API to create, update or verify the User. In order for the token to be accepted, the JWT secret must be the same on both servers.
Setting a JWT is recommended to ensure that the request to your API has not been tampered with or forged by an evil-doer.
Additionally, you can adjust the expiration by setting the JWT_EXPIRATION.
Frontend
Bare Auth comes with a built-in frontend to help with testing. You can enable
the frontend by setting the FRONTEND=path environment variable. By default,
path is /. Here's what the frontend looks like:
License
MIT
Copyright (c) 2015 MatthewMueller <matt@lapwinglabs.com>