Troubleshooting

This section lists options for troubleshooting SAML SSO issues.

SAML Debug Trace

SAML debug trace may be enabled to assist with tracking down issues.

Note

It's not recommended to enable SAML debug trace in production environments, unless for problem determination, as it may impact performance.

Update your application's web.config to include a system.diagnostics section as shown in the configuration below.

Log files are written to the logs sub-folder under your application's root folder.

<system.diagnostics>
    <trace autoflush="true">
      <listeners>
         <add name="CyclicTextWriter"/>
      </listeners>
    </trace>
    <sources>
      <source name="ComponentSpace.SAML2" switchValue="Verbose">
        <listeners>
          <add name="CyclicTextWriter"/>
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <!-- Ensure IIS has create/write file permissions for the log folder. -->
      <add 
        name="CyclicTextWriter"  
        type="ComponentSpace.SAML2.Utility.CyclicTraceListener,ComponentSpace.SAML2" 
        initializeData="logs"/>
    </sharedListeners>
 </system.diagnostics>