Implement Active Directory Single Sign-On
This article explains how to implement Single Sign-On (SSO) from Active Directory (AD), into Cezanne HR using Active Directory Federation Services (AD FS) and SAML 2.0.
AD Server (IdP) Configuration - Automatic Option (Recommended)
- Ensure AD FS is installed on your server.
- Open Server Manager and select Tools >> AD FS Management.
- Open the AD FS tree to Trust Relationships >> Relying Party Trusts.
- In the action pane, click Add Relying Party Trust.
- Click Start.
- Select Import data about the relying party published online or on a local network and click Next.
- Enter https://w3.cezanneondemand.com/CezanneOnDemand/-/{company-identifier}/Saml/metadata into the Federation metadata address field (where {company-identifier} should be replaced to match your company's Primary URL).
- Click Next.
- Enter a display name (e.g. “Cezanne”) in the Display Name field and click Next.
- If prompted, select I do not want to configure multi-factor authentication… at this time and click Next.
- Select Permit all users to access this relying party, click Next and Next again.
- Select Open the edit claim rules dialog… when the wizard closes and click Close.
- Continue to the Configuring AD FS Issuance Transformation Rules section below.
Ad Server (IdP) Configuration - Manual Option
- Backup your AD server.
- Install AD FS.
- Open Server Manager and select Tools >> AD FS Management.
- Open the AD FS tree to Trust Relationships >> Relying Party Trusts.
- In the action pane, click Add Relying Party Trust.
- Click Start.
- Select Enter data about a relying party manually and click Next.
- Enter a display name (e.g. “Cezanne”) and click Next.
- Select AD FS Profile and click Next.
- Click Next to skip the optional certificate configuration step.
- Select Enable support for SAML 2.0 WebSSO protocol.
- In the Relying Party SAML 2.0 SSO Service URL box, enter https://w3.cezanneondemand.com/CezanneOnDemand/-/{company-identifier}/Saml/samlp and click Next (where {company-identifier} should be replaced to match your company's Primary URL).
- Add https://w3.cezanneondemand.com/CezanneOnDemand/ to the relying party trust identifiers list and click Next.
- If prompted, select I do not want to configure multi-factor authentication… at this time and click Next.
- Select Permit all users to access this relying party, click Next and Next again.
- Select Open the edit claim rules dialog… when the wizard closes and click Close.
- Continue to the Configuring AD FS Issuance Transformation Rules section below.
Configuring AD FS Issuance Transformation Rules
- Add a new custom rule to the Issuance Transformation Rules tab.
- Click Add Rule.
- Use the Send LDAP Attributes as Claims rule template.
- Click Next.
- Enter a rule name (e.g. “NameID Rule”) in the Claim rule name field.
- Select the Active Directory attribute store.
- Add a new LDAP attribute mapping from LDAP Attribute ‘User-Principal-Name’ to Outgoing Claim Type ‘Name ID’
- Click Finish.
Configuring Integrated Windows Authentication on ADFS 2.0
If you don’t want users that are already authenticated on you domain to have to enter their username and password when they access Cezanne, you need to ensure that Integrated Windows Authentication (IWA) is enabled for the adfs/ls web application in IIS.
- Open Internet Information Services (IIS) Manager.
- Navigate to Sites >> Default Web Site >> adfs >> ls.
- Double click on Authentication in the IIS section of the Features View.
- If Windows Authentication is disabled, right click on it and select Enable.
- If your company uses reverse proxies, virtual private networks or browsers other than Internet Explorer, you must also disable Extended Protection for Windows Authentication:
- Still in the Authentication view, right click on Windows Authentication and select Advanced Settings.
- Ensure that Extended Protection is set to Off.
- Click OK.
- Open the Windows Command Prompt as an administrator and run the following commands to restart IIS and AD FS:
- iisreset
- net stop "AD FS 2.0 Windows Service"
- net start "AD FS 2.0 Windows Service"
Configuring Integrated Windows Authentication on ADFS 3.0
In ADFS 3.0 it is required to ensure that only windows authentication is enabled to prevent browsers prompting for credentials. To do this:
- Open up the ADFS Management Console on your ADFS server
- Select the “Authentication Policies ” and then “edit” in the Primary Authentication Global Settings.
- Make sure that windows authentication is the only option checked and apply.
- Log in to Cezanne as an HR Professional user.
- Navigate to: System Setup >> Security Settings >> Single Sign-On Configuration.
- Check the SAML 2.0 check box.
- Click Save.
- Click Advanced Configuration.
- Click Add New.
- In the Display Name box, enter a display name for the identity provider. This name is used to identify the provider within Cezanne and does not have to match the entity ID, machine name or any other technical identifier.
- In the Entity Identifier box, enter https://adfs-server.example.com/adfs/services/trust where adfs-server.example.com should be replaced with the fully qualified machine name of your AD FS server.
- In the SAML Binding list, select the POST.
- In the Security Token Service Endpoint box, enter https://adfs-server.example.com/adfs/ls/ (again, adfs-server.example.com should be replaced with the fully qualified machine name of your AD FS server).
- Leave the User ID Attribute Name box empty. This tells Cezanne to read the user ID from the NameID element in the Subject of the assertion.
- Use the Public Key Certificate upload button to import the AD FS token signing public key certificate. This is the public key certificate for the key that was specified when AD FS was installed and can be found in AD FS under Services >> Certificates. Do not attempt to upload a private key; it will be automatically rejected.
- Click OK and then Save.
Associating AD Users with Cezanne Users
There are two ways to associate your users' AD identities with their Cezanne user accounts. You can use the User Settings screen to associate individual users or the SAML 2.0 Users Data Import to associate users in bulk.
Using the User Settings Screen
- Navigate to: System Setup >> Manage Users >> User Settings.
- Search for the user you wish to update.
- Select the Single Sign-On tab.
- In the SAML 2.0 Identifiers section, click Add New.
- In the Identity Provider column select AD FS and in the User Identifier column enter the user's AD username.
- Click Save.
Using the SAML 2.0 Users Data Import
- Navigate to: System Setup >> Data Management >> Import Data.
- Select SAML 2.0 Users on the Settings tab.
- Follow the on-screen instructions. For information about data imports, please refer to the Data Importing Knowledge Base article.
- If you haven’t done so already, associate your AD identity with a user account in Cezanne.
- Open your browser and navigate to https://{ad-fs-server-name}/adfs/ls/IdpInitiatedSignOn.aspx (where {ad-fs-server} is the fully qualified name of your AD FS server).
- If your browser displays an SSL certificate warning, check that the server name in the URL matches the subject name in the SSL certificate.
- Select Sign in to one of the following sites and Cezanne from the associated dropdown list.
- Click Continue to Sign In.
- If you are not automatically signed in to your Cezanne account, proceed to the Troubleshooting section below. Otherwise, you’re done!
If you’re unable to login despite entering your AD username and password correctly
Try disabling Extended Protection for Windows Authentication on the adfs/ls web application (as described in ‘Configuring Integrated Windows Authentication’). Unfortunately Extended Protection cannot be used with reverse proxies, virtual private networks and browsers other than Internet Explorer.
If you’re being prompted to enter your AD username and password despite being authenticated on the domain
If you are using Internet Explorer, check that Windows Authentication is enabled in your local computer’s Internet Settings:
- From the Windows Control Panel, Open Internet Options from the Windows Control Panel.
- Select the Advanced tab.
- Scroll down to the Security section in the settings tree and ensure Enable Integrated Windows Authentication is ticked.
- Click OK.
- If the setting wasn’t already enabled, restart your computer so that the change can take effect.
If you are using Firefox, check that Firefox is configured to trust your domain:
- Enter ‘about:config’ in the Firefox URL bar and press enter.
- If prompted, click I’ll be careful, I promise!
- Type ‘ntlm-auth.trusted-uris’ into the search bar.
- Double click network.automatic-ntlm-auth.trusted-uris.
- If not already specified, enter the fully qualified name of your AD FS server (e.g. ‘adfs.mycompany.local’).
- Click OK and close the configuration tab.
If the problem occurs in Chrome and Firefox, but not Internet Explorer, try disabling the ‘Negotiate’ Windows Authentication protocol:
- Open Internet Information Services (IIS) Manager on your AD FS server.
- Navigate to Sites >> Default Web Site >> adfs >> ls.
- Double click on Authentication in the IIS section of the Features View.
- Right click Windows Authentication and select Providers.
- Select Negotiate and click Remove. You should be left with just NTLM.
- Click OK.
- Open the Windows Command Prompt as an administrator and run the following commands to restart IIS and AD FS:
iisreset
net stop "AD FS 2.0 Windows Service"
net start "AD FS 2.0 Windows Service"
- Try logging in through Chrome or Firefox again.
If you are able to log in successfully then your browser was previously attempting to authenticate using the Negotiate protocol and failing. The Negotiate protocol is considered more secure than NTLM but is less well supported by non-Microsoft browsers. If you wish to re-enable the Negotiate protocol, you may be able to work around some of these problems using browser, operating system and network specific registry settings that are beyond the scope of this document.
If the above instructions still do not work:
- In Windows, Click Start >> Control Panel >> Internet Options >> Security tab
- Select Local intranet and click Sites.
- Select Advanced.
- Add your ADFS server into the Websites list, e.g. https://adfs-server.example.com (You should check first with your system administrator before adding this).