疑难解答
在 CKBox 应用程序集成 的某些阶段，可能会出现一些问题和故障。
本节旨在解决常见的应用程序问题和集成障碍。
# 缺少令牌 URL
CKBox 显示错误消息：令牌 URL 丢失。
当未为 CKBox 配置提供令牌端点 URL 时，可能会出现此问题。CKBox 使用 JWT 令牌进行身份验证，必须提供有效的令牌端点 URL 才能使 CKBox 正常工作。
详细了解如何配置 CKBox
# 来自令牌端点的无效 JWT 响应
CKBox 显示错误消息：无法获取令牌。也许提供的令牌 URL 不可达。
如果令牌 URL 未以有效的 JWT 令牌响应，则可能会出现此问题。提供的 URL 可能确实正确响应，但其响应不是 CKBox 用于对用户进行身份验证的有效 JWT 令牌。
令牌端点是 CKBox 发出请求以获取令牌的地方。只有在用户证明其身份后，它才应返回令牌。
详细了解如何配置令牌 URL。
# 来自令牌回调的无效 JWT
CKBox 显示错误消息：无法从回调中检索令牌。
如果提供给 tokenUrl 的回调未以有效的 JWT 令牌响应，则可能会出现此问题。必须提供返回有效 JWT 令牌的令牌回调，才能使 CKBox 正常工作。
详细了解如何配置令牌 URL。
# 无效的令牌有效载荷
CKBox 显示以下消息之一
无效的 JWT 令牌。缺少字段“aud”。无效的 JWT 令牌。缺少字段“sub”。无效的 JWT 令牌。缺少字段“iat”。无效的 JWT 令牌。缺少字段“auth.ckbox.role”。
当令牌有效载荷缺少 CKBox 正确运行所需的信息之一时，可能会出现此问题。
详细了解如何生成有效的 JWT 令牌。
# 格式错误的令牌 URL
CKBox 显示错误消息：令牌 URL 似乎不正确。
这表示提供的令牌 URL 格式错误，不是有效的 URL。令牌 URL 应作为 CKBox 配置的一部分提供。
详细了解如何开始使用 CKBox
令牌端点不可达
CKBox 显示错误消息：无法获取令牌。响应代码：500。 这种错误表示在 tokenUrl 中配置的令牌端点已停止正常响应。这可能意味着该端点暂时停机或出现更严重的服务器错误。
# 格式错误的 serviceOrigin URL
CKBox 显示错误消息：格式错误的 serviceOrigin URL。
如果传递给配置的服务 URL 不是有效的 URL，则可能会出现此问题。仅当您自己托管 CKBox 后端时，才应设置此选项。如果您使用 SaaS 版本的 CKBox，则它不应存在。
详细了解如何配置 CKBox 集成。