本页尚未翻译,当前显示英文版本。
SSO & Auth
SSO & Auth 决定 Player 可以通过哪些提供方登录。 每个提供方是一张卡片:填入从提供方开发者控制台获取的凭据,测试后开启该提供方。在 Players → SSO & Auth 中打开它。提供方及其凭据作用于整个 Project 的所有 Environment;只有失败和被拒绝的登录列表会随顶栏所选的 Environment 变化。
页头统计已启用的提供方数量,分母为全部六张卡片,包括两个即将推出的提供方。
提供方
| 提供方 | Player 的登录方式 | 状态 |
|---|---|---|
| Google 账号,基于 OAuth 2.0 | 可用 | |
| Facebook 或 Meta 账号,基于 OAuth 2.0 | 可用 | |
| Apple | Sign in with Apple。根据 App Store 审核指南 4.8,提供其他任何社交登录的 iOS 应用也必须提供它。 | 可用 |
| Epic | Epic Games 账号,通过 Epic Online Services。如果你在 Epic Games Store 上发行或面向 Epic 账号用户,值得启用。 | 可用 |
| PlayServ Webhook | 由你自己的认证服务器调用 PlayServ:适用于已有自己登录系统的 游戏。 | 即将推出 |
| PlayServ Auth Token | SDK 传入一个由你在服务器上签名的 token:适用于自行签发 JWT 的游戏。 | 即将推出 |
平台和 SDK 已支持 Steam 登录,但目前还不能在 Backoffice 中配置。
配置提供方
所有提供方的配置流程都一样:从提供方控制台获取凭据,把卡片上的 Redirect URI 填回该控制台,然后依次 Save、Test connection 并打开开关。保存之前,卡片会显示 unsaved changes。
在 Google Cloud 中创建 OAuth 客户端
在 Google Cloud console 中打开或创建一个项目,进入 APIs & Services → Credentials,创建一个类型为 Web application 的 OAuth 2.0 Client ID。
填写凭据
展开 Google 卡片并填写:
| 字段 | 填写内容 |
|---|---|
| Client ID | OAuth 客户端的 ID。 |
| Client Secret | OAuth 客户端的密钥。 |
| Redirect URI | 只读:由 PlayServ 生成,在下一步中复制。 |
注册 Redirect URI
在 Google Cloud 中,把卡片上的 Redirect URI 添加到该客户端的 Authorised redirect URIs,并在那里保存。
保存、测试并开启
点击 Save,再点击 Test connection,然后打开开关。
从 Meta 获取应用凭据
在 Meta for Developers 中打开或创建一个应用,从 Settings → Basic 复制 App ID 和 App Secret。
填写凭据
展开 Facebook 卡片并填写:
| 字段 | 填写内容 |
|---|---|
| App ID | 应用的数字 ID,15 到 17 位。 |
| App Secret | 应用密钥,32 个十六进制字符。 |
| Redirect URI | 只读:由 PlayServ 生成,在下一步中复制。 |
注册 Redirect URI
把卡片上的 Redirect URI 添加到 Facebook Login → Settings 下的 Valid OAuth Redirect URIs,并在那里保存。
保存、测试并开启
点击 Save,再点击 Test connection,然后打开开关。
配置 Sign in with Apple
在 Apple Developer → Certificates, Identifiers & Profiles 中,为应用的标识符启用 Sign in with Apple,并为其创建一个 Services ID。
创建密钥
在 Keys 下创建一个启用了 Sign in with Apple 的密钥,并下载其 .p8 文件。记下 Key ID,以及门户右上角显示的 Team ID。
填写凭据
展开 Apple 卡片并填写:
| 字段 | 填写内容 |
|---|---|
| Services ID | 在你的 App ID 下注册的 Services ID。 |
| Team ID | 你的 Apple Developer 团队 ID。 |
| Key ID | Sign in with Apple 密钥的 ID。 |
| Private key (.p8 PEM) | .p8 文件的内容,即一个 P-256 密钥。 |
| Redirect URI | 只读:由 PlayServ 生成,在下一步中复制。 |
注册 Redirect URI
把卡片上的 Redirect URI 添加到 Sign in with Apple → Configure 下该 Services ID 的 Return URLs,并在那里保存。
保存、测试并开启
点击 Save,再点击 Test connection,然后打开开关。
从 Epic 获取客户端凭据
在 Epic Developer Portal 中打开你的产品,从 Product Settings → Clients 复制某个客户端的 Client ID 和 Client Secret,以及你希望 Player 登录的 Deployment ID。
填写凭据
展开 Epic 卡片并填写:
| 字段 | 填写内容 |
|---|---|
| Client ID | Epic Online Services 客户端 ID。 |
| Client Secret | 该客户端的密钥。 |
| Deployment ID | Player 登录的目标 deployment。PlayServ 会据此推断出 product 和 sandbox。 |
| Redirect URI | 只读:由 PlayServ 生成,在下一步中复制。 |
注册 Redirect URI
把卡片上的 Redirect URI 添加到 Product Settings → Clients 下该客户端的 Redirect URL(s),并在那里保存。
保存、测试并开启
点击 Save,再点击 Test connection,然后打开开关。
Test connection 会逐项列出检查结果(通过、失败或警告),卡片会记住上次测试的时间和结果。它也可以针对未保存的修改运行,以便在保存前试用凭据;这类测试不会改变卡片的状态。开关立即生效。
未保存的修改会丢失
对卡片的修改在点击 Save 之前都只是草稿。离开页面或点击 Cancel 都会丢弃这些修改。
连接状态
| 状态 | 含义 |
|---|---|
| not configured | 尚未保存任何内容。 |
| incomplete | 缺少必填字段。 |
| configured | 所有必填字段都已保存,但还没有通过任何测试。 |
| verified | 已有一次测试通过。保存新凭据后仍保持该状态,因此它并不能证明当前凭据可用。 |
当提供方已开启且状态为 configured 或 verified 时,才会提供给 Player 使用。关闭它会将其从提供给游戏的提供方中移除。
已启用不等于已验证
开关不会等待测试完成,所以提供方可能在凭据无效的情况下处于开启状态。开启提供方之前先运行 Test connection,之后每次修改凭据时也要再运行一次。
端到端测试登录
在 Backoffice 提供此功能的地方,标签页页头的 Test sign-in 会打开一个页面,像游戏一样通过已启用的提供方登录,无需编写任何代码。
输入客户端密钥
把该 Project 的一个客户端密钥(pk_…)粘贴到 Public SDK key 中。密钥本身带有 Project 和 Environment 信息,页面会自行解析。
客户端密钥在 Projects 中该 Project 的 API keys 面板里创建:Create key,类型选 Client。密钥 只在 Save your token 中显示一次;如果当时没有保存,请创建一个新密钥。
选择提供方
页面会为每个已开启且已配置的提供方点亮一张卡片。Google、Apple 和 Epic 会走完整的登录流程,包括授权同意界面。Steam 没有浏览器登录,因此改为接收来自 Steamworks SDK 的会话票据。Facebook 目前还不在该页面上。
检查结果
登录成功后,页面会显示 PlayServ 签发的 Player ID 和会话 token。
测试登录会创建真实的 Player
该页面执行的是真实登录:从未登录过的提供方账号会成为该 Environment 中的新 Player,并出现在 Players 中。
失败和被拒绝的登录
标签页底部的 Recent failed and refused sign-ins 列出该 Project 未成功的登录,按时间从新到旧排列。Failed 表示凭据有误;refused 表示 PlayServ 拒绝了登录,例如设备或账号被封禁。可以按结果筛选,点击某一行即可打开对应的 Player。未关联到任何账号的登录会改为显示设备指纹。单个 Player 的登录尝试见其详情。
后续步骤
- Managing Players —— Player 登录后获得的账号
- 用户登录 —— 在游戏中让 Player 登录
- API key 管理 —— 游戏和测试页面使用的客户端密钥
更新于 2026年10月16日