业务中台之认证授权服务
版本 | 作者 | 日期 | 备注
请使用 应用商店 部署
请使用 应用商店 部署
请使用 应用商店 部署
数据文件目录：/var/lib/mysql
安装完成后，调整 mysql 服务的配置参数
查看当前配置：show variables;
最大连接数 max_connections 操作日志的保留时长 binlog_expire_logs_seconds
参考命令：
set global max_connections = 1000; set persist max_connections = 1000; // 7天 86400 * 7 // 1天 86400 set global binlog_expire_logs_seconds = 86400 * 7; set persist binlog_expire_logs_seconds = 86400 * 7;
时区设置
确保MySQL 的时区设置为 GMT+8
创建数据库帐号
参考命令：
create user 'user'@'%' identified with mysql_native_password by 'your_password';
创建 database
参考命令：
create database `user` DEFAULT CHARSET utf8 COLLATE utf8_general_ci;
授予权限
将 database 的权限授予对应的帐号
参考命令：
grant all privileges on `user`.* to 'user'@'%' with grant option;
授予 SUPER 权限 由于 部分帐号 需要创建 触发器，故，需要 SUPER 权限 涉及帐号有 user、user_authz、cas_server
参考命令：
grant SUPER on *.* to 'user'@'%'; grant SUPER on *.* to 'user_authz'@'%'; grant SUPER on *.* to 'cas_server'@'%'; grant SUPER on *.* to 'tmp_data'@'%';
备份与还原
参考命令： 备份：
mysqldump -u root -p cas_server > cas_server.sql mysqldump -u root -p token_server > token_server.sql mysqldump -u root -p user > user.sql mysqldump -u root -p user_authz > user_authz.sql mysqldump -u root -p authx_log > authx_log.sql mysqldump -u root -p agent_service > agent_service.sql
还原：
mysql -u root -p cas_server < cas_server.sql mysql -u root -p token_server < token_server.sql mysql -u root -p user < user.sql mysql -u root -p user_authz < user_authz.sql mysql -u root -p authx_log < authx_log.sql mysql -u root -p agent_service < agent_service.sql
创建 devops 帐号
用于 rancher 部署时拉取镜像
用户管理 下 创建用户 如 devops
镜像同步
从 https://harbor.supwisdom.com 中同步镜像（须申请 harbor 帐号）
仓库管理 下 新建目标
supwisdom https://harbor.supwisdom.com rancher.devops / PWMgP85qiLFC
同步管理 下 新建规则
admin-portal admin-portal/* authx-service authx-service/* authx-log authx-log/* thirdparty-agent-service thirdparty-agent-service/* user-data-service goa/* user-authorization-service user-authorization-service/* cas-server cas-server/* token-server token-server/* attest-server attest-server/* jobs-server jobs-server/* personal-security-center personal-security-center/*
同步规则，创建完成后，进行镜像同步
选择某个同步规则，点击 同步，等待任务完成
授予 devops 帐号 对各个项目的 访客 权限
项目 下，点击 项目名称，进入到 成员，添加用户，查找用户 devops，选择角色 访客，确定，添加即可
创建项目
进入 全局 - 集群（具体名称视项目安装而定） - 项目/命名空间，添加项目
输入 项目名称，保存
创建命名空间
进入 全局 - 集群（具体名称视项目安装而定） - 项目/命名空间
在新建的项目中，添加命名空间
输入 名称，保存
导入YAML
进入 全局 - 集群（具体名称视项目安装而定） - 项目（某个项目）
进入 资源 - 工作负载
确定域名
首先明确是否使用泛域名，如：*.paas.xxx.edu.cn，或 直接使用学校域名 xxx.edu.cn
本产品安装需要的域名如下：
cas.paas.xxx.edu.cn 认证（视具体情况，可调整；包括，CAS 认证、Token 认证、身份验证服务） token.paas.xxx.edu.cn （废弃，合并至 cas）认证（APP适用） personal-security-center.paas.xxx.edu.cn （废弃，合并至 authx-service）个人安全中心后端API security-center.paas.xxx.edu.cn （废弃，合并至 authx-service）安全中心前端UI（帐号激活、忘记密码） authx-service.paas.xxx.edu.cn 用户授权服务（包括，用户认证授权管理前端UI、安全中心前端UI、安全中心后端API） authx-minio.paas.xxx.edu.cn 文件服务
如果使用 学校域名，则去除 .paas 即可，同时申请开通相关域名
JVM 相关
ConfigMap，jvm-env
key | 说明 | 配置示例
数据库连接配置相关
Secret，datasource-env-secret
key | 说明 | 配置示例
redis 连接配置相关
Secret，redis-env-secret
key | 说明 | 配置示例
rabbit mq 连接配置相关
Secret，rabbitmq-env-secret
key | 说明 | 配置示例
注： 外部访问地址，一般为域名地址，需要根据学校域名进行修改 k8s集群内部地址，为集群内部，跨namespace访问的域名地址，一般无须修改
auth-service 下的 authx-service-minio
Secret，minio-env-secret
key | 说明 | 配置示例
auth-service 下的 authx-service-bff
ConfigMap，authx-service-bff-env
key | 说明 | 配置示例
thirdparty-agent-service 下的 thirdparty-agent-service
ConfigMap，agent-service-env
key | 说明 | 配置示例
Secret，agent-service-env-secret
key | 说明 | 配置示例
user-data-service 下的 user-data-service-poa
ConfigMap，user-data-service-poa-env
key | 说明 | 配置示例
user-data-service 下的 user-data-service-goa
ConfigMap，user-data-service-goa-env
key | 说明 | 配置示例
user-data-service 下的 user-data-service-biz
ConfigMap，user-data-service-biz-env
key | 说明 | 配置示例
user-authorization-service 下的 user-authorization-service-poa
ConfigMap，user-authorization-service-poa-env
key | 说明 | 配置示例
user-authorization-service 下的 user-authorization-service-sa
ConfigMap，user-authorization-service-sa-env
key | 说明 | 配置示例
cas-server 下的 cas-server-sa-api
ConfigMap，cas-server-sa-api-env
key | 说明 | 配置示例
cas-server 下的 cas-server-security-engine
ConfigMap，cas-server-security-engine-env
key | 说明 | 配置示例
cas-server 下的 cas-server-site-webapp
ConfigMap，cas-server-site-webapp-env
key | 说明 | 配置示例
(@<rhnPaUYKC_k770*DuWwYQ_#Zc#8c(2rB?kae)rN)>K7qy)awCjxp$L653Mf$2 SPRING_THYMELEAF_PREFIX | 登录页面UI的代码目录 | classpath:/templates/themes/classic/cas-server 下的 cas-server-site-scheme
ConfigMap，cas-server-site-scheme-config
key | 说明 | 配置示例
注：若配置了 CASSERVER_SA_API_SERVER_URL，则使用配置表中的配置；否则，使用 SCHEME_COLOR 指定的设置。
token-server 下的 token-server
ConfigMap，token-server-env
key | 说明 | 配置示例
personal-security-center 下的 personal-security-center-bff
ConfigMap，personal-security-center-bff-env
key | 说明 | 配置示例
ConfigMap，personal-security-center-bff-template-env 邮件内容模板、短信内容模板
key | 说明 | 配置示例
personal-security-center 下的 personal-security-center-zuul
ConfigMap，personal-security-center-zuul-env
key | 说明 | 配置示例
personal-security-center 下的 security-center-ui
ConfigMap，security-center-ui-env
key | 说明 | 配置示例
(@<rhnPaUYKC_k770*DuWwYQ_#Zc#8c(2rB?kae)rN)>K7qy)awCjxp$L653Mf$2注： AUTH_TYPE 为 cas 时，配置 AUTH_CAS、JWT_ISS、JWT_SECRET AUTH_TYPE 为 uniauth 时，配置 UNIAUTH_IDTOKEN、UNIAUTH_IDTOKEN_ISS、UNIAUTH_CLIENT_ID
attest-server 下的 attest-server
ConfigMap，attest-server-env
key | 说明 | 配置示例
authx-log 下的 authx-log-sa
ConfigMap，authx-log-sa-env
key | 说明 | 配置示例
数据库帐号
以下是 各服务对应的数据库帐号
服务 | 数据库帐号
命令： 请修改命令中的 your_password 为实际的数据库帐号的密码
create user 'user'@'%' identified with mysql_native_password by 'your_password'; create user 'user_authz'@'%' identified with mysql_native_password by 'your_password'; create user 'authx_log'@'%' identified with mysql_native_password by 'your_password'; create user 'cas_server'@'%' identified with mysql_native_password by 'your_password'; create user 'token_server'@'%' identified with mysql_native_password by 'your_password'; create user 'agent_service'@'%' identified with mysql_native_password by 'your_password'; create user 'tmp_data'@'%' identified with mysql_native_password by 'your_password';
数据库
以下是 各服务对应的数据库
服务 | 数据库
命令：
create database `user` DEFAULT CHARSET utf8 COLLATE utf8_general_ci; create database `user_authz` DEFAULT CHARSET utf8 COLLATE utf8_general_ci; create database `authx_log` DEFAULT CHARSET utf8 COLLATE utf8_general_ci; create database `cas_server` DEFAULT CHARSET utf8 COLLATE utf8_general_ci; create database `token_server` DEFAULT CHARSET utf8 COLLATE utf8_general_ci; create database `agent_service` DEFAULT CHARSET utf8 COLLATE utf8_general_ci; create database `tmp_data` DEFAULT CHARSET utf8 COLLATE utf8_general_ci;
数据库权限授予
将 database 的权限授予对应的帐号
命令：
grant all privileges on `user`.* to 'user'@'%' with grant option; grant all privileges on `user_authz`.* to 'user_authz'@'%' with grant option; grant all privileges on `authx_log`.* to 'authx_log'@'%' with grant option; grant all privileges on `cas_server`.* to 'cas_server'@'%' with grant option; grant all privileges on `token_server`.* to 'token_server'@'%' with grant option; grant all privileges on `agent_service`.* to 'agent_service'@'%' with grant option; grant all privileges on `tmp_data`.* to 'tmp_data'@'%' with grant option;
SUPER 权限授予
由于 部分帐号 需要创建 触发器，故，需要 SUPER 权限 涉及帐号有 user、user_authz、cas_server
命令：
grant SUPER on *.* to 'user'@'%'; grant SUPER on *.* to 'user_authz'@'%'; grant SUPER on *.* to 'cas_server'@'%'; grant SUPER on *.* to 'tmp_data'@'%';
用户数据的交换帐号
待部署完成后操作
如果，存在数据交换 须将组织机构数据、帐号数据 同步到用户服务的数据库的 则，需要创建一个 交换用的数据库帐号（user_trans），并为该帐号授予 表 user.TMP_ORGANIZATION_ORIGIN、user.TMP_ACCOUNT_ORIGIN 的读写操作的权限
命令：
create user 'user_trans'@'%' identified with mysql_native_password by 'your_password'; grant select on `user`.`TMP_ORGANIZATION_ORIGIN` to 'user_trans'@'%'; grant insert on `user`.`TMP_ORGANIZATION_ORIGIN` to 'user_trans'@'%'; grant update on `user`.`TMP_ORGANIZATION_ORIGIN` to 'user_trans'@'%'; grant delete on `user`.`TMP_ORGANIZATION_ORIGIN` to 'user_trans'@'%'; grant select on `user`.`TMP_ACCOUNT_ORIGIN` to 'user_trans'@'%'; grant insert on `user`.`TMP_ACCOUNT_ORIGIN` to 'user_trans'@'%'; grant update on `user`.`TMP_ACCOUNT_ORIGIN` to 'user_trans'@'%'; grant delete on `user`.`TMP_ACCOUNT_ORIGIN` to 'user_trans'@'%'; grant select on `user`.`TMP_ORGANIZATION_TRANS` to 'user_trans'@'%'; grant insert on `user`.`TMP_ORGANIZATION_TRANS` to 'user_trans'@'%'; grant update on `user`.`TMP_ORGANIZATION_TRANS` to 'user_trans'@'%'; grant delete on `user`.`TMP_ORGANIZATION_TRANS` to 'user_trans'@'%'; grant select on `user`.`TMP_ACCOUNT_TRANS` to 'user_trans'@'%'; grant insert on `user`.`TMP_ACCOUNT_TRANS` to 'user_trans'@'%'; grant update on `user`.`TMP_ACCOUNT_TRANS` to 'user_trans'@'%'; grant delete on `user`.`TMP_ACCOUNT_TRANS` to 'user_trans'@'%';
修改 yaml 中的相关配置
具体参考 yaml 文件中的说明
0.infras
基础设施，目前包含 MySQL数据库的Web管理端、SpringBoot服务的管理端
0.0.0.infras-base.yaml 请修改 harbor-registry 的帐号密码 0.0.1.infras-mysql.yaml 请修改 MySQL数据库 的地址、IP，mysql-adminer 访问域名 0.0.2.infras-sba.yaml 请修改 docker 镜像地址
1.authx-service
业务中台 之 认证授权服务
参考 yaml 中的说明，修改相关配置
在各个服务的安装脚本目录下，修改以下文件（若存在）中的配置
0.*-base.yaml 请修改 harbor-registry 的帐号密码
4.x.*.yaml, 5.*-datax-job.yaml 请修改 docker 镜像地址
1.*-env.yaml, 5.*-datax-job.yaml 请修改 数据库密码
2.*-ingresses.yaml 请修改 访问域名
0.0.trans-service-v4
此为 认证v4 的数据迁移服务（可选）
将 认证v4 的数据导入到 tmp_data 下
数据迁移后，还需要手动编写脚本，将数据迁移至 用户服务、授权服务 的数据库中
0.authx-service
此为 公共基础服务
如：MySQL 服务地址（Endpoints）、文件存储服务
1.authx-service-mysql.yaml
请修改 mysql 的服务地址 IP
2.authx-service-minio.yaml
请修改 minio 的 `MINIO_ACCESS_KEY`、`MINIO_SECRET_KEY`
根据情况修改 pvc 的 storageClassName
9.poa-api-docs_install.yaml
用于将 认证授权服务的 poa 接口文档，导入到 poa-sa 中，**请在 poa 安装完成后处理**
请修改 poa 的服务地址 `POA_SERVER_URL`
1.thirdparty-agent-service
此为 第三方服务的代理服务
file-minio
修改 minio 的 `FILE_MINIO_ACCESSKEY`、`FILE_MINIO_SECRETKEY`
mail-smtp
获取 学校的 smtp 服务地址，邮箱帐号，用于发送邮件
sms-aliyun
如果 学校使用 阿里云的短信服务，提供 `ACCESS_KEY_ID`、`ACCESS_SECRET`；
否则，提供相关的短信平台，进行定制开发
2.user-data-service
此为 用户服务
user-data-service-goa
如果 须将用户数据的变更下发到 Openldap 等第三方业务中，则须配置 `JOBS_RABBITMQ_*` 为开启（ENABLED=true）
3.user-authorization-service
此为 授权服务
4.cas-server
此为 认证服务
cas-server-site-webapp
生成公私钥证书，参考 certs/jwt/readme.md 生成公私钥pem，修改相关配置 `CASSERVER_JWT_PRIVATE_KEY_PEM_PKCS8`、`CASSERVER_JWT_PUBLIC_KEY_PEM`
修改 认证服务的外网访问地址 `CAS_SERVER_NAME`
修改 CAT TGC 的安全，若 使用 https，则须修改 `CAS_TGC_SECURE: "true"`
修改 安全中心（帐号激活、找回密码）的链接地址 `CASSERVERSITE_FORGOT_PASSWORD_URL`、`CASSERVERSITE_ACTIVE_ACCOUNT_URL`
联合登录（QQ、微信、企业微信、支付宝等）配置 `CASSERVER_FEDERATION_*`
动态密码认证 相关配置
1. 短信模板（动态密码） `CASSERVERSITE_PASSWORDLESS_SMS_TEXT_TEMPLATE`
2. 短信接口地址 `TPAS_AGENT_SERVICE_SMS_SENDER_PATH`
如果 须与 超级APP 对接，须修改 Token 验签公钥地址 `SUPERAPP_TOKEN_SIGNING_KEY_URL`
如果 须开启图片验证码，修改 `CASSERVERSITE_CAPTCHA_ENABLED: "true"`
5.token-server
此为 认证服务（适用于APP，可选）
token-server
生成公私钥证书（与cas-server保持一致），参考 certs/jwt/readme.md 生成公私钥pem，修改相关配置 `TOKEN_SERVER_SECURITY_JWT_PRIVATE_KEY_PEM_PKCS8`、`TOKEN_SERVER_SECURITY_JWT_PUBLIC_KEY_PEM`
修改 认证服务的外网访问地址 `TOKEN_SERVER_PREFIX`
修改 认证服务 Id-Token 的签发者标识 `TOKEN_SERVER_SECURITY_JWT_ISS`
动态密码认证 相关配置（与cas-server保持一致）
1. 短信模板（动态密码） `TOKEN_SERVER_PASSWORDLESS_SMS_TEXT_TEMPLATE`
2. 短信接口地址 `TPAS_AGENT_SERVICE_SMS_SENDER_PATH`
人脸认证，须配置人脸服务，目前支持 新开普人脸服务、百度人脸服务，根据情况获取相关配置参数
APP 登录信息 个推，使用了消息服务的接口，该接口由 POA 提供，故须
1. 注册 POA client，获取 `clientId`、`clientSecret`，申请 Scope `messagecenter:v1:sendMessage`
2. 获取 消息服务的 `appId`
6.personal-security-center
此为 个人安全中心 后端API，安全中心 前端UI
提供个人帐号相关的操作的接口，以及 帐号激活、密码找回 等功能
TODO: 修改 bff、zuul 配置
TODO: 修改 security-center-ui 配置
7.attest-server
此为 身份验证服务
提供双因子、二次认证时，进行用户的身份验证，包括 APP推送验证、安全手机验证、安全邮箱验证、人脸识别验证 等能力
8.authx-log
此为 日志服务
收集 用户、认证、授权 的管理、使用过程中产生的 操作日志、登录日志；同时，提供日志查询、基于日志的统计功能
9.jobs-server
此为 任务调度服务
基于 定时任务、触发任务 等，完成 用户数据的同步
如：
* 源头数据进入到临时表后，写入用户的正式表
* 用户数据更新后，通过消息队列，增量更新 Openldap 数据
添加项目、命名空间
项目
infras # 基础设施（可选，方便实施工作） authx-service # 认证授权服务 admin-platform # 管理平台
命名空间
在项目 infras 下创建 命名空间：
base
在项目 authx-service 下创建 命名空间：
trans-service（认证v4的数据迁移服务，可选） authx-service thirdparty-agent-service user-data-service user-authorization-service cas-server token-server personal-security-center attest-server authx-log jobs-server
导入YAML
在项目 infras 中，将 0.infras 下的 yaml 按编号依次导入
0.0.0.infras-base.yaml 0.0.1.infras-mysql.yaml mysql web管理 0.0.2.infras-sba.yaml
在项目 authx-service 中，将 1.authx-service 下的 yaml 按编号依次导入
务必确保 4.0.*-installer.yaml 执行成功
数据脚本初始化
先修改 脚本中的域名（如果存在）
必须，1.authx0service/10.0.init.sql
包括， 安全中心的认证对接配置 云平台，管理接口的路由配置 云平台，管理功能的菜单配置
可选，1.authx-service/10.0.tmp.sql
若通过交换同步组织机构、帐号数据的，须执行该数据库脚本