Microsoft Account Social Login Configuration Guide


Microsoft Account is another name for a Microsoft Live account. Live accounts are used to sign in for Microsoft services like Outlook/Hotmail and Xbox Live.

Before You Begin

To use Microsoft Account for social login you must:

  1. Obtain a Microsoft developer account from https://apps.dev.microsoft.com.
  2. Do one of the following:
    • Open a previously-created Microsoft app, and copy the app ID and client ID.
    • Create a new Microsoft app and copy the app ID and client ID.
       
  3. Use the Janrain Dashboard and the Microsoft app ID and client ID to configure Microsoft Account as a social login provider.

In This Configuration Guide

  • Creating a Microsoft Account App for Social Login
  • Using an Existing Microsoft Account App for Social Login
  • Configuring Microsoft Account as a Social Login Provider
  • Testing Microsoft Account Social Login
  • Assigning a Different Microsoft Account App for Social Login
  • Removing Microsoft Account as a Social Login Provider

Creating a Microsoft Account App for Social Login

This section walks you through the process of creating an app that can be used to configure Microsoft Account social login. If you already have an app, see the Using an Existing Microsoft Account App for Social Login section of this documentation.

  1. Log on to the Microsoft Application Registration Portal (https://apps.dev.microsoft.com).
  2. From the Application Registration Portal home page, click Add an app:

  1. On the Register your application page:
    • Enter the name of your application in the Application Name field.
    • Enter your email address in the Contact Email field.
    • Leave Guided Setup unselected and then click Create.
  2. From the Registration page for your new application, copy and save the Application ID. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.
  3. Click Generate New Password:

  1. In the New password generated dialog box, copy and save your application password. (This is the only time you will be able to access the password.) You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.
  2. When you are finished, click OK:

  1. Scroll down the page to the Platforms section, and then click Add Platform:

  1. In the Add Platform dialog box, click Web:

  1. In the Web section, enter your redirect URL in the Redirect URLs field. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/liveid/callback:

  1. Scroll down the page to the Profile section. Enter the URL of your website in the Home page URL field, click Save, and then log off of the Application Registration Portal:


Using an Existing Microsoft Account App for Social Login

If you already have a Microsoft Account app that can be used for social login, complete the following steps to retrieve the application ID and password:

  1. Log on to the Microsoft Application Registration Portal (https://apps.dev.microsoft.com)
  2. From the My applications page, click the name of the application that you want to use for configuring social logins:

  1. On the home page for your application, copy and save the Application ID. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.
  2. If you did not previously save your application password, click Generate New Password:

  1. In the New password generated dialog box, copy and save your application password. (This is the only time you will be able to access the password.) You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.
  2. When you are done, click OK.
  3. If you no longer need your old password, click the Delete button next to that password. In the Confirm Delete dialog box, click OK:

  1. Scroll down to the bottom of the page, click Save, and then log off the Application Registration portal:


Testing Microsoft Account Social Login

To test Microsoft social login, complete the following procedure:

  1. Do one of the following:
    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.
       
  2. From the Test page, click the Microsoft Account icon:

  1. In the Sign in to your Microsoft account window, logon using a valid Microsoft account:

  1. If login succeeds, information returned from the Microsoft profile is displayed in the API response preview field.

The returned profile information will vary depending on:

  • The Microsoft account used in the test.
  • The profile information you requested for Microsoft account.

You can verify Microsoft account profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

  1. From the Configure Providers page, click Microsoft Account.
  2. Profile information returned from Microsoft accounts is displayed onscreen. For example:

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using a Microsoft account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether he or she gives permission for that data to be returned:

For example, if you ask for a user’s email address during logon, he or she will see the following message before they log on:

The user can either click Yes to forward all the requested information, or can click No to terminate logon.

On the Configure Providers page, click Ask to turn off the information request.

See Also


Assigning a Different Microsoft App for Social Login

If you want to use a different Microsoft app or if you need to change your existing app, you must update the Microsoft Account provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

  1. From the Configure Providers page, click Microsoft Account.
  2. Click the green Configured button to display the Microsoft Account is currently enabled dialog box:

  1. To change the Microsoft account configuration, click Modify these settings.
  2. In the Microsoft Account dialog box, change the Client ID and/or Client Secret as needed, and then click Save:

Although you can modify your Microsoft Account settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Microsoft Account shows them.

This means that you cannot “unconfigure” the provider: once configured, the Microsoft Account icon will always be shown as green (i.e., configured) in the Janrain Dashboard.


Removing Microsoft as a Social Login Provider

If you no longer want to use Microsoft accounts for social login, you can remove Microsoft as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Microsoft Account icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Microsoft Account no longer appears in the sign-on widget.
Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.