跳到主要内容

OIDC API 身份验证

Equinix API使用OAuth 2.0协议来验证您的OIDC用户对API端点的请求。 为了与Equinix API进行交互,您需要使用承载访问令牌。

先决条件​

  1. OIDC提供商。

  2. 来自您注册的 OIDC 提供商的 OIDC ID 令牌。

  3. 特定于产品或服务的权限,用于指定API访问令牌的范围。您需要:

    • ern:<access-policy-ern>其中<access-policy-ern>是授予委托人的单一访问策略。
    • roleassignments:<org-id>其中<org-id>是OIDC负责人分配角色的组织ID。
    • projectpolicies:<project-id>其中<project-id>是OIDC负责人已获得访问策略或访问策略的项目ID。
    • orgpolicies:<org-id>其中<org-id>是负责人已获得访问策略或访问策略的组织ID。
    • orgpolicies:<org-id> roleassignments:<org-id>其中<org-id>是负责人已被授予角色和访问策略的组织ID。

    有关更多信息,请参阅访问控制范围。

请求访问令牌​

要请求承载访问令牌,请向端点发送POST请求/v1/token。

请在请求正文中注明:

  • grant_type-urn:ietf:params:oauth:grant-type:token-exchange用于接收访问令牌。
  • scope(必填)-提供范围。根据主体是否已授予适当的角色或访问策略,检查令牌授予的权限。有关更多信息,请参阅访问控制范围。
  • subject_token- OIDC ID令牌。
  • subject_token_type-用于urn:ietf:params:oauth:token-type:id_token将您的标识subject_token为OIDC ID令牌。

cURL 请求示例:

curl -X POST 'https://sts.eqix.equinix.com/v1/token' \
--data-urlencode 'grant_type=urn:ietf:params:oauth:grant-type:token-exchange' \
--data-urlencode 'subject_token_type=urn:ietf:params:oauth:token-type:id_token' \
--data-urlencode 'scope=<role_or_access_policy>' \
--data-urlencode 'subject_token=<oidc_id_token>'

使用访问令牌​

要与Equinix API交互,请在HTTP请求的授权标题中发送访问令牌Authorization: Bearer <token>。

这个页面对您有帮助吗?