“Login with Facebook, Twitter, LinkedIn or Azure AD? ” A guide outlining how to integrate Azure AD with B2C, using Logic Apps REST API & the Microsoft Graph API to retrieve user attributes.
Azure AD B2C is an amazing offering from Microsoft that allows SaaS providers to offload their identity service to the cloud. Traditionally used for scenarios where integration with a social identity provider is desired, B2C whilst using the Identity Experience Framework (“custom policies / advanced policies”) can support the integration of any OAuth/OpenID Connect or SAML 2.0 Identity Provider, including Azure AD.
Why Azure AD B2C?
The business use cases for this are solid. With more than 8 million tenants in Azure AD, a company could enable “Sign in with Azure AD” and support SSO with arguably most enterprise organizations.
Integrating Azure AD & B2C has been documented by Microsoft, but there are some important gaps.
- B2C will only retrieve the ‘id_token’ from Azure AD, no ‘access_token’
- The ‘id_token’ will only contain the standard set of claim types listed here. This means our application will not be aware of claims such as title, mobilePhone, email address, or any custom attribute that we wish to deliver to the relying party (application).
Microsoft Graph & Azure Logic Apps
The solution to these gaps is proving a REST API that B2C will interact with to retrieve the user attributes.
General summary –
- User clicks “Login” to application
- B2C sends user to Azure AD Sign in page
- User Signs in
- Azure AD sends id_token to B2C (with objectid of user)
- B2C sends the ObjectID to the Logic App
- Logic app looks up user via the Graph API, sends rest of attributes to B2C
- B2C sends entire claim to relying party, either via SAML or JWT (OpenIDConnect)
Before getting started, you should have a complete B2C tenant, a POC application, and sign in with Azure AD already configured. A guide to this is provided by Microsoft here.
Microsoft Graph Application Registration & Authorization
In order to query the Graph API, we need to register a Microsoft Graph application. This is done via https://apps.dev.microsoft.com.
- Create an app
- Record your client_secret (application id)
- Generate and record your application secret
- Add Platforms > Web > Configure “http://localhost” as the redirect URL.
- Add Application Permission “User.Read.All”
Now that the app is registered, you must authorize it to query against your directory. B2C will only be sending the Object ID and tenant to the application, no access_token, so the application needs to have pre-authorization.
- Construct a request URL
Tenant name = The FQDN of your Azur AD tenant (contoso.onmicrosoft.com)
Application_id = The complete Application ID from the apps.dev.microsoft.com site
- Browser to this URL in your browser
- Sign in with an adminstrative account of the Azure AD tenant.
- Approve the application
- Acknowledge – You’ll be redirected to http://localhost. If the request was successful, you should see a URL like http://localhost/?admin_consent=True&tenant=6660b467-add3-4d9e-8ada-48b1721959f3
Once the app has deployed, get the request URL for the application from within the Azure Portal. This will later be used in your B2C policy.
Integrate Logic App with B2C
Now that the Logic App is deployed, we need to add the Claim Provider and add register the Claim Provider as part of the User Journey. Also, The logic app is developed with multi-tenancy in mind, meaning we can accept requests that come in from any Azure AD tenant. However, the Logic App must know the tenant that is being used so we configure a DefaultValue claim for the Azure AD technical profile to be sent in the claim to the Logic App.
- Open your TrustFrameworkBase.xml
Find the tag <ClaimsSchema>
2. Add the following code snip
3. Open your TrustFrameworkExtensions.xml file
Locate the TechnicalProfile for your Azure AD configuration. Add the following to your list of <OutputClaims>
<OutputClaim ClaimTypeReferenceId="tenant" DefaultValue="tenant-name.OnMicrosoft.com" />
Replace tenant-name with the FQDN of your tenant.
4. Register the technical profile of the Logic App
Immediately after the ending <\TechnicalProfile> of the Azure AD configuration, add the following snipit.
note: You must format your URL to be XML compliant. After each ‘&’ symbol you must add ‘amp;’
https://prod-26.northcentralus.logic.azure.com:443/workflows/fgf7c284254bf2b0a6bc8484564547ddbb/triggers/manual/paths/invoke?api-version=2016-10-01<span style="color: #ff0000;">&</span>sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0<span style="color: #ff0000;">&</span>sig=ghtgbhheh4CZExbuiwhesjduawher3rfesfrerfc
<DisplayName>Query Graph API for rest of user attributes</DisplayName>
<Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.RestfulProvider, Web.TPEngine, Version=188.8.131.52, Culture=neutral, PublicKeyToken=null" />
<Item Key="ServiceUrl">LOGIC APP POST URL HERE</Item>
<InputClaim ClaimTypeReferenceId="socialIdpUserId" PartnerClaimType="oid" />
<InputClaim ClaimTypeReferenceId="tenant" PartnerClaimType="tenant" />
<OutputClaim ClaimTypeReferenceId="email" PartnerClaimType="mail" />
<UseTechnicalProfileForSessionManagement ReferenceId="SSOSession-Noop" />
5. Add the Logic App to the User Journey
Locate your default UserJourney. This may be in your TrustFrameworkExtensions or Base file. Locate where your orchestration step is being executed to call against Azure AD. Immediately after, add the following code.
Be certain to change the OrchestrationStep Order number.
<OrchestrationStep Order="6" Type="ClaimsExchange"> <ClaimsExchanges> <ClaimsExchange Id="AzureFunctions-AzureADGraphLookupExchange" TechnicalProfileReferenceId="AzureFunctions-AzureADGraphLookup" /> </ClaimsExchanges> </OrchestrationStep>
6. Save & Upload your policies. Viola!
- Security – Integrating the Logic App, we rely on the SAS (Shared Access Signature) of the Logic App in the URL as a method of authentication. This is not the most secure approach, as anyone with the URL could query our Graph API. It is recommended if this is implemented in production, that you use Azure API Management as a wrapper around the Logic App to provide authentication and optionally caching.
- This example only outlines retrieving the email of the user from the Graph API. The complete list of attributes are located here. https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/user_get. Make certain to add the claim to your schema before configuring an output claim of the Logic App.