跳转到内容
Docs

使用 GitHub 登录

适用于Alpha

GitHub 登录使用 OAuth App。OpenRUM 使用 GitHub 稳定的数字用户 ID 识别账号,并要求主邮箱已验证。修改 GitHub 用户名不会改变已绑定的身份。

开始前,请使用规范 HTTPS PUBLIC_BASE_URL 部署 OpenRUM,以 Instance Owner 身份登录,并启用密钥加密托管。

  1. 在 GitHub OAuth App 设置注册新应用。Homepage URL 填写 OpenRUM 的访问域名;默认提供者 ID 为 github,Authorization callback URL 填写以下精确地址:

    https://rum.example.com/api/v1/auth/providers/github/callback

    将域名替换为 PUBLIC_BASE_URL 的域名;使用其他提供者 ID 时还要替换路径中的 github。复制 Client ID 并创建 Client Secret。OpenRUM 请求 read:user 和 user:email 范围;测试账号须在 GitHub 设置已验证的主邮箱。

  2. 打开系统设置 → 认证与访问,选择 GitHub 卡片,填写提供者 ID、显示名称、Client ID 和 Client Secret。先不要勾选启用并在登录页展示,保存时输入 Owner 的 OpenRUM 密码,然后点击测试连接并授权 GitHub 应用。测试完成后会返回设置页,不会创建用户账号。

  3. 勾选启用并在登录页展示并保存。在独立浏览器会话的登录页选择使用 GitHub 登录。新外部账号须由组织管理员授予访问权限;已有账号应先到 Account 连接 GitHub,再使用该按钮登录。

GitHub 的 OAuth App 创建指南说明了注册和回调设置。

Release Alpha · commit local