SSO troubleshooting and maintenance
The following covers common scenarios and possible solutions.
Table: Scenarios and its solutions.
Scenario | Solution |
|---|---|
SSL Certificate Revisions | If there are changes to the SSL certificates perform the following steps:
|
Identity Provider Server (IDP) Revisions | If there are changes to the IDP server, the entire SSO configuration and registration process must be redone. |
Identity Provider (IDP) Login Screen Not Displaying |
|
Message Security Error | This error is displayed when SSL certificates are not as expected with regards to the metadata XML files. Verify the SSL certificates satisfy all the requirements on both the IT Analytics Portal and the IDP server. |
Security Provider Not Registered | This error indicates the registration process between the IDP server andIT Analytics Portal was not completed successfully. Verify the exchange of both metadata XML files was done correctly. |
IDPSSODescriptor Not Found | This error indicates the Entity Base URL and the path to the IDP server was set incorrectly. Verify there is no '/' at the end of the given path. |
Stale Request |
|
Login Issues/Reset Utility | If Single Sign On (SSO) is not properly set up in the Admin>Advanced>System Configuration, after restarting you may not be able to log into the Portal. This utility resets the Single Sign On (SSO) parameters to provide Portal access. Run the following scripts from the command prompt: Linux cd /opt/aptare/utils ./resetSSOConfig.sh Windows cd C:\opt\aptare\utils resetSSOConfig.bat Restart the Portal services after running the OS specific script. |