概览
TicketWave 的 OAuth 工单步骤如何验证 Steam、CFX、GitHub、Roblox、Twitch、Battle.net 和 Epic Games 账号。
身份验证步骤
身份验证步骤会要求成员使用外部账号登录。TicketWave 绝不会索要密码——成员会被带到服务提供方自己的登录页面，随后只会返回已验证的账号名称和 ID。
为什么这比在聊天里询问更好
问一句“你的 Steam 名字是什么？”得到的只是成员手动输入的一串字符。身份验证步骤给你的是一个成员已经证明自己拥有的账号。
| 在聊天里询问 | 身份验证步骤 |
|---|---|
| 拼写错误和 ID 错误 | 来自服务提供方的准确账号 ID |
| 冒充非常容易 | 成员必须真正登录 |
| 工作人员得复制/粘贴再去查找 | 名称和 ID 会自动进入工单 |
| 需要发几条消息 | 只需点一下 |
对于游戏和开发者社区来说，这在 TicketWave 里是最省时间的一项功能——你的工作人员在处理每个工单时，一开始就已经知道自己在和谁对话。
支持的服务
| 服务 | 步骤类型 | 指南 |
|---|---|---|
| CFX / FiveM | CFX Authentication | Click here |
| Steam | Steam Authentication | Click here |
| GitHub | GitHub Authentication | Click here |
| Roblox | Roblox Authentication | Click here |
| Twitch | Twitch Authentication | Click here |
| Battle.net | Battle.net Authentication | Click here |
| Epic Games | Epic Games Authentication | Click here |
每一种身份验证步骤类型都是高级功能。我们这边已经全部接好了——你不需要注册开发者应用、创建 API 密钥，也不需要自行托管任何东西。
工作原理
步骤会显示出来，在工单中带有一个 Login 按钮和服务图标。
成员点击 Login。 这个按钮是一个携带一次性令牌的链接。
服务提供方请求授权。 成员会在服务提供方自己的网页上登录——比如 Steam、GitHub、Twitch 等。TicketWave 从不接触这些凭据。
服务提供方把成员带回。 TicketWave 验证响应，读取账号名称和 ID，并将它们存储为该步骤的答案。
确认页面会在 TicketWave 网站上打开："Account Successfully Linked"，其中包含工单 ID、服务器以及已关联的账号。
工单继续进行下一个步骤——如果这是最后一步，则会解锁。
一次性令牌
每个 Login 按钮都包含一个有效期为 10 分钟 的令牌。
这样设计是有意的：链接会发布到频道里，而一个永久有效的链接就意味着它可以被重复使用。10 分钟后，这个令牌就会被丢弃。
如果成员花的时间太久，他们会看到这个页面：
续期令牌
每个身份验证步骤在 Login 按钮旁边都有一个 🔁 Renew Token 按钮。
返回 Discord 中的工单频道。
点击步骤消息里的 🔁 Renew Token。
再次点击 Login——此时按钮会带上一个新的 10 分钟令牌。
续期不会丢失任何内容。它只是用一个新的令牌重新生成步骤消息。
TicketWave 会存储什么
对于每一次成功的身份验证，工单中只会存储两个值：
- 服务提供方的账号 ID
- 服务提供方的显示名称 / 用户名
仅此而已。交换完成后，不会保留密码、邮箱或访问令牌。访问令牌只会被使用一次，用来读取公开资料，然后会和请求一起被丢弃。
答案会像这样显示在工单摘要中：
> Steam Verification: 🎮 `PlayerOne` (`76561198000000000`)
添加身份验证步骤
打开你的服务器控制面板 → Settings → Ticket Steps → Configure。
点击 Add Step。
为它填写一个 Step Title（例如 Verify your Steam account）以及简短的 Step Description。
在 Step Type 下选择对应的服务。
决定该步骤是否为 Required——可选步骤会额外显示一个 ⏭️ Skip 按钮。
你也可以选择将该步骤限制为某个 category 或 subcategory，这样只有需要它的工单才会询问。
点击 Create Step，然后打开一个测试工单。
身份验证步骤不使用步骤选项。Login 和 Renew Token 按钮由 TicketWave 自动生成——你只需要配置标题、描述和限制条件。
故障排查
步骤完全没有显示。
身份验证步骤需要高级版。没有有效的高级订阅时，该步骤会被跳过。请检查服务器控制面板中的 Premium 页面。
"Your ticket authentication token is invalid or has expired."
10 分钟的有效期已经结束。请在工单中使用 🔁 Renew Token，然后再次点击 Login。
别人点了这个按钮。
只有工单所有者才能回答步骤。其他人都会收到错误消息，并且不会存储任何内容。
登录后没有任何反应。
成员返回时，工单必须仍然是打开状态，并且该步骤必须仍然是未回答状态。如果工单在此期间被关闭，就无法存储答案——请新建一个工单。
下一步
选择你想要设置的服务：
How is this guide?