keycloak-aplcache

KEYCLOAK-2389

1/25/2016 10:34:57 PM

Bill Burke

Commit: daec897

Tree: cf7eff6

Parents: 1b0aa8e

Changes

docbook/saml-adapter-docs/reference/en/en-US/master.xml 2(+2 -0)

docbook/saml-adapter-docs/reference/en/en-US/modules/adapter_error_handling.xml 2(+1 -1)

docbook/saml-adapter-docs/reference/en/en-US/modules/debugging.xml 8(+8 -0)

testsuite/integration/src/test/resources/log4j.properties 2(+1 -1)

Details

docbook/saml-adapter-docs/reference/en/en-US/master.xml 2(+2 -0)

diff --git a/docbook/saml-adapter-docs/reference/en/en-US/master.xml b/docbook/saml-adapter-docs/reference/en/en-US/master.xml
index 7f14165..89d16e6 100755
--- a/docbook/saml-adapter-docs/reference/en/en-US/master.xml
+++ b/docbook/saml-adapter-docs/reference/en/en-US/master.xml
@@ -11,6 +11,7 @@
                 <!ENTITY Assertions SYSTEM "modules/assertion-api.xml">
                 <!ENTITY Logout SYSTEM "modules/logout.xml">
                 <!ENTITY ErrorHandling SYSTEM "modules/adapter_error_handling.xml">
+                <!ENTITY DEBUGGING SYSTEM "modules/debugging.xml">
                 ]>
 
 <book>
@@ -53,6 +54,7 @@ This one is short
     &Logout;
     &Assertions;
     &ErrorHandling;
+    &DEBUGGING;

docbook/saml-adapter-docs/reference/en/en-US/modules/adapter_error_handling.xml 2(+1 -1)

diff --git a/docbook/saml-adapter-docs/reference/en/en-US/modules/adapter_error_handling.xml b/docbook/saml-adapter-docs/reference/en/en-US/modules/adapter_error_handling.xml
index 1d6d11f..152c6b9 100755
--- a/docbook/saml-adapter-docs/reference/en/en-US/modules/adapter_error_handling.xml
+++ b/docbook/saml-adapter-docs/reference/en/en-US/modules/adapter_error_handling.xml
@@ -39,4 +39,4 @@ public class SamlAuthenticationError implements AuthenticationError {
 }
 </programlisting>
     </para>
-</chapter>
\ No newline at end of file
+</chapter>

docbook/saml-adapter-docs/reference/en/en-US/modules/debugging.xml 8(+8 -0)

diff --git a/docbook/saml-adapter-docs/reference/en/en-US/modules/debugging.xml b/docbook/saml-adapter-docs/reference/en/en-US/modules/debugging.xml
new file mode 100755
index 0000000..81e252c
--- /dev/null
+++ b/docbook/saml-adapter-docs/reference/en/en-US/modules/debugging.xml
@@ -0,0 +1,8 @@
+<chapter id="debugging">
+    <title>Troubleshooting</title>
+    <para>
+        The best way to troubleshoot some problems is to turn on debugging for saml in both the client adapter and the keycloak server.
+        To do this turn on debugging int the <literal>org.keycloak.saml</literal> package to <literal>debug</literal> in your log4j or other
+        logging framework.  Turning this on allows you to see the SAML requests and response documents being sent to and from the server.
+    </para>
+</chapter>
\ No newline at end of file

testsuite/integration/src/test/resources/log4j.properties 2(+1 -1)

diff --git a/testsuite/integration/src/test/resources/log4j.properties b/testsuite/integration/src/test/resources/log4j.properties
index 2c2eb30..502dd7c 100755
--- a/testsuite/integration/src/test/resources/log4j.properties
+++ b/testsuite/integration/src/test/resources/log4j.properties
@@ -38,7 +38,7 @@ log4j.logger.org.keycloak.connections.jpa.updater.liquibase.LiquibaseJpaUpdaterP
 
 # Enable to view detailed AS REQ and TGS REQ requests to embedded Kerberos server
 # log4j.logger.org.apache.directory.server.kerberos=debug
-log4j.logger.org.keycloak.saml=debug
+#log4j.logger.org.keycloak.saml=debug
 
 log4j.logger.org.xnio=off
 log4j.logger.org.hibernate=off