OIDC API 身份验证
Equinix API使用OAuth 2.0协议来验证您的OIDC用户对API端点的请求。 为了与Equinix API进行交互,您需要使用承载访问令牌。
先决条件
-
来自您注册的 OIDC 提供商的 OIDC ID 令牌。
-
特定于产品或服务的权限,用于指定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>。