Merge pull request #138 from sebastienblanc/KEYCLOAK-4951

KEYCLOAK-4951 : reflect usage of the starter
This commit is contained in:
Stian Thorgersen 2017-05-24 07:11:03 +02:00 committed by GitHub
commit 3fbec672ac
2 changed files with 39 additions and 11 deletions

View file

@ -7,9 +7,9 @@ You then have to provide some extra configuration via normal Spring Boot configu
[[_spring_boot_adapter_installation]] [[_spring_boot_adapter_installation]]
===== Adapter Installation ===== Adapter Installation
The Keycloak Spring Boot adapter takes advantage of Spring Boot's autoconfiguration so all you need to do is add the Keycloak Spring Boot adapter JAR to your project. The Keycloak Spring Boot adapter takes advantage of Spring Boot's autoconfiguration so all you need to do is add the Keycloak Spring Boot starter to your project.
Depending on what container you are using with Spring Boot, you also need to add the appropriate Keycloak container adapter. They Keycloak Spring Boot Starter is also directly available from the http://start.spring.io/[Spring Start Page].
If you are using Maven, add the following to your pom.xml (using Tomcat as an example): To add it manually and if you are using Maven, add the following to your dependencies :
[source,xml,subs="attributes+"] [source,xml,subs="attributes+"]
@ -18,17 +18,33 @@ If you are using Maven, add the following to your pom.xml (using Tomcat as an ex
<dependency> <dependency>
<groupId>org.keycloak</groupId> <groupId>org.keycloak</groupId>
<artifactId>keycloak-spring-boot-adapter</artifactId> <artifactId>keycloak-spring-boot-starter</artifactId>
<version>{{book.project.versionMvn}}</version>
</dependency>
<dependency>
<groupId>org.keycloak</groupId>
<artifactId>keycloak-tomcat8-adapter</artifactId>
<version>{{book.project.versionMvn}}</version>
</dependency> </dependency>
---- ----
Currently the following embedded containers are supported : Make also sure to add the Adapter BOM dependency :
[source,xml,subs="attributes+"]
----
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.keycloak.bom</groupId>
<artifactId>keycloak-adapter-bom</artifactId>
<version>{{book.project.versionMvn}}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
----
Currently the following embedded containers are supported and do not require any extra dependencies if using the Starter:
* Tomcat * Tomcat
* Undertow * Undertow

View file

@ -229,6 +229,18 @@ public class RemoteProductService implements ProductService {
The Spring Boot and the Spring Security adapters can be combined. The Spring Boot and the Spring Security adapters can be combined.
If you are using the Keycloak Spring Boot Starter to make use of the Spring Security adapter you just need to add the Spring Security starter :
[source]
----
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-security</artifactId>
</dependency>
----
====== Using Spring Boot Configuration ====== Using Spring Boot Configuration
By Default, the Spring Security Adapter looks for a `keycloak.json` configuration file. You can make sure it looks at the configuration provided by the Spring Boot Adapter by adding this bean : By Default, the Spring Security Adapter looks for a `keycloak.json` configuration file. You can make sure it looks at the configuration provided by the Spring Boot Adapter by adding this bean :