本指南介绍如何通过在 Google 云控制台配置 OAuth2 凭据,为您的 Discourse 站点设置 Google 登录集成。
所需用户级别: 管理员
概述
Google 登录允许用户使用自己的 Google 账户登录 Discourse 网站。本指南将指导您:
- 创建 Google 云项目
- 设置 OAuth
- 配置凭证
- 在 Discourse 中启用 Google 登录
创建 Google 云项目
- 导航至 https://console.developers.google.com
- 单击左上角的 “选择项目”
如果在创建项目后发现任何错误,请使用 Ctrl+F5 刷新页面。
配置 OAuth
-
选择项目
-
导航至左侧面板中的 “OAuth”
-
选择 “外部 ”并点击 "创建
-
填写申请详情:
- 输入您的应用名称
- 在授权域中添加您的域名
- 配置用户支持邮箱
- 添加开发者联系信息
自2021年9月13日起,谷歌要求所有OAuth实现必须使用HTTPS。
设置 OAuth凭据
-
前往“Google Auth Platform”选项卡
-
点击“开始”并选择“OAuth 客户端 ID”
-
配置 OAuth 客户端:
- 选择“Web 应用程序”作为应用类型
- 在授权的 JavaScript 来源中添加您网站的基本 URL(包括
https://
) - 在授权的重定向 URI 中添加您的回调 URL:
https://your-discourse-site.com/auth/google_oauth2/callback
- 点击“创建”
- 保存提供的客户端 ID 和客户端密钥
配置 Discourse 设置
- 在您的 Discourse 管理设置中:
- 启用设置
enable google oauth2 logins
- 输入您的
google oauth2 client id
- 输入您的
google oauth2 client secret
验证和发布
- 在“测试”状态下,通过添加 Google 用户测试集成
- 要使集成公开可用:
- 将状态更改为“生产中”
- 完成 Google 的验证过程
- 通过 Google Search Console 验证网站所有权
最后效果展示
其他配置
google 登录
要限制登录到特定的 google workspac 域:
- 启用
google oauth2 hd
站点设置 - 输入您的 google workspace 域
故障排除
如果遇到登录问题:
- 验证 HTTPS 是否正确配置
- 仔细检查所有重定向 URI
- 确保您网站的 SSL 证书有效
- 确认已启用所有必需的 Google Cloud API