CMiC API and OAuth 2.0 Integration - Setting Up a Custom Claim via Azure

  1. Go to the Azure portal.

  2. Navigate to App Registrations.

  3. Pick the application to modify that will support mapping claims.

  4. Click on the Manifest option under the Manage section and set acceptMappedClaims from "null" to "true".

    OAuth2 Custom Claim Manifest screen

  5. Click [Save] to commit the changes in the manifest.

  6. Navigate to the Expose an API option under the Manage section of the left navigation menu.

  7. Set the Application ID URI field to use the unique name with the verified domain, not GUID (e.g. api://oauth2-custom-claim.cmicglobaldev.com).

    1. During this step, if this error is encountered, "AADSTS501461: AcceptMappedClaims is only supported for a token audience matching the application GUID or an audience within the tenant's verified domains", do the following:

      Solution:

      1. Change the resource identifier or use an application-specific signing key.

      2. Set the Application ID URI field to have the verified domain and not GUID, as described in Step 7.

        For example, instead of "api://509c4a10-aefa-4faf-8d98-3cb6b0b8c03c", use "api://509c4a10-aefa-4faf-8d98-3cb6b0b8c03c.cmicglobaldev.com" or "api://oauth2-custom-claim.cmicglobaldev.com".

  8. The application change is now complete.

  9. Next, navigate Enterprise Applications.

  10. Select the Enterprise Application to be modified.

  11. Click on the Single Sign-On option under the Manage section.

    Sample of the Single Sign On menu option

  12. On the Attributes & Claims section, click Edit.

    Sample of the Edit button on the Attributes & Claims section

  13. On the Attributes & Claims screen, click on [Add new claim].

    Sample of the Add New Claim button on the Attributes & Claims screen

  14. For the Name field, enter "cmicuser" and add the condition under the Claim Conditions section, as shown in the screenshot below. The claim conditions are what the value of the claim should be.

    Sample of the Manage Claim screen and editing the Claim Conditions section

  15. Click [Save] to save the changes.