VMware Cloud Partner Navigator 使用 OAuth 2.0,以便您可以为应用程序授予对客户组织中的资源进行安全委派访问的权限。VMware Cloud Partner Navigator 支持 OAuth 2.0 服务器到服务器应用程序,此类应用程序可通过直接颁发给应用程序的访问令牌来授权操作。

什么是 OAuth 2.0?

OAuth 2.0 是一种授权协议,支持为您的应用程序授予对资源的安全访问权限。您的客户端通过访问令牌获得授权。访问令牌具有一个范围,用于定义应用程序可以访问哪些资源。有关 OAuth 2.0 的信息,请访问 https://tools.ietf.org/html/rfc6749#page-8,或参阅此名为《OAuth 2.0 Simplified》的博客文章(网址为 https://aaronparecki.com/oauth-2-simplified/)。

OAuth 如何与 VMware Cloud Partner Navigator 配合使用?

VMware Cloud Partner Navigator 支持 OAuth 2.0 客户端凭据授权类型,因此可为您的应用程序授予对组织资源的访问权限,而无需用户授权。要为您的应用程序提供凭据,请在 VMware Cloud Partner Navigator 中创建一个服务器到服务器 OAuth 2.0 应用程序,并定义其访问令牌的范围。然后,您的应用程序将使用提供的 OAuth 凭据检索访问令牌,并获得对在范围内定义的资源进行访问的权限。如经销商角色和权限中所述,范围是根据组织角色定义的。

OAuth 应用程序由谁创建?

只有经销商管理员用户才能在经销商组织中创建和管理 OAuth 应用程序。

如何设置 OAuth 服务器到服务器应用程序?

设置 OAuth 应用程序的过程分为两步。首先,在您的一个组织中创建 OAuth 应用程序,并定义其访问令牌的范围。然后,将该应用程序添加到用于创建该应用程序的相同组织,以便为其启用对组织资源的访问权限。您不能添加在其他组织中创建的 OAuth 应用程序。

要创建 OAuth 应用程序,请执行以下操作:

  1. VMware Cloud Partner Navigator 工具栏上,单击组织 > OAuth 应用程序

  2. 单击创建应用程序 > 继续

  3. 填写 OAuth 应用程序详细信息,并定义其范围。

    1. 输入应用程序的名称和描述。

    2. 设置 OAuth 应用程序访问令牌的生存时间。

    3. 要定义 OAuth 应用程序访问令牌的范围,请选择组织角色。

    4. 单击创建

  4. 复制收到的凭据或下载 JSON 文件,然后单击继续

此时,已在您的 VMware Cloud Partner Navigator 组织中创建 OAuth 应用程序,但尚未授予对其资源的访问权限。要向该应用程序授予访问权限,您必须将其添加到您的组织中。

要将 OAuth 应用程序添加到组织中,请执行以下操作:

  1. VMware Cloud Partner Navigator 工具栏上,单击身份与访问管理 > OAuth 应用程序

  2. 单击添加应用程序

  3. 选择您的组织,然后浏览并选择一个 OAuth 应用程序。

    页面上会列出将分配给 OAuth 应用程序实例的组织角色和服务角色。

  4. 查看 OAuth 应用程序详细信息,然后单击添加

此时 OAuth 应用程序会添加到您的 VMware Cloud Partner Navigator 组织,并被授予对其资源的访问权限。

要授权应用程序的操作,请在脚本的 API 调用中使用提供的 OAuth 凭据。

如何管理 OAuth 应用程序?

有关您可以执行的 OAuth 管理功能列表,请参阅下表。

目标

执行操作

查看有权访问您组织的 OAuth 应用程序。

单击身份与访问管理 > OAuth 应用程序

添加在同一组织中创建的 OAuth 应用程序

  1. 单击身份与访问管理 > OAuth 应用程序

  2. 单击添加 OAuth 应用程序

  3. 选择您的组织。

  4. OAuth 应用程序下拉菜单中,选择要向其授予对此组织的访问权限的应用程序。

  5. 查看应用程序详细信息,然后单击添加

限制添加的 OAuth 应用程序访问您组织的资源

  1. 单击身份与访问管理 > OAuth 应用程序

  2. 从 OAuth 应用程序列表中,选择要阻止其访问您的组织资源的应用程序。

  3. 单击移除

查看在您的组织中创建的应用程序。

单击组织 > OAuth 应用程序

您可以在此处查看在您的组织中创建的所有应用程序。

管理在您的组织中创建的现有 OAuth 应用程序。

单击组织 > OAuth 应用程序,然后选择要管理的应用程序:

  • 要修改 OAuth 应用程序,请单击编辑

    注:

    如果更改应用程序的范围,则所做更改将不会同步到已添加到任何组织的应用程序实例。要更新之前添加的应用程序实例的范围,必须先将这些实例从身份与访问管理 > OAuth 应用程序中移除,然后再重新添加它们。

  • 要移除应用程序,请单击删除

    注:

    此操作无法恢复。使用这些客户端凭据的任何应用程序将无法再访问受保护的资源,且凭据将失效。