Skip to main content

Security - Single Sign-On - Configuring AAD

Updated over 2 months ago

To use Single sign-on using Azure Active Directory (AAD), an AAD App must be registered for Coins ERP+ to interact with.

  1. Using Azure Portal, navigate to the App Registrations on Azure Active Directory.

    App Registrations

  2. Create a New Registration.

    New App Registration

    If you are using the Code Grant method of authentication, the App needs the User.Read permission to be granted. This is the default.

    A picture containing graphical user interface

Description automatically generated

    The other permissions will be added by the Admin Consent process.

  3. Select Manifest.

  4. Change

    "oauth2AllowImplicitFlow": true,

    "oauth2AllowIdTokenImplicitFlow": true,

    and save.

    Edit Manifest

  5. Select Branding.

    Branding

  6. Enter the Home page URL; this will probably be the URL for wologin.p followed by ?type=token&idp=aad .

  7. Upload a logo for the app if required.

  8. Select Authentication.

    Authentication

  9. If users from different domains need to be allowed to use the app, set Multi tenanted to Yes. If you only have a single domain this is not needed.

  10. Set two redirect URIs, one for wologin.p and one for wo2coins.p (for responsive design), and save.

  11. If you are going to use AAD login:

    1. Select Certificates & Secrets.

    2. Create a client secret for the application.

      Certificates & Secrets

    3. Copy the value (you will not able to retrieve it after you close the frame) and save in to the AAD_SECRET parameter. This allows Coins ERP+ to authenticate with the application. AAD login will ONLY work if the user is able to authenticate with AAD without two-factor authentication.

  12. Select Overview.

    Overview

  13. Copy the Application (client) ID and save it to the AAD_CLIENT_ID parameter.

After creating the App in AAD it can take some time (may be a few hours) before it appears on the list of Apps for a user.

Did this answer your question?