介绍

为了你更好的使用MaxKey,本教程介绍在Windows中如何快速配置和使用MaxKey,在开始本文档前,请先下载MaxKey并解压到C:盘。

配置

hosts配置文件目录

C:\Windows\System32\drivers\etc

新增如下内容


127.0.0.1  sso.maxkey.top
127.0.0.1  tokenbased.demo.maxkey.top
127.0.0.1  cas.demo.maxkey.top
127.0.0.1  oauth.demo.maxkey.top

应用服务启动

1)启动数据库


start_maxkey_db.bat

2)启动认证服务


start_maxkey.bat

3)启动管理服务


start_maxkey_mgt.bat

4)启动样例及WIKI


start_maxkey_wiki.bat

访问

打开浏览器,访问以下地址

序号名称访问地址
1认证平台https://sso.maxkey.top/maxkey/login
2管理平台http://sso.maxkey.top:9527/maxkey-mgt/login
3集成指南http://sso.maxkey.top:9521/wiki
4监控平台http://sso.maxkey.top:9528/login
5认证平台接口文档https://sso.maxkey.top/maxkey/doc.html
6账户密码admin/maxkey
7监控账户密码monitor/maxkey

目录结构

序号目录/文件备注
1MaxKey单点登陆认证系统介绍-CE-***.pdf系统介绍
2getting-started.html快速使用文档
3LICENSE许可证
4NOTICE许可证NOTICE
5jdk/jre运行时JDK
6lib公共包
7maxkey认证服务
8maxkey_mgt管理服务
9maxkey_monitor监控平台
10mysql_***MySQL数据库
11maxkey_wikiWIKI和样例
12start_maxkey.bat启动认证服务器
13start_maxkey_mgt.bat启动管理服务器
14start_maxkey_db.bat启动数据库
15start_maxkey_monitor.bat启动监控服务器
16start_maxkey_wiki.bat启动WIKI和样例
17set_maxkey_env.bat环境设置脚本

LINUX 7 版本

1 OracleJDK 17 安装

1.1 下载地址 https://www.oracle.com/java/technologies/downloads/#JDK17

Java SE Development Kit 17

x64 RPM Package
	
wget --no-check-certificate --no-cookies wget https://download.oracle.com/java/17/latest/jdk-17_linux-x64_bin.rpm

1.2 解压缩及安装


rpm -Uvh jdk-17_linux-x64_bin.rpm

2.1 安装MySQL 8.0

2.1.1 安装MySQL官方的yum repository


wget -i -c https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm
 

2.1.2 下载rpm包:


yum -y install mysql80-community-release-el7-3.noarch.rpm
 

2.1.3 安装MySQL服务


yum -y install mysql-community-server
 

2.2 调整配置

编辑 /etc/my.cnf 文件


character-set-server=utf8
lower_case_table_names=1

2.3. 启动mysql服务

> systemctl start mysqld


停止

systemctl stop mysqld  --无需执行

2.4 登录MySQL

第一次启动MySQL后,就会有临时密码,这个默认的初始密码在/var/log/mysqld.log文件中,我们可以用这个命令来查看:


 grep "password" /var/log/mysqld.log
 

2.5 设置访问权限及密码


mysql -u root -p;

输入密码

set global validate_password.policy=0; --改变密码等级

set global validate_password.length=4; --改变密码最小长度

SET PASSWORD = 'maxkey';

use mysql;

alter user 'root'@'localhost' identified with mysql_native_password by 'maxkey';

flush privileges ;

---修改root用户的访问权限为‘%’

update user set host='%' where user='root';

flush privileges ;

2.7. 设置开机启动


chkconfig --add mysqld
chkconfig mysqld on

查看开机启动设置是否成功


 chkconfig --list | grep mysql*
 
 # mysqld 0:关闭 1:关闭 2:启用 3:启用 4:启用 5:启用 6:关闭停止

3 MaxKey安装

3.1 把MaxKey上传到Linux服务器

3.2 数据导入

MaxKey对应的版本SQL文件,参见

https://gitee.com/dromara/MaxKey/tree/master/sql

登陆LINUX MYSQL并创建schema maxkey,字符集utf8,数据文件导入到maxkey schema中,


mysql -u root -p;

输入密码

CREATE DATABASE  IF NOT EXISTS `maxkey` /*!40100 DEFAULT CHARACTER SET utf8 */ /*!80016 DEFAULT ENCRYPTION='N' */;

USE `maxkey`;

-- 使用source命令,后面参数为脚本文件(如这里用到的.sql),其中v2.9.0是对应的版本号

source your sql path/maxkey_v3.0.0.GA.sql;

source your sql path/maxkey_v3.0.0.GA_data.sql

3.3 启动 修改set_maxkey_env.sh以下参数


JAVA_HOME=/usr/java/jdk-17

export JAVA_HOME=/usr/java/jdk-17

  ./start_maxkey_db.sh & #自行编写
  
  ./start_maxkey.sh &
  
  ./start_maxkey_mgt.sh &
  
  ./start_maxkey_wiki.sh &

Docker快速部署

LINUX 7 基于Docker快速部署

1、创建MySQL数据文件和日志文件目录


mkdir /root/mysql/data

mkdir /root/mysql/logs

2、把 https://gitee.com/dromara/MaxKey/tree/master/docker 或者https://github.com/dromara/MaxKey/tree/master/docker目录上传到/root目录下

3、启动MySQL服务


docker pull mysql:8.0.27

docker 	run -p 3306:3306  \
-v /root/mysql/data:/var/lib/mysql \
-v /root/mysql/logs:/var/log/mysql \
-v /root/docker-mysql:/etc/mysql/conf.d \
-v /root/docker-mysql/sql:/docker-entrypoint-initdb.d \
--name mysql \
-e MYSQL_ROOT_PASSWORD=maxkey \
-d mysql:8.0.27

4、启动MaxKey服务


docker pull maxkeytop/maxkey:latest

docker 	run -p 443:443  \
-e DATABASE_HOST=192.168.0.102 \
-e DATABASE_PORT=3306 \
-e DATABASE_NAME=maxkey \
-e DATABASE_USER=root \
-e DATABASE_PWD=maxkey \
--name maxkey \
-d maxkeytop/maxkey:latest

5、启动MaxKey管理服务


maxkeytop/maxkey-mgt:latest

docker 	run -p 9527:9527  \
-e DATABASE_HOST=192.168.0.102 \
-e DATABASE_PORT=3306 \
-e DATABASE_NAME=maxkey \
-e DATABASE_USER=root \
-e DATABASE_PWD=maxkey \
--name maxkey-mgt \
-d maxkeytop/maxkey-mgt:latest

Docker Compose快速部署

LINUX 7 基于Docker Compose快速部署

1、创建MySQL数据文件和日志文件目录


mkdir /root/mysql/data

mkdir /root/mysql/logs

2、启动MaxKey服务


docker-compose up --build -d