From 4433347ff334d6307817338cc633e7bf2f5e70b1 Mon Sep 17 00:00:00 2001 From: Brett Meyer Date: Tue, 14 Jul 2015 15:55:14 -0400 Subject: [PATCH] KEYCLOAK-1563 update docs for server/adapter subsystem split & WF 9.0.0.Final --- .../modules/MigrationFromOlderVersions.xml | 6 ++-- .../en/en-US/modules/jboss-adapter.xml | 32 ++++++++++--------- .../en/en-US/modules/server-installation.xml | 14 ++++---- 3 files changed, 27 insertions(+), 25 deletions(-) diff --git a/docbook/reference/en/en-US/modules/MigrationFromOlderVersions.xml b/docbook/reference/en/en-US/modules/MigrationFromOlderVersions.xml index 2815f6f2b3..5996b6d286 100755 --- a/docbook/reference/en/en-US/modules/MigrationFromOlderVersions.xml +++ b/docbook/reference/en/en-US/modules/MigrationFromOlderVersions.xml @@ -103,11 +103,11 @@ - WildFly 9.0.0.CR2 + WildFly 9.0.0.Final Following on from the distribution changes that was done in the last release the standalone download - of Keycloak is now based on WildFly 9.0.0.CR2. This als affects the overlay which can only be deployed - to WildFly 9.0.0.CR2 or JBoss EAP 6.4.0.GA. WildFly 8.2.0.Final is no longer supported for the server. + of Keycloak is now based on WildFly 9.0.0.Final. This als affects the overlay which can only be deployed + to WildFly 9.0.0.Final or JBoss EAP 6.4.0.GA. WildFly 8.2.0.Final is no longer supported for the server. diff --git a/docbook/reference/en/en-US/modules/jboss-adapter.xml b/docbook/reference/en/en-US/modules/jboss-adapter.xml index f3794904b6..08949b4ca5 100755 --- a/docbook/reference/en/en-US/modules/jboss-adapter.xml +++ b/docbook/reference/en/en-US/modules/jboss-adapter.xml @@ -199,7 +199,7 @@ public class CustomerService { Securing WARs via Keycloak Subsystem You do not have to crack open a WAR to secure it with Keycloak. Alternatively, you can externally secure - it via the Keycloak Subsystem. While you don't have to specify KEYCLOAK as an auth-method, + it via the Keycloak Adapter Subsystem. While you don't have to specify KEYCLOAK as an auth-method, you still have to define the security-constraints in web.xml. You do not, however, have to create a WEB-INF/keycloak.json file. This metadata is instead defined within XML in your server's domain.xml or standalone.xml subsystem @@ -207,20 +207,22 @@ public class CustomerService { + + + - - - - demo - MIGfMA0GCSqGSIb3DQEBAQUAA - http://localhost:8081/auth - external - customer-portal - password - - - + + + + demo + MIGfMA0GCSqGSIb3DQEBAQUAA + http://localhost:8081/auth + external + customer-portal + password + + + ]]> @@ -242,7 +244,7 @@ public class CustomerService { + MIGfMA0GCSqGSIb3DQEBA http://localhost:8080/auth diff --git a/docbook/reference/en/en-US/modules/server-installation.xml b/docbook/reference/en/en-US/modules/server-installation.xml index ddc5f33ee8..9584852177 100755 --- a/docbook/reference/en/en-US/modules/server-installation.xml +++ b/docbook/reference/en/en-US/modules/server-installation.xml @@ -43,10 +43,10 @@
- Install on existing WildFly 9.0.0.CR2 + Install on existing WildFly 9.0.0.Final - Keycloak can be installed into an existing WildFly 9.0.0.CR2 server. To do this download - keycloak-overlay-&project.version;.zip or keycloak-overlay-&project.version;.tar.gz. + Keycloak can be installed into an existing WildFly 9.0.0.Final server. To do this download + keycloak-overlay-&project.version;.zip or keycloak-overlay-&project.version;.tar.gz. Once downloaded extract into the root directory of your WildFly installation. To start WildFly with Keycloak run: keycloak-&project.version;/bin/standalone.sh --server-config=standalone-keycloak.xml @@ -65,16 +65,16 @@ to, for example standalone/configuration/standalone.xml. From standalone-keycloak.xml you need to copy 3 elements: - <extension module="org.keycloak.keycloak-subsystem"/> + <extension module="org.keycloak.keycloak-server-subsystem"/> <datasource jndi-name="java:jboss/datasources/KeycloakDS" ...> - <subsystem xmlns="urn:jboss:domain:keycloak:1.0" ...> + <subsystem xmlns="urn:jboss:domain:keycloak-server:1.1" ...>
Install on existing JBoss EAP 6.4.0.GA - Same procedure as JBoss EAP 6.4.0.GA, but download keycloak-overlay-eap6-&project.version;.zip or keycloak-overlay-eap6-&project.version;.tar.gz. + Same procedure as WildFly 9.0.0.Final, but download keycloak-overlay-eap6-&project.version;.zip or keycloak-overlay-eap6-&project.version;.tar.gz.
@@ -84,7 +84,7 @@ To install it first download keycloak-demo-&project.version;.zip or keycloak-demo-&project.version;.tar.gz. Once downloaded extract it inside keycloak-demo-&project.version; you'll find keycloak which contains - a full WildFly 9.0.0.CR2 server with Keycloak Server and Adapters included. You'll also find docs + a full WildFly 9.0.0.Final server with Keycloak Server and Adapters included. You'll also find docs and examples which contains everything you need to get started developing applications that use Keycloak.