This plugin utilizes OAuth 2.0 to connect to the Windows Live service (Live Connect) so that users may authenticate with their Microsoft Accounts directly with Discourse. This is useful for anyone wishing to authenticate with Windows Live without the headache of implementing their own plugin.
This plugin is heavily based upon the discourse-oauth2-basic plugin. A great many thanks go out to developer(s) for the codebase! Couldn't have done it without you.
Note: I do not know Ruby/RoR and this is my very first dabbling with such. Things have surely been done poorly and I apologize for that ahead of time.
- Allow users to signup/login to Discourse via their Microsoft Accounts
- Imports the email address associated with their Microsoft Account
- Imports their name and generates a username
- Downloads their avatar from their Microsoft account (does not overwrite Gravatar)
- Allows editing of imported info before account creation*
* except avatar and email if email verified setting is enabled - Detailed log info (toggleable)
- Customizable button text
- A working Discourse installation through Docker [reference]
- SSL (callback URLs must use SSL - you can't even add them if they don't!)
Install the plugin by adding this GitHub repo to your app.yml file in your
after_code hooks (be very careful about spacing - YAML has no mercy):
- git clone https://github.com/coryjreid/discourse-windowslive-auth.git
Now run cd /var/discourse && sudo ./launcher rebuild app.
You need an application with Microsoft to allow authentication! If you don't have one yet you can easily register a new application at the Microsoft Application Registration Portal. You need a Microsoft Account to do this. Do this while your Discourse rebuilds!
- Create a new application, unchecking Guided Setup
- Save your Application Id to a temporary place
- Click on Generate New Password under Application Secrets
- Save your one-time-displayed Password in the same manner as your Application Id
(If you accidentally dismiss the modal before saving just delete and make a new one) - Click on Add Platform and select Web
- Check Allow Implicit Flow
- Add the following url to Redirect URLs and Logout URL
https://YOUR.DISCOURSE.COM/auth/windows_live/callback
^^^^ this is not a joke - Check Live SDK support under Advanced Options
- Fill in the remaining information as you see fit and Save your app
Remember that information we saved when creating a Windows Live application? Now we need it! Assuming your Discourse has finished rebuilding and is online, login and access the admin control panel and navigate to Settings > Login and scroll down to find your Windows Live settings (tip: filter using "windows live" in the search box).
- Check the box to enable login with Windows Live
- Copy and paste your Application Id into the appropriate field
- Copy and paste your Application Secret (Password) into the appropriate field
- Logout to see your plugin in action!
- Create a Pull Request with a new translation
- Log Issues
- Submit Pull Requests to help resolve issues or add new features
MIT