From 195383edc9212d76fd7d1198c52a4a92fce8edd6 Mon Sep 17 00:00:00 2001 From: vramik Date: Thu, 23 May 2019 11:21:31 +0200 Subject: [PATCH] KEYCLOAK-9598 Apache Tomcat 9.0.x adapter --- securing_apps/topics/oidc/java/tomcat-adapter.adoc | 14 +++++++++++--- securing_apps/topics/saml/java/tomcat-adapter.adoc | 2 +- .../tomcat_adapter_installation.adoc | 11 +++++++++-- 3 files changed, 21 insertions(+), 6 deletions(-) diff --git a/securing_apps/topics/oidc/java/tomcat-adapter.adoc b/securing_apps/topics/oidc/java/tomcat-adapter.adoc index c1b3b68653..67411b7163 100644 --- a/securing_apps/topics/oidc/java/tomcat-adapter.adoc +++ b/securing_apps/topics/oidc/java/tomcat-adapter.adoc @@ -2,7 +2,7 @@ [[_tomcat_adapter]] ==== Tomcat 7 and 8 Adapters -To be able to secure WAR apps deployed on Tomcat 7 and 8 you must install the Keycloak Tomcat 7 or 8 adapter into your Tomcat installation. +To be able to secure WAR apps deployed on Tomcat 7, 8 and 9 you must install the Keycloak Tomcat 7 adapter or Keycloak Tomcat adapter into your Tomcat installation. You then have to provide some extra configuration in each WAR you deploy to Tomcat. Let's go over these steps. @@ -16,14 +16,22 @@ They are also available as a maven artifact. You must unzip the adapter distro into Tomcat's `lib/` directory. Including adapter's jars within your WEB-INF/lib directory will not work! The Keycloak adapter is implemented as a Valve and valve code must reside in Tomcat's main lib/ directory. +Install on Tomcat 7: [source] ---- $ cd $TOMCAT_HOME/lib $ unzip keycloak-tomcat7-adapter-dist.zip - or -$ unzip keycloak-tomcat8-adapter-dist.zip +---- + +Install on Tomcat 8 or 9: + +[source] +---- + +$ cd $TOMCAT_HOME/lib +$ unzip keycloak-tomcat-adapter-dist.zip ---- ===== Required Per WAR Configuration diff --git a/securing_apps/topics/saml/java/tomcat-adapter.adoc b/securing_apps/topics/saml/java/tomcat-adapter.adoc index c56be44047..a7f45fe5ce 100644 --- a/securing_apps/topics/saml/java/tomcat-adapter.adoc +++ b/securing_apps/topics/saml/java/tomcat-adapter.adoc @@ -2,7 +2,7 @@ ==== Tomcat SAML adapters -To be able to secure WAR apps deployed on Tomcat 7 and 8 you must install the Keycloak Tomcat 7 or 8 SAML adapter into your Tomcat installation. +To be able to secure WAR apps deployed on Tomcat 7, 8 and 9 you must install the Keycloak Tomcat 7 SAML adapter or Keycloak Tomcat SAML adapter into your Tomcat installation. You then have to provide some extra configuration in each WAR you deploy to Tomcat. Let's go over these steps. diff --git a/securing_apps/topics/saml/java/tomcat-adapter/tomcat_adapter_installation.adoc b/securing_apps/topics/saml/java/tomcat-adapter/tomcat_adapter_installation.adoc index a2b180d53c..a867571d3a 100644 --- a/securing_apps/topics/saml/java/tomcat-adapter/tomcat_adapter_installation.adoc +++ b/securing_apps/topics/saml/java/tomcat-adapter/tomcat_adapter_installation.adoc @@ -10,12 +10,19 @@ You must unzip the adapter distro into Tomcat's `lib/` directory. Including adapter's jars within your WEB-INF/lib directory will not work! The Keycloak SAML adapter is implemented as a Valve and valve code must reside in Tomcat's main lib/ directory. +Install on Tomcat 7: [source] ---- $ cd $TOMCAT_HOME/lib $ unzip keycloak-saml-tomcat7-adapter-dist.zip - or -$ unzip keycloak-saml-tomcat8-adapter-dist.zip ---- +Install on Tomcat 8 or 9: + +[source] +---- + +$ cd $TOMCAT_HOME/lib +$ unzip keycloak-saml-tomcat-adapter-dist.zip +----