内容介绍

「用户授权登录服务端」为站点提供标准的 OAuth 2.0 授权登录服务：第三方应用把用户引导到本站完成登录，本站回传一次性授权码，第三方用授权码换取令牌后即可读取用户基础信息。模块内置授权跳转、授权成功回调、令牌换取与用户信息四个接口，覆盖自研工具、合作站点与开放 API 的接入场景。

产品介绍

• 标准 OAuth 2.0 授权流程开箱可用：授权跳转 → 用户登录 → 回调携带授权码 → 换取令牌 → 读取用户信息，接入方按文档对接即可。
• 登录直接复用站点会员体系，用户名密码、扫码、微信、QQ 等登录方式全部沿用，无需另建账号体系。
• 安全加固：授权码一次性消费且 5 分钟有效（重复换取会被拒绝），换取登录态后自动更换会话 ID，避免授权码重放与会话固定风险。
• 令牌读取用户信息统一使用 api-token 请求头，第三方服务端只需保存令牌即可，不改动宿主站点逻辑。
• 授权应用按 clientId 注册、按回调地址校验，后台可维护授权应用列表。
• 兼容最新运行环境（Laravel 13 / PHP 8.5），并附带模块集成说明文档（README），其他系统接入前先读该文档。

模块介绍

「用户授权登录服务端」是一个提供基于Oauth2.0的用户授权登录功能

功能特性

• 提供基于Oauth2.0的用户授权登录功能

用户授权登录服务端
    授权流程
        授权跳转
        用户登录
        回调携带授权码
        换取令牌
        读取用户信息
    安全机制
        授权码一次性消费
        授权码 5 分钟有效
        换取后更换会话 ID
        会话固定防护
    接入方式
        网页授权跳转
        服务端换取令牌
        api-token 请求头读取用户信息
    后台管理
        授权应用管理
        CLI 接口

授权登录过程

• ① 跳转登录：跳转到网页 https://modstart.com/oauth/authorize?client_id=mstool&redirect_uri=https://example.com/callback
• ② 用户登录：用户在 https://modstart.com 网站完成用户名/密码、扫码、微信授权、QQ授权等方式的登录
• ③ 成功跳转：用户登录成功后，会跳转到 https://example.com/callback?code=xxx ，该链接为第一步的 callback 参数
• ④ 获取用户token：使用回调传回的 code 参数和 secret 参数，向 https://modstart.com/oauth/access_token?code=xxx&secret=xxx 发起请求，获取用户 token
• 请求 GET https://modstart.com/oauth/access_token?code=xxx&secret=xxx 返回 {code:0,msg:'ok',data:{token:'xxx'}}
• ⑤ 获取用户信息：后续的所有操作接口都需要在请求头添加授权信息 api-token: xxxx
• 获取用户信息：GET https://modstart.com/oauth/user_info 返回 {code:0,msg:'ok',data:{id:1,username:'xx',avatar:'xxx'}}

使用场景

• OAuth2.0授权登录服务端
• 第三方授权登录接入
• 开放API授权认证

模块入口

• /oauth/authorize 授权登录
• /oauth/authorize/success 授权成功
• /oauth/access_token 获取令牌
• /oauth/user_info 获取用户信息

后台菜单

• 用户会员
• 用户会员 → 用户授权登录服务端
• 用户会员 → 用户授权登录服务端 → 授权应用列表
• 用户会员 → 用户授权登录服务端 → 授权应用分类
• 用户会员 → 用户授权登录服务端 → 服务端设置