Add Microsoft Entra ID authentication to your system

After you have prepared the Microsoft Entra admin center, you can add the Microsoft Entra ID authentication to your Neptune DXP - Open Edition.

Prerequisites

Procedure

  1. In the Neptune DXP - Open Edition Cockpit, go to Settings, and select System Settings.

  2. In the Authentication tab, select Edit.

  3. Select + Add and select Microsoft Entra ID.

    Result: The Authentication dialog opens.

    1. Enter a meaningful Name.

    2. Select Active to activate this authentication method.

    3. Select Show on Login page to show the login screen on the Neptune DXP - Open Edition Session Login Page.

    4. Enter a Description.

    5. Enter a Path to retrieve a Neptune DXP - Open Edition session (for example, open-edition-ad-bearer). You can add any string as a path.

    6. In Identity Metadata, enter a link to a metadata document that contains information required for an app to sign-in.

    7. From your Microsoft Entra ID account, enter the Tenant ID of your Neptune DXP - Open Edition.

    8. Enter your application’s Client ID from the Microsoft Entra admin center.

    9. Enter the Client Secret key that you generated in New client secret in the Microsoft Entra admin center.

    10. Additional Scopes

    11. Use silent signout in PWA tba

    12. Use MSAl v2 tba

  4. In Claims Assignment, select Add to add claims assignments.

  5. If required, in Auto Assignment, assign roles and groups that you have defined in the Role and Security Group tools in the Cockpit.

  6. In Custom Script, to modify the roles' assignment manually, optionally enter your own custom code .

    For example, to log user details to view in the system logs when the authentication method is used and to use custom logic to affect the entered variables, enter the following in Custom Script:

    log.info("XXuser",user);
log.info("XXprofile",profile);
log.info("Member of:"+ profile.memberof);

  7. Select OK to save your input.

    Result: The Authentication dialog closes.

  8. In System Settings, select Restart to activate Microsoft Entra ID authentication.

Result

You have configured and activated Microsoft Entra ID authentication for your Neptune DXP - Open Edition.

Related topics