Merge pull request #138 from sebastienblanc/KEYCLOAK-4951
KEYCLOAK-4951 : reflect usage of the starter
This commit is contained in:
commit
3fbec672ac
2 changed files with 39 additions and 11 deletions
|
@ -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
|
||||||
|
|
|
@ -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 :
|
||||||
|
|
Loading…
Reference in a new issue