跳到主要内容

配置域验证和捕获

Postman Enterprise 计划提供域验证和捕获。

验证域以查看 Postman 中使用你组织的域和子域创建的所有用户帐户。启用域捕获以管理 Postman 中的所有这些用户帐户。通过域捕获,你可以将组织的所有 Postman 用户合并到一个 Postman 团队中,并确保自动添加使用你的域注册 Postman 的任何新用户。

要启用域捕获, 团队管理员 必须首先 添加并验证域或子域 。验证域后,他们可以创建 启用域捕获 的请求。一旦启用域捕获的请求获得批准,他们就可以 联系 Postman support 来管理 无人认领的帐户

域验证和捕获的先决条件

你必须是 Postman 团队管理员 才能添加和验证域并为你的团队启用域捕获。

添加和验证域并启用域捕获需要以下内容:

启用域捕获需要以下内容:

  • 必须配置并启用 SSO 。
  • 必须关闭替代身份验证方法(Postman 或 Google 登录)。

建议你启用 SSO 配置 以简化新用户入职流程,并启用 Auto-Flex 以确保你的团队可以自动容纳在启用域捕获时可能添加到你的 Postman 团队的所有用户。

添加和验证域

团队管理员可以通过导航到 域仪表板 向你的团队添加域和子域。将验证TXT 记录添加到 DNS 配置后,Postman 的团队将验证你的域或子域。你必须先验证你的域,然后才能在 Postman 中查看和管理使用你组织的域和子域创建的所有用户帐户。

  1. 打开 Postman 并在 Postman 标题中选择团队 > 团队设置。在左侧边栏中选择身份验证。

  2. 确认你的团队仅启用了 SSO 身份验证方法。然后,选择“域”选项卡。

    你的团队必须仅启用基于 SAML 的 SSO 身份验证方法才能设置域捕获。必须关闭其他身份验证方法,例如 Postman 或 Google 登录。

  3. 选择添加域

    选择添加域

  4. 输入你要添加的域或子域,然后选择生成验证记录

    生成验证记录

  5. 选择 复制图标 复制以复制TXT 记录,然后将其添加到你域的 DNS 配置中。

    相反,如果你还没有准备好将TXT 记录添加到域的 DNS 配置,则可以选择稍后验证。要稍后验证你的域,请参阅 稍后验证域

  6. 选中我已将 TXT 记录添加到 DNS 工具复选框,然后选择验证域。请注意,TXT 更改最多可能需要 24 小时才能生效,以便成功验证域。验证域后,团队管理员将收到一封电子邮件通知。

    添加域 TXT 记录

    你可以联系 Postman support 人员 以检查你的域验证请求的状态。

  7. 验证域后,你可以 创建请求以启用域捕获

稍后验证域

或者,如果你在添加域时未验证该域,则可以稍后验证该域。

要验证你已添加的域,请执行以下操作:

  1. 打开 Postman 并在 Postman 标题中选择团队 > 团队设置。在左侧边栏中选择身份验证。

  2. 选择具有要验证状态的域旁边的验证。UNVERIFIED

    你还可以选择具有要验证状态的域旁边的管理UNVERIFIED,然后选择查看验证详细信息

    稍后验证域

  3. 选择 复制图标 复制以复制TXT 记录,然后将其添加到你域的 DNS 配置中。

  4. 选中我已将 TXT 记录添加到 DNS 工具复选框,然后选择验证域。Postman 的团队将检查你请求的域并将其状态更新到VERIFIED你的域仪表板中。验证域后,团队管理员将收到一封电子邮件通知。

    验证未验证域

    你可以联系 Postman support 人员 以检查你的域验证请求的状态。

  5. 验证域后,你可以 创建请求以启用域捕获

查看验证详细信息

团队管理员可以通过导航到域仪表板 来查看已验证和未验证域的验证详细信息。验证详情显示验证TXT 记录

  1. 打开 Postman 并在 Postman 标题中选择团队 > 团队设置。在左侧边栏中选择身份验证。
  2. 选择要查看其验证详细信息的域旁边的管理。
  3. 选择查看验证详细信息

查看无人认领的帐户

无人认领的帐户是与不属于你的团队的经过验证的域关联的帐户。团队管理员可以通过导航到 域仪表板 来查看无人认领的帐户。

  1. 打开 Postman 并在 Postman 标题中选择团队 > 团队设置。在左侧边栏中选择身份验证。

  2. 选择你要查看未认领帐户状态的域旁边的管理VERIFIED,然后选择查看帐户

    或者,你可以在域仪表板中的域旁边选择无人认领的帐户数。

  3. 查看不属于你团队的客户列表。

    查看无人认领的帐户

  4. 或者,你可以选择导出 CSV以将列表导出为 CSV 文件。你将收到一封包含下载链接的电子邮件。

启用域捕获

添加并验证 域或子域后,团队管理员可以通过导航到 域仪表板 来创建启用域捕获的请求。要启用域捕获,团队管理员必须在 Postman support 下创建请求。请求获得批准后,团队管理员可以与 Postman support 人员一起管理 无人认领的帐户

要启用域捕获,请执行以下操作:

  1. 打开 Postman 并在 Postman 标题中选择团队 > 团队设置。在左侧边栏中选择身份验证。
  2. 选择状态为要为其启用域捕获的域旁边的管理。VERIFIED
  3. 选择请求索赔。Postman support 随后将联系团队管理员,解释启用域捕获的影响。
  4. 请求获得批准后,你可以 联系 Postman support 人员 来管理 无人认领的帐户

要查看启用域捕获的请求的状态,请选择域旁边的管理。选择Request To Claim后,请求状态变为REQUEST SENT

索偿请求已发送

请求获得批准后,屏幕顶部将显示一条通知,说明已启用帐户捕获

启用域捕获

要关闭域捕获,你必须 联系 Postman support

用户体验

启用域捕获后,使用你的域或子域注册 Postman 的新 Postman 用户会自动添加到你的团队中。

拥有与域或子域关联的帐户的现有 Postman 用户只有在加入你的团队后才能访问 Postman。这适用于属于其他团队的现有用户和现有个人用户。现有用户下次登录 Postman 时,他们将收到一条通知,告知你的团队正在管理他们的帐户。现有用户可以使用此通知加入团队。

域捕获加入团队通知

你将无法有选择地选择要添加到团队中的用户。启用后,随着这些用户登录并加入你的团队,无人认领的帐户数量将会减少。

其他 Postman 团队的现有用户将无法访问其早期团队的所有数据,包括个人工作空间。没有数据会从他们之前的团队转移到他们的新团队。用户将无法使用其捕获的帐户留在或加入额外的 Postman 团队。

要将现有用户的集合和环境从其早期团队转移到新团队, 请联系 Postman support

有关启用域捕获的影响的更多详细信息,请参阅 域捕获常见问题解答

如果用户在转移到你的 Postman 团队时遇到任何问题,请联系 Postman support

联系支持人员管理帐户

一旦批准启用域捕获 的请求,团队管理员就可以通过导航到 域仪表板 来联系 Postman support。联系 Postman support 以申请不属于你团队的帐户,将团队合并到你的团队中,并限制用户只能在你的团队中工作。

  1. 打开 Postman 并在 Postman 标题中选择团队 > 团队设置。在左侧边栏中选择身份验证。

  2. 选择具有你要联系支持人员的状态的域旁边的管理。VERIFIED

    必须为你要联系支持的域启用域捕获。

  3. 选择联系支持

    有关管理帐户的联系支持

删除域

团队管理员可以通过导航到域仪表板 从你的团队中删除域和子域。

  1. 打开 Postman 并在 Postman 标题中选择团队 > 团队设置。在左侧边栏中选择身份验证。
  2. 选择要删除的域旁边的管理。
  3. 选择删除域

域捕获常见问题解答

启用域捕获后,捕获的用户及其数据(集合、环境)会发生什么情况?

捕获用户的体验取决于他们之前的团队状态:

  • 如果捕获的用户已经在你组织的团队中,则对他们没有任何改变。

  • 如果捕获的用户不属于任何团队:

    • 所有现有的用户会话都被撤销。
    • 下次用户登录时,系统会提示他们使用 SSO 加入你组织的团队。
    • 当用户使用 SSO 对你组织的团队进行身份验证时,他们的现有数据将传输到该团队。
  • 如果捕获的用户是现有免费或付费团队的一部分:

    • 他们已从现有团队中移除。

    • 所有现有的用户会话都被撤销。

    • 下次用户登录时,系统会提示他们使用 SSO 加入你组织的团队。

    • 用户可以使用 SSO 对你组织的团队进行身份验证。

    • 他们将无法访问其早期团队的所有数据,包括个人工作空间。没有数据会从他们之前的团队转移到他们的新团队。

      要将现有用户的集合和环境从其早期团队转移到新团队, 请联系 Postman support

  • 如果捕获的用户是现有免费团队的最后一个管理员:

    • 他们已从团队中删除,其余用户被分配了 Admin 角色

    • 所有现有的用户会话都被撤销。

    • 下次用户登录时,系统会提示他们使用 SSO 加入你组织的团队。

    • 用户可以使用 SSO 对你组织的团队进行身份验证。

    • 他们将无法访问其早期团队的所有数据,包括个人工作空间。没有数据会从他们之前的团队转移到他们的新团队。

      要将现有用户的集合和环境从其早期团队转移到新团队, 请联系 Postman support

  • 如果捕获的用户是现有付费团队的最后一个管理员:

    • Postman support 人员将联系你的团队管理员,讨论如何在验证你已添加到团队的域之前处理此问题。

    • 所有现有的用户会话都被撤销。

    • 下次用户登录时,系统会提示他们离开现有团队。

    • 他们将需要联系 Postman support ,将管理员角色分配给另一个团队成员并将他们从团队中移除。

    • 用户可以使用 SSO 对你组织的团队进行身份验证。

    • 他们将无法访问其早期团队的所有数据,包括个人工作空间。没有数据会从他们之前的团队转移到他们的新团队。

      要将现有用户的集合和环境从其早期团队转移到新团队, 请联系 Postman support

团队管理员能否在启用域捕获之前查看将捕获的用户帐户列表?

是的,团队管理员可以在确认他们想要启用域捕获之前查看将被捕获的无人认领的 Postman 帐户列表。要了解更多信息,请参阅 查看无人认领的帐户

添加域是否会自动将具有组织域的所有团队成员添加到组织的团队中?

不可以,在团队管理员添加域后,他们必须为 Postman 的团队创建请求以验证域或子域。一旦满足这两个条件,团队管理员就可以创建启用域捕获的请求。Postman support 随后将联系团队管理员,解释启用域捕获的影响。要了解更多信息,请参阅 启用域捕获