Who can use this feature?
If you are experiencing issues with users logging into a CivicEngage site via Active Directory Federation Services (ADFS), this article may guide you in troubleshooting the issue or with providing the necessary information to CivicPlus Technical Support for further assistance.
If your site is connected to The CivicPlus Platform (you do not have the Security Assertion Markup Language (SAML) Administration module), please see this troubleshooting article instead: Custom Identity Provider (IdP) (ADFS / Okta / Azure AD) Troubleshooting.
If experiencing issues with users logging in, auto account creation, or group syncing, first check to see if these features are enabled in the SAML Administration module (must be in the System Administrator group to access this module).
Below are basic troubleshooting questions that if addressed, speeds up the support process. If possible, please include the answers in your ticket to support.
- Is the user logging in with their Active Directory credentials?
- Is the user logging in via the ADFS service login prompt?
- What error does the user get when they try to log in? Please provide a screenshot.
- Does the user’s name, email address and group information appear in the SAML diagnostics?
- Please provide Response data.
- Users must log in using their Active Directory login (username, domain\username or username@domain), not their email.
- Note: The "username" in the User Administration module is not what is used for authentication. Authentication happens with the identity service and we sync accounts on ADFS Name ID claim value to the username in CivicPlus.
SAML Diagnostics Tool
To use the SAML diagnostics tool, log out and back in with the link, https://[httpsDomainofSite]/admin/?samldiag=ON. You must first have the Admin Login Page enabled for SAML Login (must be enabled by a System Administrator in the SAML Administration module) to use this diagnostics tool. After you log in, look to see what information is in the Response data. You should see information for email, first name, last name, and groups listed there.
Error: “Login Failed – Cannot validate SAML token.”
Cause: Signature validation certificate used to sign the ADFS SAML response does not match what is in the SAML Administration module of the website. This occurs when the ADFS Signing certificate on your ADFS server is renewed.
Fix: Update Signature Verification Certificate in the SAML Administration module of your CivicEngage website. If you need any assistance performing these steps, please reach out to CivicEngage Technical Support.