2016-04-18 19:10:32 +00:00
|
|
|
|
|
|
|
|
[[_jetty8_adapter]]
|
2016-06-01 11:02:44 +00:00
|
|
|
=== Jetty 8.1.x Adapter
|
2016-04-18 19:10:32 +00:00
|
|
|
|
|
|
|
|
Keycloak has a separate adapter for Jetty 8.1.x that you will have to install into your Jetty installation.
|
|
|
|
|
You then have to provide some extra configuration in each WAR you deploy to Jetty.
|
|
|
|
|
Let's go over these steps.
|
|
|
|
|
|
|
|
|
|
[[_jetty8_adapter_installation]]
|
2016-06-01 11:02:44 +00:00
|
|
|
==== Adapter Installation
|
2016-04-18 19:10:32 +00:00
|
|
|
|
|
|
|
|
Adapters are no longer included with the appliance or war distribution.Each adapter is a separate download on the Keycloak download site.
|
|
|
|
|
They are also available as a maven artifact.
|
|
|
|
|
|
|
|
|
|
You must unzip the Jetty 8.1.x distro into Jetty 8.1.x's root directory.
|
|
|
|
|
Including adapter's jars within your WEB-INF/lib directory will not work!
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[source]
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
$ cd $JETTY_HOME
|
|
|
|
|
$ unzip keycloak-jetty81-adapter-dist.zip
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
Next, you will have to enable the keycloak option.
|
|
|
|
|
Edit start.ini and add keycloak to the options
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[source]
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#===========================================================
|
|
|
|
|
# Start classpath OPTIONS.
|
|
|
|
|
# These control what classes are on the classpath
|
|
|
|
|
# for a full listing do
|
|
|
|
|
# java -jar start.jar --list-options
|
|
|
|
|
#-----------------------------------------------------------
|
|
|
|
|
OPTIONS=Server,jsp,jmx,resources,websocket,ext,plus,annotations,keycloak
|
|
|
|
|
----
|
|
|
|
|
|
2016-06-01 11:02:44 +00:00
|
|
|
==== Required Per WAR Configuration
|
2016-04-18 19:10:32 +00:00
|
|
|
|
|
|
|
|
Enabling Keycloak for your WARs is the same as the Jetty 9.x adapter.
|
|
|
|
|
Our 8.1.x adapter supports both keycloak.json and the jboss-web.xml advanced configuration.
|
|
|
|
|
See <<_jetty9_per_war,Required Per WAR Configuration>>
|
