介紹：

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

SSO 與 Keycloak 的重要性

單一登入 (SSO) 對(duì)於簡(jiǎn)化身分驗(yàn)證流程、增強(qiáng)安全性和改善使用者體驗(yàn)至關(guān)重要。以下是一些主要好處：

1. 集中驗(yàn)證：SSO 允許使用者進(jìn)行一次身份驗(yàn)證並獲得多個(gè)應(yīng)用程式的存取權(quán)限。 Keycloak 提供對(duì)使用者身分的集中管理，這在具有大量應(yīng)用程式的環(huán)境中非常有用。

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

3. 減少密碼疲勞並增強(qiáng)使用者體驗(yàn)：透過(guò)僅登入一次，使用者可以避免密碼疲勞和多個(gè)憑證，從而使跨應(yīng)用程式的互動(dòng)更加順暢和更快。

4. 可擴(kuò)充性和靈活性：Keycloak的設(shè)定可以支援大量使用者和多個(gè)身分提供者，包括社群登入（Google、Facebook等）和企業(yè)目錄（LDAP、Active Directory ）。

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

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

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

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

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

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

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

單一登入流程說(shuō)明：

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

先決條件：

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

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

建立一個(gè)新的 Spring Boot 項(xiàng)目，其架構(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 是我的名字嗎？所以你可以把你的或你想要的任何東西當(dāng)作例子......

步驟2：設(shè)定pom.xml

將以下依賴項(xiàng)新增至您的 pom.xml 中，或者您可以僅替換依賴項(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

在根目錄建立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

使用以下命令執(zhí)行 Keycloak 伺服器：

docker-compose up -d

步驟4：配置Keycloak

1. 存取 Keycloak 管理控制臺(tái)：

   • 訪問(wèn)http://localhost:8088
   • 使用 admin/admin 作為使用者名稱和密碼登入

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

   • 前往左上角的「大師」
   • 選擇「新增領(lǐng)域」
   • 將其命名為食品訂購(gòu)領(lǐng)域
   • 點(diǎn)選「建立」

3. 建立新客戶端：
   在第一個(gè)畫面：

   • 將「客戶端 ID」設(shè)定為「food-ordering-client」
   • 客戶端類型：選擇「OpenID Connect」
   • 點(diǎn)選「下一步」

在下一個(gè)畫面（功能配置）：

• 客戶端身份驗(yàn)證：開啟此選項(xiàng)（這將取代舊的「機(jī)密」設(shè)定）
• 授權(quán)：除非您需要細(xì)微授權(quán)，否則可以將其關(guān)閉
• 點(diǎn)選「下一步」

1. 客戶端配置：
   • 將根 URL 設(shè)定為 http://localhost:8082/
   • 將存取類型設(shè)定為機(jī)密
   • 新增有效的重定向 URI（每個(gè) URI 佔(zhàn)新行）：

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

• 設(shè)定網(wǎng)路來(lái)源： http://本地主機(jī):8082
• 點(diǎn)選「儲(chǔ)存」

1. 檢索客戶端金鑰：
   • 前往「憑證」標(biāo)籤
   • 複製 Secret 欄位的值以在應(yīng)用程式設(shè)定中使用

1. 建立使用者：
   • 前往使用者並點(diǎn)選「新增使用者」
   • 設(shè)定使用者名稱（例如 testuser）
   • 在「憑證」標(biāo)籤中：
     • 設(shè)定密碼
     • 停用「暫時(shí)」

並設(shè)定密碼：

步驟5：配置Spring Boot應(yīng)用程式

在 src/main/resources 建立 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 複製的秘密，通常是一些隨機(jī)文字。
注意：

在生產(chǎn)中或作為一個(gè)好的實(shí)踐，最好將敏感資訊保存在專案根目錄的.env 檔案中，並將其用作配置中的變量，類似於${CLIENT_SECRET}當(dāng)您啟動(dòng)應(yīng)用程式時(shí)從.env 檔案中選擇它，這也適用於重定向、發(fā)行者uri 和其餘內(nèi)容..

第 6 步：建立安全性配置

在 src/main/java/com/bansikah/keycloakdemo/config 中建立 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步：建立控制器

在 src/main/java/com/bansikah/keycloakdemo/controller 中建立 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 步：建立 HTML 模板

在 src/main/resources/templates 建立 home.html：

docker-compose up -d

在 src/main/resources/templates 建立 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 存取應(yīng)用程序，並且您應(yīng)該看到此

當(dāng)您點(diǎn)擊此處連結(jié)時(shí)，您將進(jìn)入 keycloak 表單，使用者必須在 foodorder 領(lǐng)域下使用使用者名稱和密碼進(jìn)行身份驗(yàn)證

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

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

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

結(jié)論

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

參考：

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

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