02dd1a70ba | ||
---|---|---|
assets/javascripts | ||
config | ||
.gitignore | ||
LICENSE.txt | ||
README.md | ||
plugin.rb |
README.md
Discourse + Auth0
This is a Discourse plugin to do Single Sign On using Auth0.
Demo: https://ask.auth0.com
What do I get by using Auth0?
- Support for Active Directory / LDAP (see animated gif)
- No matter if Discourse is on the cloud or on-prem, it will work transparently
- Support for Kerberos too (configured by IP ranges)
- Support for other enterprise logins like SAML Protocol, Windows Azure AD, Google Apps, Salesforce, etc. All supported here: https://docs.auth0.com/identityproviders.
- Support for social providers without having to add OmniAuth strategies by hand. Just turn on/off social providers (see animated gif)
- Support for Single Sign On with other Discourse instances and any other application in your account (see animated gif.
Installation
-
Create an account on Auth0 and open the application settings.
-
Install Discourse. You can use this guide to install Discourse on any platform
-
Edit your
containers/app.yml
to include this underhooks > after_code > exec > cmd
:- git clone https://github.com/auth0/discourse-plugin.git auth0
-
Follow the rest of the tutorial
-
Login as an administrator using a discourse account (not auth0 yet)
-
Configure your settings as shown in this image
̇
Enjoy!
Adding Active Directory / LDAP
Adding Social Providers
Single Sign On Between multiple Discourse forums
Single Sign On with Windows Authentication
Using Discourse Login Dialog instead of Auth0
You can keep using Discourse Login dialog and integrate only a specific connection from Auth0. It will show up as another button like the social providers.
Go to admin site settings for Auth0 and change the auth0_connection
with the connection name you want to use from Auth0.
Give admin rights to an email
$ RAILS_ENV=production bundle exec rails c
$ u = User.find_by_email('the-email-you-want-to-make-admin@whatever.com')
$ u.admin = true
$ u.save!
What is Auth0?
Auth0 helps you to:
- Add authentication with multiple authentication sources, either social like Google, Facebook, Microsoft Account, LinkedIn, GitHub, Twitter, Box, Salesforce, amont others, or enterprise identity systems like Windows Azure AD, Google Apps, Active Directory, ADFS or any SAML Identity Provider.
- Add authentication through more traditional username/password databases.
- Add support for linking different user accounts with the same user.
- Support for generating signed Json Web Tokens to call your APIs and flow the user identity securely.
- Analytics of how, when and where users are logging in.
- Pull data from other sources and add it to the user profile, through JavaScript rules.
Create a free Auth0 Account
- Go to Auth0 and click Sign Up.
- Use Google, GitHub or Microsoft Account to login.
Issue Reporting
If you have found a bug or if you have a feature request, please report them at this repository issues section. Please do not report security vulnerabilities on the public GitHub issue tracker. The Responsible Disclosure Program details the procedure for disclosing security issues.
Author
License
This project is licensed under the MIT license. See the LICENSE file for more info.