labshare/auth-mysql

LabShare Auth

概述

LabShare Auth是LabShare应用的授权和联合服务，允许应用通过Passport策略使用来自各种认证提供商的授权服务。该服务支持OAuth授权流程中的隐式授权和授权码授权，同时支持SharePoint托管应用的基本认证流程。有关授权流程的更多信息，请查看文档。

核心功能与特性

• 支持多种Passport认证策略
• 实现OAuth 2.0标准授权流程（隐式授权、授权码授权）
• 提供SharePoint托管应用的基本认证支持
• 兼容MySQL（≥5.7.0）和MSSQL数据库
• 支持开发环境下的文件监控与自动重载

使用场景与适用范围

适用于需要集成多种认证提供商的LabShare应用，特别适合需要联合授权机制的企业级应用，可作为集中式授权服务为多个LabShare应用提供统一的身份验证与授权管理。

环境要求

• NodeJS
• https://github.com/LabShare/lsc
• MySQL (≥5.7.0) 或 MSSQL

安装与使用方法

非Docker方式安装

1. 使用MySQL或MSSQL创建本地数据库
   • 进入https://github.com/LabShare/auth/tree/master/schema
   • 对于MySQL服务器，使用https://github.com/LabShare/auth/tree/master/run/mysql/schema.sql
   • 对于MSSQL服务器，使用https://github.com/LabShare/auth/tree/master/run/mssql/schema.sql
2. 在auth项目根目录运行npm install
3. 复制sample-config.json并更名为config.json
4. 配置设置

Docker方式安装

详见https://github.com/LabShare/auth/tree/master/docs/docker-deployment.md

运行Auth HTTP服务

bash
lsc auth start

开发环境下带自动重载运行

如需在开发环境中运行Auth服务并启用文件监控与自动重载，请参考https://github.com/LabShare/services/blob/master/docs/run-package.md

客户端应用连接Auth服务的配置

在Shell配置中指定shell.Auth.Url，示例：

json
{
  "shell": {
      "Auth": {
        "Url": "http://localhost:7000/_api"
      }
   }
}

配置说明

更多配置详情请参考配置文档

测试

单元测试

bash
npm test

集成测试

bash
export MYSQL_PORT=3307
docker-compose -f docker-compose-test.yml up -d
npm run build
lsc auth test

运行部分集成测试

bash
lsc auth test <path>

其中<path>是集成测试模块的相对路径，例如：lsc auth test api/clients_spec.js

可选MSSQL测试配置

bash
export MSSQL_SA_PASSWORD='IntTest!Passw0rd'
docker build -t labshare/mssql_auth_db ./run/mssql
docker run --rm -p 1433:1433 -e SA_PASSWORD=${MSSQL_SA_PASSWORD} --name mssql_auth_db labshare/mssql_auth_db
# 等待MSSQL容器初始化（10-20秒）
docker exec -it mssql_auth_db /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P ${MSSQL_SA_PASSWORD} -l 30 -d master -i /tmp/schema.sql

更新数据库驱动

bash
docker-compose -f docker-compose-test.yml down --rmi all
docker-compose -f docker-compose-test.yml up -d