SpringBoot整合Keycloak實現(xiàn)單點登錄的示例代碼

更新時間：2022年03月22日 08:32:56 作者：liu320yj

本文主要介紹了SpringBoot整合Keycloak實現(xiàn)單點登錄的示例代碼，文中通過示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下

1. 搭建Keycloak服務器

本文使用docker compose安裝keycloak，因為keycloak依賴數(shù)據(jù)庫，在安裝keycloak之前需要先安裝數(shù)據(jù)庫，本文使用mysql，具體的compose配置如下：

version: '3.7'
services:
  mysql:
    container_name: mysql
    image: mysql:latest
    restart: unless-stopped
    command: --lower_case_table_names=1 --sql-mode=""
    ports:
      - 3306:3306
    volumes:
      - ./db-init:/docker-entrypoint-initdb.d
      - ./data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: 123456
  keycloak:
    container_name: keycloak
    image: jboss/keycloak:latest
    restart: unless-stopped
    depends_on:
      - mysql
    environment:
      DB_VENDOR: mysql
      DB_USER: root
      DB_PASSWORD: 123456
      KEYCLOAK_USER: admin
      KEYCLOAK_PASSWORD: 123456
    ports:
      - 8080:8080

依次執(zhí)行命令docker-compose up mysql和docker-compose up keycloak

安裝mysql

安裝keycloak

2. 配置權(quán)限

2.1. 登陸

在瀏覽器輸入地址：http://localhost:8080，出現(xiàn)如下界面

點擊Administration Console，進入登錄界面

登錄頁

輸入用戶名和密碼：admin/123456，進入首頁

2.2. 創(chuàng)建Realm

鼠標放在下圖箭頭所指處，會彈出Add realm選項

進入新增realm

點擊Add realm進入配置頁面，輸入realm名稱，點擊Create

新增realm

配置重定向地址

創(chuàng)建重定向地址

2.3. 創(chuàng)建用戶

點擊左側(cè)Users選項，進入用戶創(chuàng)建頁面

創(chuàng)建用戶

點擊Add user，進入創(chuàng)建用戶，輸入用戶名稱

創(chuàng)建用戶

點擊保存，選擇Credentials配置密碼

配置密碼

2.4. 創(chuàng)建客戶端

點擊左側(cè)Clients選項，點擊Create

創(chuàng)建客戶端

輸入Client ID名稱，點擊保存

創(chuàng)建client

2.5. 創(chuàng)建角色

在左側(cè)菜單欄選擇Roles

創(chuàng)建角色

點擊Add Role

創(chuàng)建角色

2.6. 配置用戶角色關(guān)系

用戶添加角色

2.7. 配置客戶端和角色關(guān)系

選擇左側(cè)菜單項Clients，配置Client和角色的關(guān)系

client關(guān)聯(lián)角色

3. 整合SpringBoot

3.1. 引入核心依賴

<dependencies>
	<dependency>
	    <groupId>org.springframework.boot</groupId>
	    <artifactId>spring-boot-starter-web</artifactId>
	</dependency>
	<dependency>
	    <groupId>org.keycloak</groupId>
	    <artifactId>keycloak-spring-boot-starter</artifactId>
	    <version>17.0.0</version>
	</dependency>
<dependencies/>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.keycloak.bom</groupId>
            <artifactId>keycloak-adapter-bom</artifactId>
            <version>17.0.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

3.2. 編寫Controller

@RestController
@RequestMapping("/hello")
public class HelloController {

    @GetMapping("/world")
    public String hello() {
        return "Hello World";
    }
}

3.3. 編寫application.yml

server:
  port: 8139
spring:
  application:
    name: springboot-keycloak
keycloak:
  realm: springboot-keycloak #客戶端所在的realm
  auth-server-url: http://localhost:8080/auth #keycloak授權(quán)服務器地址
  resource: sb-keycloak #客戶端名稱
  public-client: true #聲明為一個公開的客戶端
  security-constraints:
    - auth-roles:
        - sk-role
      security-collections:
        - name: hello
          patterns:
            - '/hello/world'

更多有關(guān)SpringBoot整合Keycloak的相關(guān)資料，請參閱Keycloak官網(wǎng)文檔