diff --git a/SUMMARY.adoc b/SUMMARY.adoc index 9729f18fe2..ed8fb7f5c4 100644 --- a/SUMMARY.adoc +++ b/SUMMARY.adoc @@ -11,6 +11,7 @@ ... link:topics/oidc/java/java-adapter-config.adoc[Java Adapters Config] ... link:topics/oidc/java/jboss-adapter.adoc[JBoss EAP/Wildfly Adapter] ... link:topics/oidc/java/fuse-adapter.adoc[JBoss Fuse Adapter] + .... link:topics/oidc/java/fuse/install-feature.adoc[Install Feature] .... link:topics/oidc/java/fuse/classic-war.adoc[Classic WAR application] .... link:topics/oidc/java/fuse/servlet-whiteboard.adoc[Servlet Deployed as OSGI Service] .... link:topics/oidc/java/fuse/camel.adoc[Apache Camel] diff --git a/topics/oidc/java/fuse-adapter.adoc b/topics/oidc/java/fuse-adapter.adoc index 58f42914bd..9f3258a023 100755 --- a/topics/oidc/java/fuse-adapter.adoc +++ b/topics/oidc/java/fuse-adapter.adoc @@ -23,6 +23,7 @@ What is supported for Fuse is: ===== How to secure your web applications inside Fuse +The first thing to do is usually installing of {{book.project.name}} Karaf feature. Then do the steps according to what type of application you want to secure. Basically all mentioned web applications require to inject {{book.project.name}} Jetty authenticator into underlying Jetty server . The steps to achieve it are bit different according to application type. The details are described in individual sub-chapters. diff --git a/topics/oidc/java/fuse/install-feature.adoc b/topics/oidc/java/fuse/install-feature.adoc new file mode 100644 index 0000000000..42bb1e6823 --- /dev/null +++ b/topics/oidc/java/fuse/install-feature.adoc @@ -0,0 +1,68 @@ + +[[_fuse_install_feature]] +===== Install Feature + +First thing to be done is to install the feature `keycloak` into the JBoss Fuse environment. This will install the Fuse adapter +together with all needed 3rd party dependencies. There are 2 possibilities to install it. + + +====== Install from Maven Repository + +You need to be online and have access to the maven repository. + +{% if book.community %} +For community it's sufficient to be online as all the artifacts and 3rd party dependencies should be available in maven central repository. +{% endif %} + +You need to start JBoss Fuse and then in the Karaf terminal you type this: + +[source] +---- +features:addurl mvn:org.keycloak/keycloak-osgi-features/{{book.project.versionMvn}}/xml/features +features:install keycloak +---- + +Then in JBoss Fuse 6.2 you may need to install Jetty 8 feature: + +[source] +---- +features:install keycloak-jetty8-adapter +---- + +Or in JBoss Fuse 6.3 you may need to install Jetty 9 feature: + +[source] +---- +features:install keycloak-jetty9-adapter +---- + +Then you can check that requested features were installed: + +[source] +---- +features:list | grep keycloak +---- + +====== Install from ZIP bundle + +This is useful if you are offline and/or don't want to use maven for download jar files and other artifacts. Once you download ZIP bundle of {{book.project.name}} Fuse adapter, +you will need to unzip it into the root directory of JBoss Fuse. This should install the dependencies under the `system` directory. For example see this for Fuse 6.2.1 : + +[source] +---- +cd /path-to-fuse/jboss-fuse-6.2.1.redhat-084 +unzip -q /path-to-adapter-zip/keycloak-fuse-adapter-dist-{{book.project.versionMvn}}.zip +---- + +Feel free to overwrite all already existing jars. Once you unzip archive, you can start the Fuse and again run commands in fuse/karaf terminal + +[source] +---- +features:addurl mvn:org.keycloak/keycloak-osgi-features/{{book.project.versionMvn}}/xml/features +features:install keycloak +---- + +And also install the corresponding Jetty adapter. The difference from the previous part is, that nothing will be downloaded from maven repository as the artifacts were +available directly in JBoss Fuse `system` directory. + +