Microsoft Online Social Login Configuration Guide


Microsoft Online 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 Online for social login you must:

  1. Obtain a Microsoft developer account from https://portal.azure.com.
  2. Do one of the following:
    • Open a previously-created Microsoft app, and copy the app ID and client ID.
  3. Use the Social Login Dashboard and the Microsoft app ID and client ID to configure Microsoft Online as a social login provider.

In This Configuration Guide


Creating a Microsoft Online App for Social Login

Back to top


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

  1. Log on to the Microsoft Azure developers portal (https://portal.azure.com).

  2. From the portal home page, click the navigation menu, click All Services:

  1. On the All services page, in the navigation pane, click Identity, and then, in the primary pane, click App registrations:

  1. On the App registrations page, click New Registration:

  2. On the Register an application page, enter the name of your application in the Name field:

  1. In the Supported account types section, select Accounts in any organizational directory (Any Azure AD directory – Multitenant and personal Microsoft accounts (e.g., Skype, Xbox):

  2. In the Redirect URI (optional) section, leave Web selected, enter your Microsoft Online redirect URI, and then click Register:

  1. After your application has been created, copy the Application (client) ID:


    You'll need both the client ID and the client secret in order to configure Microsoft Online as a social login provider.

  2. In the Manage section of the navigation pane, click Certificates & secrets:

  1. In the Client secrets section clic kNew client secret:

  1. In the Add a client secret dialog, enter a description of your client secret in the Description field, select a a time-to-live value in the Expires section, and then click Add:

  2. Copy the client secret. Note that this is the only time you'll be able to view the client secret. If you forget or misplace the secret it cannot be retrieved; instead, you'll have to create a new secret for the application.
  3. Log off from the Azure developer center.




Using an Existing Microsoft Online App for Social Login

Back to top


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 secret:

  1. Log on to the Microsoft Azure developers portal (https://portal.azure.com).
  2. From the portal home page, click the navigation menu, click All Services:

  3. On the All services page, in the navigation pane, click Identity, and then, in the primary pane, click App registrations:

  4. On the App registrations page, click the name of the application you want to use for social login:

  5. On the home page for your application, copy the client ID:

  6. In the Manage section of the navigation pane, click Certificates & secrets:

  7. In the Client secrets section click New client secret:


    Note that you must create a new secret: there is no way to retrieve the current secret for an application.

  8. In the Add a client secret dialog, enter a description of your client secret in the Description field, select a a time-to-live value in the Expires section, and then click Add:

  9. Copy the new client secret and then log off from the Microsoft Azure developers portal.



Testing Microsoft Online Social Login

Back to top


To test Microsoft Online 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 Social Login Dashboard's Sign-in page, click Launch a test widget.
       
  2. From the Test page, click the Microsoft Online icon:

  3. On the Sign in page, logon enter a valid Microsoft account name (e.g., an Outlook email address) and then click Next:

  4. On the Enter Password page, enter the password for your Microsoft account:

  5. On the Let this app access your info? page, click Yes:

  6. If login succeeds, information returned from your Microsoft user profile is displayed in the API response preview field:

That's all you have to do.



Assigning a Different Microsoft App for Social Login

Back to top


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

  1. From the Engage Dashboard home page, click the Manage Providers icon:
  2. From the Configure Providers page, click Microsoft Online.
  3. Click the green Configured button to display the Microsoft Online is currently enabled dialog box:

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

Although you can modify your Microsoft Online 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 Online 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 Social Login Dashboard.



Removing Microsoft as a Social Login Provider

Back to top


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

  1. Log on to your Social Login 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 Online icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Microsoft Online 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.