PDF(921.4 KB) View with Adobe Reader on a variety of devices
ePub(796.6 KB) View in various apps on iPhone, iPad, Android, Sony Reader, or Windows Phone
Mobi (Kindle)(884.7 KB) View on Kindle device or Kindle app on multiple devices
Updated:June 20, 2023
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This document describes how to configure Single Sign-On (SSO) on Cisco Unified Communications Manager and Active Directory Federation Service.
Cisco recommends that you have knowledge of these topics:
Cisco Unified Communications Manager (CUCM)
Basic Knowledge of Active Directory Federation Service (AD FS)
In order to enable SSO in your lab environment, you need this configuration:
Windows Server with AD FS installed.
CUCM with LDAP sync configured.
An End User with the Standard CCM Super Users role selected.
The information in this document is based on these software and hardware versions:
Windows Server with AD FS 2.0
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, ensure that you understand the potential impact of any command.
The procedure for AD FS 2.0 with Windows Server 2008 R2 is provided. These steps also work for AD FS 3.0 on Windows Server 2016.
Download and Install AD FS 2.0 on your Windows Server
Step 2. Navigate to Cisco Unified CM Administration > System > SAML Single Sign-On.
Step 3. Click Enable SAML SSO.
Step 4. If you receive an alert about Web Server Connections, click Continue.
Step 5. Next, CUCM instructs you to download the metadata file from your IdP. In this scenario, your AD FS server is the IdP, and you downloaded the metadata in Step 1, so click Next.
Step 6. Click Browse > Select the .xml from Step 1 > Click Import IdP Metadata.
Step 7. A message indicates that the import was successful:
Step 8. Click Next.
Step 9. Now that you have the IdP metadata imported into CUCM, you need to import CUCM's metadata into your IdP.
Step 10. Click Download Trust Metadata File.
Step 11. Click Next.
Step 12. Move the .zip fileto your Windows Server and extract the contents to a folder.
Import CUCM Metatdata to AD FS 2.0 Server and Create Claim Rules
Step 1. Click Start and search for AD FS 2.0 Management.
Step 2. Click Required: Add a trusted relying party.
Note: If you do not see this option, you need to close the window and open it back up.
Step 3. Once you have the Add Relying Party Trust Wizard open, click Start.
Step 4. Here, you need to import the XML files that you extracted in step 12. Select Import data about the relying party from a file and browse to the folder files and choose the XML for your publisher.
Note: Use the previous steps for any Unified Collaboration server on which you intend to utilize SSO.
Step 5. Click Next.
Step 6. Edit the Display Name and click Next.
Step 7. Choose Permit all users to access this relying party and click Next.
Step 8. Click Next again.
Step 9. On this screen, ensure that you have Open the Edit Claim Rules dialog for this relying party trust when the wizard closes checked, then click Close.
Step 10. The Edit Claim Rules window opens:
Step 11. In this window, click AddRule.
Step 12. For Claim rule template, choose Send LDAP Attributes as Claims and click Next.
Step 13. On the next page, enter NameID for the Claim rule name.
Step 14. Choose Active Directory for the Attribute store.
Step 15. Choose SAM-Account-Name for the LDAP Attribute.
Step 16. Enter uid for Outgoing Claim Type.
Note: uid is not an option in the drop down list - it must be entered manually.
Step 17. Click Finish.
Step 18. The first rule is now finished. Click Add Rule again.
Step 19. Choose Send Claims Using a Custom Rule.
Step 20. Enter a Claim rule name.
Step 21. In the Custom rule field, paste this text:
Step 22. Ensure that you change AD_FS_SERVICE_NAME and CUCM_ENTITY_ID to the appropriate values.
Note: If you are not sure about the AD FS Service Name, you can follow the steps to find it. The CUCM Entity ID can be pulled from first line in the CUCM metadata file. There is an entityID on the first line of the file that looks like this, entityID=1cucm1052.sckiewer.lab,. You need to enter the underlined value into the appropriate section of the claim rule.
Step 23. Click Finish.
Step 24. Click OK.
Note: Claim rules are needed for any Unified Collaboration server on which you intend to utilize SSO.
Finish SSO Enablement On CUCM And Run The SSO Test
Step 1. Now that the AD FS server is fully configured, you can go back to CUCM.
Step 2. You left off at the final configuration page:
Step 3. Select your End User which has the Standard CCM Super Users role selected and click Run SSO Test...
Step 4. Ensure that your browser allows pop-ups, and enter your credentials into the prompt.
Step 5. Click Close on the pop-up window, and then Finish.
Step 6. After a brief restart of the web applications, SSO is enabled.
Set SSO Logs to Debug
To set the SSO logs to debug, you have to run this command in the CLI of the CUCM: set samltrace level debug
The SSO logs can be downloaded from RTMT. The name of the log set is Cisco SSO.
Find The Federation Service Name
To find the federation service name, click Start and search for AD FS 2.0 Management.
• Click on Edit Federation Service Properties… • While on the General tab, look for Federation Service name
Dotless Certificate And Federation Service Name
If you receive this error message in the AD FS configuration wizard, you need to create a new certificate.
The selected certificate cannot be used to determine the Federation Service name because the selected certificate has a dotless (short-named) Subject name. Select another certificate without a dotless (short-named) Subject name, and then try again.
Step 1. Click Start and search for iis, then open Internet Information Services (IIS) Manager
Step 2. Click your server's name.
Step 3. Click Server Certificates.
Step 4. Click Create Self-Signed Certificate.
Step 5. Enter the name you want for the alias of your certificate.
Time is Out of Sync between the CUCM and IDP Servers
If you receive this error when you run the SSO test from CUCM, you need to configure the Windows Server to use the same NTP server(s) as the CUCM.
Invalid SAML response. This can be caused when time is out of sync between the Cisco Unified Communications Manager and IDP servers. Please verify the NTP configuration on both servers. Run "utils ntp status" from the CLI to check this status on Cisco Unified Communications Manager.
Once the Windows Server has the correct NTP servers specified, you need to perform another SSO test and see if the issue persists. In some instances, it is necessary to skew the validity period of the assertion. More detail on that process here.