跳到主要内容
Authentication 与 Players

本页尚未翻译,当前显示英文版本。

SSO & Auth

SSO & Auth 决定 Player 可以通过哪些提供方登录。 每个提供方是一张卡片:填入从提供方开发者控制台获取的凭据,测试后开启该提供方。在 Players → SSO & Auth 中打开它。提供方及其凭据作用于整个 Project 的所有 Environment;只有失败和被拒绝的登录列表会随顶栏所选的 Environment 变化。

页头统计已启用的提供方数量,分母为全部六张卡片,包括两个即将推出的提供方。


提供方

提供方Player 的登录方式状态
GoogleGoogle 账号,基于 OAuth 2.0可用
FacebookFacebook 或 Meta 账号,基于 OAuth 2.0可用
AppleSign in with Apple。根据 App Store 审核指南 4.8,提供其他任何社交登录的 iOS 应用也必须提供它。可用
EpicEpic Games 账号,通过 Epic Online Services。如果你在 Epic Games Store 上发行或面向 Epic 账号用户,值得启用。可用
PlayServ Webhook由你自己的认证服务器调用 PlayServ:适用于已有自己登录系统的游戏。即将推出
PlayServ Auth TokenSDK 传入一个由你在服务器上签名的 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 IDOAuth 客户端的 ID。
Client SecretOAuth 客户端的密钥。
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 IDSign 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 IDEpic Online Services 客户端 ID。
Client Secret该客户端的密钥。
Deployment IDPlayer 登录的目标 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 的登录尝试见其详情。


后续步骤

更新于 2026年10月16日