How can I activate SAML tracing?

Why is SAML tracing needed?

SAML Tracing is an important tool for troubleshooting and optimising SAML-based authentication processes.

SAML Tracing makes it possible to trace the entire SAML authentication flow in detail. This is particularly useful when problems occur during login or single sign-on (SSO). By analysing the SAML messages, errors in the configuration or data exchange between the identity provider (IdP) and service provider (SP) can be identified. This is particularly useful in the set-up phase for authentication mechanisms such as SAML.

Logging is automatically switched off when the web server is restarted.

This guide applies to ADONIS 16, ADOIT 17 and ADOGRC 13 and later versions. For instructions applicable to earlier versions, please click here.

These instructions apply to versions prior to ADONIS 16, ADOIT 17 and ADOGRC 13. For instructions that apply to later versions, please click here.

How can I activate SAML tracing (pre ADONIS 16, ADOIT 17 and ADOGRC 13)?

Step	Description	Image
1	Log in to the web client of a BOC product (ADONIS, ADOIT, ADOGRC). Make sure that you are logged into the web client as an administrator. To do this, click on the three cogwheels to get the corresponding view.
2	Click on Authentication at the bottom right.
3	In the next step, click on More options.
4	In the menu that appears, click on General settings.
5	Now activate Tracing by clicking on it.
6	As soon as you have clicked on it, an information message appears, which you can close by clicking on OK and a message appears at the bottom right-hand edge stating that tracing is now active. Tracing now remains active until the web server is restarted.

Step	Description	Image
1	Log in to the web client of a BOC product (ADONIS, ADOIT, ADOGRC). Make sure that you are logged into the web client as an administrator. To do this, change the ending of the URL from `/auth.view` to `/admin.view` to obtain the corresponding view.
2	Click on the three dots to the right of the house symbol.
3	In the next step, click on Authentication.
4	Activate Tracing in the menu by clicking on it.
5	As soon as you have clicked on it, a message appears in the bottom right-hand corner indicating that tracing is now active. Tracing now remains active until the web server is restarted.