| 宣布日期 | 开始推行 | 结束推行 |
| 2025 年 4 月 3 日 | 2025 年 4 月 3 日 | 2025 年 4 月 11 日 |
即日起，我们将在用户身份 API 中推出两个新属性，帮助明确用户是否已验证其电邮地址，包括验证的方式和时间。通过此更新，您将可以跟踪验证方法，了解电邮地址是否可作为可靠的联系方式，以及用户是否真正拥有该电子邮件地址的访问权限。
此公告包括以下主题：
有什么变化？
我们将在用户身份 API中添加两个新属性：verification_method 和 verified_at。当 verification_method 更新为“完整”时，verified_at 属性会返回日期和时间。对于其它值，它不会更新，并在 verification_method 从“完整”更改为任何其他值清除。这两个属性都是只读的，且只能由 Zendesk 设置。
以下是 verification_method 属性可能的值、描述以及生成的已验证属性值。
|
verification_method 属性 |
描述 |
已验证属性 |
|
无 |
电邮地址已添加到用户的个人资料，但没有所有权证明 |
verified=false |
|
低 |
专员或 API 请求已将电邮设置为已验证 |
verified=true |
|
SSO |
身份提供者 (IdP) 已将电邮纳入单点登录 (SSO) 的登录流程 |
verified=true 如果您的 SSO 是使用 OpenID Connect 配置的，我们将遵循在 email_verified 声明中传递的值。 |
|
嵌入 |
此电邮是通过 JWT 提供的，作为嵌入式 Web Widget 或 SDK 登录流程的一部分。请参阅设置消息传送的用户身份验证 |
verified=true |
|
完整 |
Zendesk 已完成第一手电邮验证工作流程 |
verified=true |
Zendesk 为何作出这项更改？
目前，用户身份 API 上标记为“verified=true”的电邮地址身份未指定用于验证的方法，导致无法确定已验证的电邮地址是否真正可信。有了这些新的属性，我们将改变这一现状。以下是它们将为您带来的好处：
- 您会知道每封电邮的验证方式：由团队成员验证、通过外部系统验证，或由 Zendesk 直接验证。这有助于您决定可以信任哪些电邮地址。
- 当电邮被标为通过“完整”验证方法验证时，表示用户已证明其可以访问该电邮收件箱。这样您就可以确保联系的是真人。
我需要做些什么？
您无需进行任何操作。新属性可供您使用，您可以根据自己需要进行选择。
如果您对此公告有任何反馈或疑问，请访问我们的社区论坛，我们将在这里收集和管理客户对产品的反馈。如需获取关于 Zendesk 产品的常规帮助，请联系 Zendesk 客户支持。