介紹：

單點(diǎn)登錄 (SSO) 已成為現(xiàn)代 Web 應(yīng)用程序的一項(xiàng)重要功能，可增強(qiáng)用戶(hù)體驗(yàn)和安全性。這份綜合指南將引導(dǎo)您完成使用 Keycloak 和 Spring Boot 實(shí)現(xiàn) SSO，為您的應(yīng)用程序提供強(qiáng)大的身份驗(yàn)證和授權(quán)解決方案。

SSO 與 Keycloak 的重要性

單點(diǎn)登錄 (SSO) 對(duì)于簡(jiǎn)化身份驗(yàn)證流程、增強(qiáng)安全性和改善用戶(hù)體驗(yàn)至關(guān)重要。以下是一些主要好處：

1. 集中身份驗(yàn)證：SSO 允許用戶(hù)進(jìn)行一次身份驗(yàn)證并獲得對(duì)多個(gè)應(yīng)用程序的訪(fǎng)問(wèn)權(quán)限。 Keycloak 提供對(duì)用戶(hù)身份的集中管理，這在具有大量應(yīng)用程序的環(huán)境中非常有用。

2. 提高安全性：通過(guò)集中身份管理，可以統(tǒng)一執(zhí)行安全策略（如密碼強(qiáng)度、雙因素身份驗(yàn)證和帳戶(hù)鎖定策略）。 Keycloak 對(duì) OpenID Connect 和 OAuth 2.0 等協(xié)議的支持確保了強(qiáng)大的現(xiàn)代安全標(biāo)準(zhǔn)。

3. 減少密碼疲勞并增強(qiáng)用戶(hù)體驗(yàn)：通過(guò)僅登錄一次，用戶(hù)可以避免密碼疲勞和多個(gè)憑據(jù)，從而使跨應(yīng)用程序的交互更加順暢和更快。

4. 可擴(kuò)展性和靈活性：Keycloak的配置可以支持大量用戶(hù)和多個(gè)身份提供商，包括社交登錄（Google、Facebook等）和企業(yè)目錄（LDAP、Active Directory）。

5. 自定義和可擴(kuò)展性：Keycloak 允許自定義主題、登錄流程和擴(kuò)展，使其能夠適應(yīng)各種需求。它也是開(kāi)源的，為組織提供了根據(jù)需要修改或擴(kuò)展平臺(tái)的靈活性。
   單點(diǎn)登錄 (SSO) 的替代方案：

6. 多重登錄/傳統(tǒng)身份驗(yàn)證：

   • 用戶(hù)對(duì)每個(gè)應(yīng)用程序或服務(wù)都有單獨(dú)的憑據(jù)
   • 需要單獨(dú)登錄每個(gè)系統(tǒng)
   • 每個(gè)應(yīng)用程序管理自己的身份驗(yàn)證

7. 聯(lián)合身份：

   • 與 SSO 類(lèi)似，但允許跨不同組織進(jìn)行身份驗(yàn)證
   • 使用 SAML 或 OpenID Connect 等標(biāo)準(zhǔn)
   • 用戶(hù)的身份由其所屬組織驗(yàn)證

8. 多重身份驗(yàn)證 (MFA)：

   • 除了用戶(hù)名和密碼之外還添加了額外的安全層
   • 可以與 SSO 或傳統(tǒng)身份驗(yàn)證一起使用
   • 通常涉及您知道、擁有和正在的事物

單點(diǎn)登錄流程說(shuō)明：

在深入實(shí)施之前，讓我們先了解 SSO 流程：

先決條件：

• Java 17 或更高版本
• Maven
• Docker（用于運(yùn)行 Keycloak）

第 1 步：項(xiàng)目設(shè)置

創(chuàng)建一個(gè)新的 Spring Boot 項(xiàng)目，其結(jié)構(gòu)如下：

keycloak-demo/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── bansikah/
│   │   │           └── keycloakdemo/
│   │   │               ├── config/
│   │   │               │   └── SecurityConfig.java
│   │   │               ├── controller/
│   │   │               │   └── FoodOrderingController.java
│   │   │               └── KeycloakDemoApplication.java
│   │   └── resources/
│   │       ├── templates/
│   │       │   ├── home.html
│   │       │   └── menu.html
│   │       └── application.yml
├── docker-compose.yml
└── pom.xml

注意：

bansikah 是我的名字嗎？所以你可以把你的或者你想要的任何東西作為例子......

步驟2：配置pom.xml

將以下依賴(lài)項(xiàng)添加到您的 pom.xml 中，或者您可以?xún)H替換依賴(lài)項(xiàng)部分以避免沖突：

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-security</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-oauth2-client</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-oauth2-resource-server</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.thymeleaf.extras/thymeleaf-extras-springsecurity3 -->
        <dependency>
            <groupId>org.thymeleaf.extras</groupId>
            <artifactId>thymeleaf-extras-springsecurity3</artifactId>
            <version>3.0.5.RELEASE</version>
        </dependency>
    </dependencies>

第 3 步：使用 Docker 設(shè)置 Keycloak

在根目錄創(chuàng)建docker-compose.yml文件：

version: '3'

services:
  keycloak:
    image: quay.io/keycloak/keycloak:latest
    environment:
      KEYCLOAK_ADMIN: admin
      KEYCLOAK_ADMIN_PASSWORD: admin
    ports:
      - "8088:8080"
    command:
      - start-dev

  app:
    build: .
    ports:
      - "8082:8082"
    depends_on:
      - keycloak

使用以下命令運(yùn)行 Keycloak 服務(wù)器：

docker-compose up -d

第4步：配置Keycloak

1. 訪(fǎng)問(wèn) Keycloak 管理控制臺(tái)：

   • 訪(fǎng)問(wèn)http://localhost:8088
   • 使用 admin/admin 作為用戶(hù)名和密碼登錄

2. 創(chuàng)建一個(gè)新領(lǐng)域：

   • 前往左上角的“大師”
   • 選擇“添加領(lǐng)域”
   • 將其命名為食品訂購(gòu)領(lǐng)域
   • 點(diǎn)擊“創(chuàng)建”

3. 創(chuàng)建新客戶(hù)端：
   在第一個(gè)屏幕上：

   • 將“客戶(hù)端 ID”設(shè)置為“food-ordering-client”
   • 客戶(hù)端類(lèi)型：選擇“OpenID Connect”
   • 點(diǎn)擊“下一步”

在下一個(gè)屏幕上（功能配置）：

• 客戶(hù)端身份驗(yàn)證：打開(kāi)此選項(xiàng)（這將取代舊的“機(jī)密”設(shè)置）
• 授權(quán)：除非您需要細(xì)粒度授權(quán)，否則可以將其關(guān)閉
• 點(diǎn)擊“下一步”

1. 客戶(hù)端配置：
   • 將根 URL 設(shè)置為 http://localhost:8082/
   • 將訪(fǎng)問(wèn)類(lèi)型設(shè)置為機(jī)密
   • 添加有效的重定向 URI（每個(gè) URI 占新行）：

 http://localhost:8082/
 http://localhost:8082/menu
 http://localhost:8082/login/oauth2/code/keycloak

• 設(shè)置網(wǎng)絡(luò)來(lái)源： http://本地主機(jī):8082
• 點(diǎn)擊“保存”

1. 檢索客戶(hù)端密鑰：
   • 轉(zhuǎn)到“憑據(jù)”選項(xiàng)卡
   • 復(fù)制 Secret 字段的值以在應(yīng)用程序配置中使用

1. 創(chuàng)建用戶(hù)：
   • 轉(zhuǎn)到用戶(hù)并單擊“添加用戶(hù)”
   • 設(shè)置用戶(hù)名（例如 testuser）
   • 在“憑據(jù)”選項(xiàng)卡中：
     • 設(shè)置密碼
     • 禁用“臨時(shí)”

并設(shè)置密碼：

第5步：配置Spring Boot應(yīng)用程序

在 src/main/resources 中創(chuàng)建 application.yml：

keycloak-demo/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── bansikah/
│   │   │           └── keycloakdemo/
│   │   │               ├── config/
│   │   │               │   └── SecurityConfig.java
│   │   │               ├── controller/
│   │   │               │   └── FoodOrderingController.java
│   │   │               └── KeycloakDemoApplication.java
│   │   └── resources/
│   │       ├── templates/
│   │       │   ├── home.html
│   │       │   └── menu.html
│   │       └── application.yml
├── docker-compose.yml
└── pom.xml

替換從 Keycloak 復(fù)制的秘密，通常是一些隨機(jī)文本。
注意：

在生產(chǎn)中或作為一個(gè)好的實(shí)踐，最好將敏感信息保存在項(xiàng)目根目錄的 .env 文件中，并將其用作配置中的變量，類(lèi)似于 ${CLIENT_SECRET}當(dāng)您啟動(dòng)應(yīng)用程序時(shí)從 .env 文件中選擇它，這也適用于重定向、發(fā)行者 uri 和其余內(nèi)容..

第 6 步：創(chuàng)建安全配置

在 src/main/java/com/bansikah/keycloakdemo/config 中創(chuàng)建 SecurityConfig.java：

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-security</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-oauth2-client</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-oauth2-resource-server</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.thymeleaf.extras/thymeleaf-extras-springsecurity3 -->
        <dependency>
            <groupId>org.thymeleaf.extras</groupId>
            <artifactId>thymeleaf-extras-springsecurity3</artifactId>
            <version>3.0.5.RELEASE</version>
        </dependency>
    </dependencies>

第7步：創(chuàng)建控制器

在 src/main/java/com/bansikah/keycloakdemo/controller 中創(chuàng)建 FoodOrderingController.java：

version: '3'

services:
  keycloak:
    image: quay.io/keycloak/keycloak:latest
    environment:
      KEYCLOAK_ADMIN: admin
      KEYCLOAK_ADMIN_PASSWORD: admin
    ports:
      - "8088:8080"
    command:
      - start-dev

  app:
    build: .
    ports:
      - "8082:8082"
    depends_on:
      - keycloak

第 8 步：創(chuàng)建 HTML 模板

在 src/main/resources/templates 中創(chuàng)建 home.html：

docker-compose up -d

在 src/main/resources/templates 中創(chuàng)建 menu.html：

 http://localhost:8082/
 http://localhost:8082/menu
 http://localhost:8082/login/oauth2/code/keycloak

第 9 步：運(yùn)行應(yīng)用程序

您應(yīng)該能夠通過(guò)此 URL http://localhost:8082 訪(fǎng)問(wèn)應(yīng)用程序，并且您應(yīng)該看到此

當(dāng)您單擊此處鏈接時(shí)，您將進(jìn)入 keycloak 表單，用戶(hù)必須在 foodorder 領(lǐng)域下使用用戶(hù)名和密碼進(jìn)行身份驗(yàn)證

通過(guò)身份驗(yàn)證后您將看到菜單頁(yè)面

現(xiàn)在有了 SSO 的重要性，即使我注銷(xiāo)，我也不必再次登錄，如下

然后我可以再次單擊該鏈接，系統(tǒng)將不會(huì)提示我再次輸入我的密碼和用戶(hù)名，如下所示

結(jié)論

恭喜？，感謝您到目前為止的跟進(jìn)
此實(shí)現(xiàn)演示了使用 Keycloak 和 Spring Boot 的強(qiáng)大 SSO 解決方案。它提供無(wú)縫的身份驗(yàn)證體驗(yàn)，同時(shí)保持安全性。該配置允許輕松定制和擴(kuò)展，以滿(mǎn)足特定的應(yīng)用程序需求。
如果您遇到任何問(wèn)題或?qū)Υ藢?shí)施有疑問(wèn)，請(qǐng)隨時(shí)在下面發(fā)表評(píng)論。請(qǐng)記得查看 Spring Security 和 Keycloak 文檔以獲取更高級(jí)的配置和功能。
github 上的代碼鏈接

參考：

• 春季靴
• 鑰匙斗篷
• Java 17
• Maven
• 碼頭工人

以上是Keycloak 和 Spring Boot：實(shí)現(xiàn)單點(diǎn)登錄的終極指南的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！