To enable Microsoft Entra ID to be able to SSO to Apex Central, the following tasks have to be done:
- Integrate Microsoft Entra ID with on-premise AD by using "Microsoft Entra ID Connect". For reference, visit this Microsoft article: Custom installation of Microsoft Entra ID Connect.
- In Microsoft Entra ID panel, go to Enterprise applications.
- Create a new application for the Apex Central instance:
- Configure Single sign-on of Apex Central application:
- Go to Single sign-on page.
- Select SAML-based Sign-on as Sign on mode.
- Edit Basic SAML Configuration and configure SAML Settings:
- https://<host-to-your-ApexCentral>/
- https://<host-to-your-ApexCentral>/WebApp/login.aspx
- Edit User Attributes & Claims to add custom attributes with following settings:
- Click Add new claim.
- Configure the custom claim settings:
- Name: windowsaccountname_TM
- Namespace: http://schemas.microsoft.com/ws/2008/06/identity/claims
- Change Source type to Transformation and configure the following parameters:
- Transformation: Join()
- Parameter 1: user.netbiosname
- Separator: \
- Parameter 2: user.onpremisessamaccountname
- Confirm the settings.
- Assign users who can log in to the Apex Central application.
- Integrate AD with Apex One as a Service.
For detailed instructions, visit the Integrate Active Directory (AD) with Apex One as a Service support page and go to step 2 of Synchronize AD information and authenticate AD accounts. - In Apex Central, go to Administration > Account Management > User Accounts.
- Click Add.
- Select Active Directory user or group, specify the User/Group name, and click Next.
The Add New User screen appears.
- Select the desired role, configure folder options and access rights, and then click Save.
- Go to Administration > Settings > Active Directory and Compliance Settings > Active Directory Settings.
- Configure ADFS for Apex Central.
- Tick Enable Active Directory synchronization and Enable Active Directory authentication.
- Specify the SSO service URL and Service identifier, and select the Signing certificate.
Field name on Apex Central Setting page Microsoft Entra ID SSO Attribute Name SSO service URL Login URL Server identifier Microsoft Entra ID Identifier Server certificate certificate downloaded from Microsoft Entra ID enterprise application
- Expired SAML Signing Certificate can prevent successful authentication. You may refer to this article on how to create/renew the SAML Signing Certificate.
Identity (IdP) initiated SSO
- Go to https://account.activedirectory.windowsazure.com/.
- Click the application to initiate a single sign on to Apex Central.