# OIDC API 身份验证 Equinix API使用OAuth 2.0协议来验证您的OIDC用户对API端点的请求。 为了与Equinix API进行交互,您需要使用承载访问令牌。 ## 先决条件[​](#先决条件 "直接链接至先决条件") 1. [OIDC提供商](https://docs.equinix.com/zh-Hans/iam/oidc/create-oidc-provider.md)。 2. 来自您注册的 OIDC 提供商的 OIDC ID 令牌。 3. 特定于产品或服务的权限,用于指定API访问令牌的范围。您需要: * `ern:`其中``是授予委托人的单一访问策略。 * `roleassignments:`其中``是OIDC负责人分配[角色的](https://docs.equinix.com/zh-Hans/iam/oidc/oidc-for-roles.md)组织ID。 * `projectpolicies:`其中``是OIDC负责人已获得[访问策略](https://docs.equinix.com/zh-Hans/iam/oidc/oidc-access-policies.md)或访问策略的项目ID。 * `orgpolicies:`其中``是负责人已获得访问策略或访问策略的组织ID。 * `orgpolicies: roleassignments:`其中``是负责人已被授予角色和访问策略的组织ID。 有关更多信息,请参阅[访问控制范围](https://docs.equinix.com/zh-Hans/iam/oidc/overview.md#access-control-scopes)。 ## 请求访问令牌[​](#请求访问令牌 "直接链接至请求访问令牌") 要请求承载访问令牌,请向端点发送`POST`请求[`/v1/token`](https://docs.equinix.com/zh-Hans/api-catalog/stsv1/v1-pre-auth/generateststoken.md)。 请在请求正文中注明: * `grant_type`-`urn:ietf:params:oauth:grant-type:token-exchange`用于接收访问令牌。 * `scope`(必填)-提供范围。根据主体是否已授予适当的角色或访问策略,检查令牌授予的权限。有关更多信息,请参阅[访问控制范围](https://docs.equinix.com/zh-Hans/iam/oidc/overview.md#access-control-scopes)。 * `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=' \ --data-urlencode 'subject_token=' ``` ## 使用访问令牌[​](#使用访问令牌 "直接链接至使用访问令牌") 要与Equinix API交互,请在HTTP请求的授权标题中发送访问令牌`Authorization: Bearer `。