libre.sh/keycloak-scim
3
0
Fork 0
Code Issues 15 Pull requests Releases Packages Activity Actions

Docs for AS 7.1.1 and EAP 6.2 workaround

Browse source
This commit is contained in:
mposolda 2014-11-03 17:05:00 +01:00
parent fd08a884ad
commit d997e73f2d
2 changed files with 54 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
docbook/pom.xml
View file

@ -110,6 +110,10 @@
<name>project.version</name>
<value>${project.version}</value>
</injection>
<injection>
<name>picketlink.version</name>
<value>${picketlink.version}</value>
</injection>
</injections>
<options>
<xmlTransformerType>saxon</xmlTransformerType>

44
docbook/reference/en/en-US/modules/server-installation.xml
View file

@ -120,6 +120,9 @@ keycloak-war-dist-all-&project.version;/
Password: <emphasis>admin</emphasis>. Keycloak will then prompt you to
enter in a new password.
</para>
<para>
If you have Keycloak on JBoss AS 7.1.1 or EAP 6.2 make sure to follow <link linkend="as7-specifics">these steps</link>.
</para>
</section>
<section>
<title id="configure-server">Configuring the Server</title>
@ -389,6 +392,45 @@ keycloak-war-dist-all-&project.version;/
</para>
</section>
<section id="as7-specifics">
<title>AS7/EAP6.x specifics</title>
<para>
If you have Keycloak on JBoss AS 7.1.1 or JBoss EAP 6.2, you need to do few other things in order to have Keycloak up and running. This includes:
<orderedlist>
<listitem>
<para>
Remove or comment the element from file <literal>KEYCLOAK_HOME/standalone/deployments/auth-server.war/WEB-INF/jboss-deployment-structure.xml</literal>.
<programlisting><![CDATA[
<exclude-subsystems>
<subsystem name="webservices"/>
</exclude-subsystems>
]]></programlisting>
</para>
</listitem>
<listitem>
<para>
Then either:
</para>
<para>
<itemizedlist>
<listitem>
<para>
Disable webservices extension and subsystem by remove (or comment) both in <literal>KEYCLOAK_HOME/standalone/configuration/standalone.xml</literal>.
</para>
</listitem>
<listitem>
<para>
If you want to use webservices subsystem, the alternative is to remove 2 JAR files
<literal>KEYCLOAK_HOME/standalone/deployments/auth-server.war/WEB-INF/lib/keycloak-saml-protocol-&project.version;.jar</literal>
and <literal>KEYCLOAK_HOME/standalone/deployments/auth-server.war/WEB-INF/lib/picketlink-federation-&picketlink.version;.jar</literal>
but note that <link linkend="saml">SAML</link> won't work.
</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</orderedlist>
</para>
<section>
<title>AS7/EAP6.x Logging</title>
<para>
@ -411,6 +453,8 @@ keycloak-war-dist-all-&project.version;/
]]>
</programlisting>
</section>
</section>
<section id="ssl_modes">
<title>SSL/HTTPS Requirement/Modes</title>
<warning>