Keycloak 入門實戰(2)--安裝

来源:https://www.cnblogs.com/wuyongyin/archive/2022/04/03/15948879.html
-Advertisement-
Play Games

最近我看好多人的朋友圈都流行發九宮格照片，別人都能擁有，碼農必須有。當然，我們要比其他人更為高調，我們就用Python來對圖片進行處理，這肯定能秀翻你的朋友圈。廢話不說，開乾。 一、圖片導入與信息查看 在對圖像進行處理之前，我們首先需要載入出來一張圖片，我們以載入文件中存在的圖像為例子，載入圖片並查 ...


本文主要介紹 Keycloak 的安裝，使用到的軟體版本：JDK 1.8.0_151、Keycloak 16.1.1、Redhat 6.6。

1、standalone mode--獨立模式安裝

1.1、下載安裝包並解壓

下載地址：https://www.keycloak.org/downloads

解壓：

tar zxvf keycloak-16.1.1.tar.gz

1.2、修改ip

預設綁定的地址為 127.0.0.1，可修改為具體的 ip，編輯 standalone/configuration/standalone.xml：

<interfaces>
    <interface name="management">
        <inet-address value="${jboss.bind.address.management:10.49.196.10}"/>
    </interface>
    <interface name="public">
        <inet-address value="${jboss.bind.address:10.49.196.10}"/>
    </interface>
</interfaces>

1.3、啟動

nohup bin/standalone.sh &

1.4、訪問控制台

http://10.49.196.10:8080/

1.5、增加用戶

可以通過 http://localhost:8080/auth 頁面 或 bin/add-user-keycloak.sh 腳本增加用戶，如果部署在 linux 伺服器上無法通過 http://localhost:8080/auth 來訪問頁面，可通過腳本來增加用戶：

bin/add-user-keycloak.sh -u admin

設置密碼後，用戶增加成功；需重啟應用才能使用該用戶登錄系統。

1.6、使用 MySQL

Keycloak 預設使用的是 h2 資料庫，可根據需要改為其他的數據，這裡演示改為 MySQL。

1.6.1、安裝 MySQL 驅動

創建 MySQL 模塊目錄：

cd /modules/system/layers/base/com
mkdir -p mysql/main

上傳 mysql-connector-java-8.0.28.jar 到 modules/system/layers/base/com/mysql/main 目錄，併在該目錄下創建 module.xml 文件：

<?xml version="1.0" encoding="UTF-8"?>

<module name="com.mysql" xmlns="urn:jboss:module:1.9">
    <resources>
        <resource-root path="mysql-connector-java-8.0.28.jar"/>
    </resources>

    <dependencies>
        <module name="javax.api"/>
        <module name="javax.transaction.api"/>
    </dependencies>
</module>

1.6.2、修改數據源

修改 standalone/configuration/standalone.xml 文件：

<subsystem xmlns="urn:jboss:domain:datasources:6.0">
    <datasources>
        <datasource jndi-name="java:jboss/datasources/ExampleDS" pool-name="ExampleDS" enabled="true" use-java-context="true" statistics-enabled="${wildfly.datasources.statistics-enabled:${wildfly.statistics-enabled:false}}">
            <connection-url>jdbc:h2:mem:test;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE</connection-url>
            <driver>h2</driver>
            <security>
                <user-name>sa</user-name>
                <password>sa</password>
            </security>
        </datasource>
        <datasource jndi-name="java:jboss/datasources/KeycloakDS" pool-name="KeycloakDS" enabled="true" use-java-context="true" statistics-enabled="${wildfly.datasources.statistics-enabled:${wildfly.statistics-enabled:false}}">
            <!--connection-url>jdbc:h2:${jboss.server.data.dir}/keycloak;AUTO_SERVER=TRUE</connection-url-->
            <connection-url>jdbc:mysql://10.49.196.10:3306/keycloak?useUnicode=true&amp;characterEncoding=UTF-8&amp;useSSL=false</connection-url>
            <driver>mysql</driver>
            <security>
                <user-name>root</user-name>
                <password>123456</password>
            </security>
        </datasource>
        <drivers>
            <driver name="h2" module="com.h2database.h2">
                <xa-datasource-class>org.h2.jdbcx.JdbcDataSource</xa-datasource-class>
            </driver>
            <driver name="mysql" module="com.mysql">
                <xa-datasource-class>com.mysql.cj.jdbc.MysqlXADataSource</xa-datasource-class>
            </driver>
        </drivers>
    </datasources>
</subsystem>

1.6.3、重啟應用

重啟應用後，Keycloak 會自動在 MySQL 中初始化表；初始化完成後，需重新增加用戶。

2、standalone clustered mode--獨立集群模式安裝

2.1、集群規劃

ip 安裝軟體
10.49.196.10 keycloak
10.49.196.11 keycloak
10.49.196.12 nginx

2.2、先在一臺機器上(10.49.196.10)安裝 Keycloak

2.2.1、配置為使用 MySQL 資料庫

步驟與 1.6、使用 MySQL 一致，但這裡修改的配置文件為 standalone/configuration/standalone-ha.xml。

2.2.2、修改 ip

修改 standalone/configuration/standalone-ha.xml：

<interfaces>
    <interface name="management">
        <inet-address value="${jboss.bind.address.management:10.49.196.10}"/>
    </interface>
    <interface name="private">
        <inet-address value="${jboss.bind.address.private:10.49.196.10}"/>
    </interface>
    <interface name="public">
        <inet-address value="${jboss.bind.address:10.49.196.10}"/>
    </interface>
</interfaces>

2.2.3、設置 proxy-address-forwarding 為 true

編輯 standalone/configuration/standalone-ha.xml：

<server name="default-server">
    <ajp-listener name="ajp" socket-binding="ajp"/>
    <http-listener name="default" socket-binding="http" redirect-socket="https" enable-http2="true" proxy-address-forwarding="true"/>
    <https-listener name="https" socket-binding="https" ssl-context="applicationSSC" enable-http2="true"/>
    <host name="default-host" alias="localhost">
        <location name="/" handler="welcome-content"/>
        <http-invoker http-authentication-factory="application-http-authentication"/>
    </host>
</server>

2.2.4、啟動

nohup bin/standalone.sh --server-config=standalone-ha.xml &

2.3、在 10.49.196.11 上以同樣的方式安裝 Keycloak

如果集群有多台，也是同樣的安裝方式。

2.4、增加用戶

只需在一臺機器上執行該操作即可。

bin/add-user-keycloak.sh -u admin

用戶增加完成後，重啟該伺服器上的 Keycloak 即可。

2.5、配置代理

這裡使用 nginx 作為代理伺服器，其配置文件如下：

upstream keycloak {
    server 10.49.196.10:8080 weight=1;
    server 10.49.196.11:8080 weight=1;
    ip_hash;
}
server {
    listen       8080;
    server_name  localhost;

    location /auth {
        proxy_set_header    X-Forwarded-Host   $host;
        proxy_set_header    X-Forwarded-Port   $server_port;

        proxy_pass http://keycloak/auth;
    }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   html;
    }
}

這裡建議開啟 ip_hash，因為 keycloak 預設只會在一臺機器上緩存會話信息，如果會話信息不在本機器上會遠程查找，這樣會影響效率。

啟動 nginx 後，通過 http://10.49.196.12:8080/ 來訪問 Keycloak。

2.6、使用 JDBC_PING 協議(可選)

Keycloak 集群間信息同步預設使用 udp 方式下的 PING 協議，可以根據需要該為 tcp 方式或 改為 JDBC_PING 協議。這裡演示修改為 JDBC_PING 協議。修改 standalone/configuration/standalone-ha.xml：

<subsystem xmlns="urn:jboss:domain:jgroups:8.0">
    <channels default="ee">
        <channel name="ee" stack="udp" cluster="ejb"/>
    </channels>
    <stacks>
        <stack name="udp">
            <transport type="UDP" socket-binding="jgroups-udp"/>
            <!--protocol type="PING"/-->
            <protocol type="JDBC_PING">
                <property name="datasource_jndi_name">java:jboss/datasources/KeycloakDS</property>
                <property name="initialize_sql">CREATE TABLE IF NOT EXISTS JGROUPSPING (own_addr varchar(200) NOT NULL, cluster_name varchar(200) NOT NULL, updated TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, ping_data varbinary(5000) DEFAULT NULL, PRIMARY KEY (own_addr, cluster_name))
                </property>
            </protocol>
            <protocol type="MERGE3"/>
            <socket-protocol type="FD_SOCK" socket-binding="jgroups-udp-fd"/>
            <protocol type="FD_ALL"/>
            <protocol type="VERIFY_SUSPECT"/>
            <protocol type="pbcast.NAKACK2"/>
            <protocol type="UNICAST3"/>
            <protocol type="pbcast.STABLE"/>
            <protocol type="pbcast.GMS"/>
            <protocol type="UFC"/>
            <protocol type="MFC"/>
            <protocol type="FRAG3"/>
        </stack>
        <stack name="tcp">
            <transport type="TCP" socket-binding="jgroups-tcp"/>
            <socket-protocol type="MPING" socket-binding="jgroups-mping"/>
            ...

所有節點修改後，重啟 Keycloak 即可。

3、domain clustered mode--域集群模式安裝

3.1、集群規劃

ip 安裝軟體
10.49.196.10 keycloak master
10.49.196.11 keycloak slave
10.49.196.12 nginx

3.2、先在 10.49.196.10 上安裝 keycloak master

該模式對應的配置文件為 domain/configuration/domain.xml，該文件中有三個 profile，一般的修改都是針對 auth-server-clustered profile：

3.2.1、配置為使用 MySQL 資料庫

步驟與 1.6、使用 MySQL 一致，這裡修改的地方為 domain/configuration/domain.xml 中 auth-server-clustered profile 下對應的配置。

3.2.2、設置 proxy-address-forwarding 為 true

編輯 domain/configuration/domain.xml：

<server name="default-server">
    <ajp-listener name="ajp" socket-binding="ajp"/>
    <http-listener name="default" socket-binding="http" redirect-socket="https" enable-http2="true" proxy-address-forwarding="true"/>
    <https-listener name="https" socket-binding="https" ssl-context="applicationSSC" enable-http2="true"/>
    <host name="default-host" alias="localhost">
        <location name="/" handler="welcome-content"/>
        <http-invoker http-authentication-factory="application-http-authentication"/>
    </host>
</server>

3.2.3、修改 ip

編輯 domain/configuration/host-master.xml：

<interfaces>
    <interface name="management">
        <inet-address value="${jboss.bind.address.management:10.49.196.10}"/>
    </interface>
    <interface name="public">
        <inet-address value="${jboss.bind.address:10.49.196.10}"/>
    </interface>
</interfaces>

3.2.4、啟動

cd bin
nohup ./domain.sh --host-config=host-master.xml -Djboss.bind.address.private=10.49.196.40 &

3.2.5、訪問單點 Keycloak

使用域集群模式時，Keycloak 埠相對 8080 有個偏移量，具體可參考 domain/configuration/host-master.xml：

<servers>
    <server name="load-balancer" group="load-balancer-group">
        <jvm name="default"/>
    </server>
    <server name="server-one" group="auth-server-group" auto-start="true">
        <jvm name="default"/>
        <socket-bindings port-offset="150"/>
    </server>
</servers>

偏移量為 150，則地址為 http://10.40.96.132:8230/

3.2.6、添加 Keycloak 用戶

cd $KEYCLOAK_HOME/domain/servers/server-one
mkdir configuration #需先創建該目錄

cd $KEYCLOAK_HOME/bin
./add-user-keycloak.sh --sc ../domain/servers/server-one/configuration -u admin  #這裡需通過--sc指定server的位置

用戶增加完成後，重啟 Keycloak。

3.2.7、添加 slave 和 master 通信的用戶

shell> ./add-user.sh

What type of user do you wish to add? 
 a) Management User (mgmt-users.properties) 
 b) Application User (application-users.properties)
(a): 

Enter the details of the new user to add.
Using realm 'ManagementRealm' as discovered from the existing property files.
Username : admin
User 'admin' already exists and is enabled, would you like to... 
 a) Update the existing user password and roles 
 b) Disable the existing user 
 c) Type a new username
(a): 
Password recommendations are listed below. To modify these restrictions edit the add-user.properties configuration file.
 - The password should be different from the username
 - The password should not be one of the following restricted values {root, admin, administrator}
 - The password should contain at least 8 characters, 1 alphabetic character(s), 1 digit(s), 1 non-alphanumeric symbol(s)
Password : 
WFLYDM0099: Password should have at least 8 characters!
Are you sure you want to use the password entered yes/no? yes
Re-enter Password : 
What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[  ]: 
Updated user 'admin' to file '/dataload/chatops/soft/keycloak-16.1.1-domain/standalone/configuration/mgmt-users.properties'
Updated user 'admin' to file '/dataload/chatops/soft/keycloak-16.1.1-domain/domain/configuration/mgmt-users.properties'
Updated user 'admin' with groups  to file '/dataload/chatops/soft/keycloak-16.1.1-domain/standalone/configuration/mgmt-groups.properties'
Updated user 'admin' with groups  to file '/dataload/chatops/soft/keycloak-16.1.1-domain/domain/configuration/mgmt-groups.properties'
Is this new user going to be used for one AS process to connect to another AS process? 
e.g. for a slave host controller connecting to the master or for a Remoting connection for server to server Jakarta Enterprise Beans calls.
yes/no? yes
To represent the user add the following to the server-identities definition <secret value="MTIzNDU2" />

創建完成後會生成一個密鑰：<secret value="MTIzNDU2" /> ， 後面在配置 slave 時會用到該密鑰。

3.3、在 10.49.196.11 上安裝 keycloak slave

3.3.1、安裝 MySQL 驅動

步驟與 1.6.1、安裝 MySQL 驅動 一致。

3.2.2、修改 ip

編輯 domain/configuration/host-slave.xml：

<interfaces>
    <interface name="management">
        <inet-address value="${jboss.bind.address.management:10.49.196.11}"/>
    </interface>
    <interface name="public">
        <inet-address value="${jboss.bind.address:10.49.196.11}"/>
    </interface>
</interfaces>

3.2.3、修改與 master 通信的鑒權信息

A、對於 16.0.0 之前(不包含)的版本

編輯 domain/configuration/host-slave.xml：

<management>
        <security-realms>
            <security-realm name="ManagementRealm">
                <server-identities>
                    <secret value="MTIzNDU2Nw==" />
                </server-identities>
                <authentication>
                    <local default-user="$local" skip-group-loading="true"/>
                    <properties path="mgmt-users.properties" relative-to="jboss.domain.config.dir"/>
                </authentication>
                ...
<domain-controller>
    <remote security-realm="ManagementRealm" username="admin">
        <discovery-options>
            <static-discovery name="primary" protocol="${jboss.domain.master.protocol:remote+http}" host="${jboss.domain.master.address}" port="${jboss.domain.master.port:9990}"/>
        </discovery-options>
    </remote>
</domain-controller>

修改的部分參見斜體字。

B、對於 16.0.0 之後(包含)的版本

編輯 domain/configuration/host-slave.xml：

<domain-controller>
    <remote authentication-context="hcAuthContext">
        <discovery-options>
            <static-discovery name="primary" protocol="${jboss.domain.master.protocol:remote+http}" host="${jboss.domain.master.address}" port="${jboss.domain.master.port:9990}"/>
        </discovery-options>
    </remote>
</domain-controller>
...
<profile>
    <subsystem xmlns="urn:jboss:domain:core-management:1.0"/>
    <subsystem xmlns="urn:wildfly:elytron:15.0" final-providers="combined-providers" disallowed-providers="OracleUcrypto">
        <authentication-client>
            <authentication-configuration name="hostAuthConfig" authentication-name="admin" realm="ManagementRealm">
                <credential-reference clear-text="123456"/>
            </authentication-configuration>
            <authentication-context name="hcAuthContext">
                <match-rule authentication-configuration="hostAuthConfig"/>
            </authentication-context>
        </authentication-client>
        <providers>
            <aggregate-providers name="combined-providers">
                <providers name="elytron"/>
                <providers name="openssl"/>
            </aggregate-providers>
            <provider-loader name="elytron" module="org.wildfly.security.elytron"/>
            <provider-loader name="openssl" module="org.wildfly.openssl"/>
        </providers>
        ...

修改的部分參見斜體字。

3.2.4、啟動

cd bin
nohup ./domain.sh --host-config=host-slave.xml  -Djboss.bind.address.private=10.49.196.11 -Djboss.domain.master.address=10.40.96.10 &

3.2.5、訪問單點 Keycloak

使用域集群模式時，Keycloak 埠相對 8080 有個偏移量，具體可參考 domain/configuration/host-slave.xml：

<servers>
    <server name
您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • IO流（序列化流和反序列化流）
    序列化流：把對象按照流一樣的方式存入文本文件或者在網路中傳輸。對象 -- 流數據(ObjectOutputStream) * 反序列化流:把文本文件中的流對象數據或者網路中的流對象數據還原成對象。流數據 -- 對象(ObjectInputStream) package cn.itcast_07; i ...
  • java中String.intern()方法具有什麼功能呢？
    SpringBoot筆記 1.開端介紹 1.兩種核心配置文件同時存在(properties的優先順序高於yml) 2.多環境下核心配置文件 3.獲取自定義配置 4.將自定義配置映射到對象 5.springboot集成jsp <!--引入springboot內嵌Tomcat對jsp的解析依賴，不添加解析 ...
  • IO流（其餘流的介紹）
    可以讀寫基本數據類型的數據 * 數據輸入流：DataInputStream * DataInputStream(InputStream in) * 數據輸出流：DataOutputStream * DataOutputStream(OutputStream out) package cn.itcas ...
  • java中如何對二進位數進行相加呢？
    最近棧長看到各種 Firefox 瀏覽器禁止中國用戶的消息，簡單說就是 Firefox 中國無法使用去廣告插件。 這到底是怎麼回事呢？ 我於是去 Firefox 搜索了去廣告插件： 比如說打開第一個：AdGuard AdBlocker： 還真的不能用了，什麼鬼？？ 打開網路面板，看看頁面的響應信息： ...
  • scrapy框架爬蟲
    一、什麼是scrapy？ Scrapy，Python開發的一個快速、高層次的屏幕抓取和web抓取框架，用於抓取web站點並從頁面中提取結構化的數據。Scrapy用途廣泛，可以用於數據挖掘、監測和自動化測試. 其最初是為了頁面抓取 (更確切來說, 網路抓取 )所設計的， 後臺也應用在獲取API所返回的 ...
  • dubbo源碼分析8（服務消費者之生成代理對象）
    前面幾篇博客，說了很多dubbo服務提供者相關的流程； 複習一下：首先服務提供者去暴露服務介面數據到註冊中心，然後本地啟動netty服務端監聽是否有消費者的請求，現在我們可以看看消費者端是怎麼從註冊中心獲取指定的介面信息， 然後訪問netty服務端，就行了； 提前須知：要提前瞭解spring的ioc ...
  • 假期用Python寫8個小游戲（附源碼）
    假期玩嗨了吧，我給你準備了六個小游戲，有膽子來玩一玩嗎？我自己是玩了很多遍的，所以想讓大家一起玩，獨樂樂不如眾樂樂。代碼放在下麵。 1、小恐龍 玩法：上下控制起跳躲避 源碼分享： Python學習交流Q群：906715085### import cfg import sys import rando ...
  • 【Python】用150行代碼模擬太陽系行星運轉+源碼
    又到每日分享Python小技巧的時候了，我真是太開心了。今天給大家分享的是模擬太陽系行星運轉。聽起來就很不錯，效果出來的時候也是很不錯的，讓我們一起期待。 1、準備材料 首先我們需要準備這樣一些材料 宇宙背景圖 背景透明的行星圖 2：編寫代碼 代碼分塊詳解 導入需要的模塊 ###Python學習交流 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類