Microsoft Login Connector

Stable Version 5.0.14 (O11)
Also available for 10
Published on 10 Oct (4 days ago) by 
Created on 09 February 2018
Documentation

What is the Microsoft Login Connector

All Microsoft Cloud Services including Office 365, Dynamics 365, Sharepoint among others, are protected by an OAuth authentication from Azure Active Directory. Azure AD is the identity provider, responsible for verifying the identity of users and applications that exist in an organization’s directory, and ultimately issuing security tokens upon successful authentication of those users and applications. Each external application needs to be register on Azure AD to be request an OAuth access token that will be included on each REST API request.This connector tries to abstract the complexity of the OAuth authentication needed in the authorization process to all other REST APIs from Microsoft.



Registering Connector Application on Azure and Office 365

To register the connector application on open up your azure portal  at https://portal.azure.com. If you have an office 365 package you can login to azure using your office 365 admin credentials.  In the search bar at the top of the screen type in 'App Registration' and select.  You should see the below screen.

Select  New registration indicated by the plus symbol, getting the below (obviously with your organisation being shown were Davies March is showing)


Provide a name, maybe something like 'Microsoft Auth for OutSystems' and set a redirect URI  as https://<your outSystems Server>/MicrosoftLoginConnector/Callback.aspx.


and hit register giving a record like the below

The client ID you will need to enter into your application is just below the display name.

To generate the secret select certificates & secrets in the second menu from the left.

select new client secret

Select how long you want the secret to last for and give it a name. This will generate the secret you need to add into your application.

Make sure you copy or note your secret as it will be stared out the next time you return to it and will need to generate a new one.


Azure AD Managing Outsystems Roles

If you are looking to AD to manage the roles synchronising them to your OutSystems instance then this article explains how to setup the roles on the Azure AD side.

https://docs.microsoft.com/en-us/azure/architecture/multitenant-identity/app-roles#roles-using-azure-ad-app-roles

 

Support Options
This component is not supported by OutSystems. You may use the discussion forums to leave suggestions or obtain best-effort support from the community, including from Paul Davies who created this component.
Dependencies
See all 2 dependencies