keycloak的安装和启动

淩亂°似流年 2022-04-22 06:06 640阅读 0赞

1.  [官网下载keycloak][keycloak] ，我的版本是`keycloak-4.5.0.Final.tar.gz`
2.  上传到`linux`，解压 `tar -zxvf keycloak-4.5.0.Final.tar.gz`
3.  修改文件夹名称 `mv keycloak-4.5.0.Final keycloak`
4.  修改配置文件 `vim keycloak/standalone/configuration/standalone.xml`  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDM4MTEx_size_16_color_FFFFFF_t_70]
    
    **注意：`xml`中的`&`符号需要转义；这里的`UTF-8`必须大写，否则启动时抛异常**  
    ![在这里插入图片描述][2018110218212119.jpg]
    
        <datasource jndi-name="java:jboss/datasources/KeycloakDS" pool-name="KeycloakDS" enabled="true" use-java-context="true">
        	<connection-url>jdbc:mysql://10.8.12.113:3306/keycloak?autoReconnect=true&useUnicode=true&createDatabaseIfNotExist=true&characterEncoding=UTF-8</connection-url>
        	<driver>mysql</driver>
        	<security>
        		<user-name>root</user-name>
        		<password>root</password>
        	</security>
        </datasource>
        <drivers>
        <driver name="mysql" module="com.mysql">
        	<xa-datasource-class>com.mysql.jdbc.jdbc2.optional.MysqlXADataSource</xa-datasource-class>
        </driver>
5.  修改`keycloak`启动时的数据库更新模式，下面的代码在`standalone.xml`存在，只需要修改`migrationStrategy`属性的`value`值，官网的解释如下，我们使用`manual`模式，因为keycloak在启动时会创建90多张表，耗时很长，可能导致`jboss`启动超时，并且还会有其他问题。`manual`模式会创建一部分表，随后导出`keycloak-database-update.sql`在`keycloak`的解压目录，我们需要手动执行这个`sql`文件。  
    官网文档：[https://www.keycloak.org/docs/latest/server\_installation/index.html\#database][https_www.keycloak.org_docs_latest_server_installation_index.html_database]
    
    ![在这里插入图片描述][20181102175643174.jpg]
    
        <spi name="connectionsJpa">
            <provider name="default" enabled="true">
                <properties>
                    <property name="dataSource" value="java:jboss/datasources/KeycloakDS"/>
                    <property name="initializeEmpty" value="true"/>
                    <property name="migrationStrategy" value="manual"/>
                    <property name="migrationExport" value="${jboss.home.dir}/keycloak-database-update.sql"/>
                </properties>
            </provider>
        </spi>
6.  在第4步，我们使用了`mysql`，因此需要配置`mysql`的`module`，并引入`mysql`的驱动包
    
        mkdir -p keycloak/modules/system/layers/base/com/mysql/main/
        touch module.xml
    
    `module.xml`内容
    
        <?xml version="1.0" encoding="UTF-8"?>
        <module xmlns="urn:jboss:module:1.3" name="com.mysql">
            <resources>
                <resource-root path="mysql-connector-java-5.1.40.jar"/>
            </resources>
            <dependencies>
                <module name="javax.api"/>
            </dependencies>
        </module>
    
    ![在这里插入图片描述][20181102181145978.jpg]
7.  初始化`keycloak`管理员用户
    
        keycloak/bin/add-user-keycloak.sh -r master -u admin -p admin
8.  创建数据库
    
        CREATE database keycloak DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci ;
9.  启动`keycloak`，此过程会耗时很久，可能`jboss`会超时。在第5步，会生成`keycloak-database-update.sql`，我们使用`mysql -uroot -proot --force keycloak < C:\Users\yangzhen\Desktop\keycloak-database-update.sql`执行`SQL`，如果直接粘贴到`mysql`执行，会有`Error`
    
        keycloak/bin/standalone.sh
10. 再次启动，并访问 [http://192.168.1.11:8080/auth/][http_192.168.1.11_8080_auth] ，点击`Administration Console`， 使用第7步创建的管理员账号登录  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDM4MTEx_size_16_color_FFFFFF_t_70 1]  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDM4MTEx_size_16_color_FFFFFF_t_70 2]

[keycloak]: https://www.keycloak.org/downloads.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDM4MTEx_size_16_color_FFFFFF_t_70]: /images/20220422/5087222d0a9c4dc5ab23ca661ac5d0e9.png
[2018110218212119.jpg]: /images/20220422/db31d7bcce0740ceabbde5aa3ab3792f.png
[https_www.keycloak.org_docs_latest_server_installation_index.html_database]: https://www.keycloak.org/docs/latest/server_installation/index.html#database
[20181102175643174.jpg]: /images/20220422/ee51692f622f4c46a135250f09f6c091.png
[20181102181145978.jpg]: /images/20220422/54c541dc22ed4bb9b6b3e457581d6e69.png
[http_192.168.1.11_8080_auth]: http://192.168.1.11:8080/auth/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDM4MTEx_size_16_color_FFFFFF_t_70 1]: /images/20220422/9bf56865999445ceaedcfe802cdbf578.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDM4MTEx_size_16_color_FFFFFF_t_70 2]: /images/20220422/183acbf881e34ebb8889b4913e71ecb9.png