介绍
为了你更好的使用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)启动样例
start_maxkey_wiki.bat
访问
打开浏览器，访问以下地址
| 序号 | 名称 | 访问地址 |
|---|---|---|
| 1 | 认证平台 | https://sso.maxkey.top/maxkey/login |
| 2 | 管理平台 | http://sso.maxkey.top:9527/maxkey-mgt/login |
| 3 | 集成指南 | https://doc.maxkey.top/#/ |
| 4 | 监控平台 | http://sso.maxkey.top:9528/login |
| 5 | 认证平台接口文档 | https://sso.maxkey.top/maxkey/doc.html |
| 6 | 账户密码 | admin/maxkey |
| 7 | 监控账户密码 | monitor/maxkey |
目录结构
| 序号 | 目录/文件 | 备注 |
|---|---|---|
| 1 | MaxKey单点登陆认证系统介绍-CE-***.pdf | 系统介绍 |
| 2 | getting-started.html | 快速使用文档 |
| 3 | LICENSE | 许可证 |
| 4 | NOTICE | 许可证NOTICE |
| 5 | jdk/jre | 运行时JDK |
| 6 | lib | 公共包 |
| 7 | maxkey | 认证服务 |
| 8 | maxkey_mgt | 管理服务 |
| 9 | maxkey_monitor | 监控平台 |
| 10 | mysql_*** | MySQL数据库 |
| 11 | maxkey_wiki | 样例 |
| 12 | start_maxkey.bat | 启动认证服务器 |
| 13 | start_maxkey_mgt.bat | 启动管理服务器 |
| 14 | start_maxkey_db.bat | 启动数据库 |
| 15 | start_maxkey_monitor.bat | 启动监控服务器 |
| 16 | start_maxkey_wiki.bat | 启动样例 |
| 17 | set_maxkey_env.bat | 环境设置脚本 |
LINUX 7 版本
1 JDK 安装
| 推荐 | 版本 | 更新至 | 地址 |
|---|---|---|---|
| Oracle JDK 8 | December 2030 | 访问 | |
| Eclipse Temurin 8 | December 2030 | 访问 | |
| OracleJDK 17 | October 2029 | 访问 | |
| Eclipse Temurin 17 | October 2029 | 访问 |
1.1 下载地址
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快速部署
Rainbond应用商店快速安装
Rainbond快速安装，Rainbond 是云原生且易用的云原生应用管理平台。