Microsoft Login Connector Reactive

Stable Version 1.0.4 (OutSystems 11)
Published on 19 May (12 days ago) by 
MS Login Connector Team
MS Login Connector Team
Created on 17 October 2019

Microsoft Login Connector Reactive

Documentation

This module provides the reactive web blocks to build a login workflow that uses Microsoft services to authenticate the user and grant roles. 

If you are building in a traditional web experience or older version of OutSystems then you may want to use this version of the connector.

https://www.outsystems.com/forge/component-overview/3275/microsoft-login-connector


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.

NB in the screen shots below use the callback  https://<YourOutsystemsServer>/MSLoginConnectorReactive/CallbackPage rather than https://<YourOutsystemsServer>/MSLoginConnector/CallbackPage

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 MS Login Connector Team who created this component.
Dependencies
See all 2 dependencies