# OIDC API認証 Equinix APIは、OAuth 2.0プロトコルを使用して、APIエンドポイントに対するOIDCユーザーのリクエストを認証します。 Equinix APIとやり取りするには、ベアラアクセストークンが必要です。 ## 前提条件[​](#前提条件 "への直接リンク前提条件") 1. [OIDCプロバイダ。](https://docs.equinix.com/ja/iam/oidc/create-oidc-provider.md) 2. 登録したOIDCプロバイダからのOIDC IDトークン。 3. APIアクセストークンの範囲を指定する製品またはサービス固有の権限。次のいずれかが必要です。 * `ern:`ここで、``は、プリンシパルに付与された単一のアクセスポリシーです。 * `roleassignments:`ここで、``はOIDCプリンシパルが[役割を](https://docs.equinix.com/ja/iam/oidc/oidc-for-roles.md)割り当てている組織IDです。 * `projectpolicies:`ここで、``はOIDCプリンシパルに[アクセスポリシー](https://docs.equinix.com/ja/iam/oidc/oidc-access-policies.md)またはアクセスポリシーが付与されているプロジェクトIDです。 * `orgpolicies:`ここで、``は、プリンシパルにアクセスポリシーまたはアクセスポリシーが付与されている組織IDです。 * `orgpolicies: roleassignments:`ここで、``は、プリンシパルに役割とアクセスポリシーの両方が付与されている組織IDです。 詳細については、「[アクセス制御範囲」を](https://docs.equinix.com/ja/iam/oidc/overview.md#access-control-scopes)参照してください。 ## アクセストークンのリクエスト[​](#アクセストークンのリクエスト "への直接リンクアクセストークンのリクエスト") ベアラアクセストークンをリクエストするには、エンドポイントにリクエストを[`/v1/token`](https://docs.equinix.com/ja/api-catalog/stsv1/v1-pre-auth/generateststoken.md)送信します。`POST` リクエスト本文に * `grant_type`-アクセストークンの受信に使用します。`urn:ietf:params:oauth:grant-type:token-exchange` * `scope`(必須)-範囲を指定します。トークンによって付与された権限は、プリンシパルに適切な役割またはアクセスポリシーが付与されているかどうかと照合されます。詳細については、「[アクセス制御範囲」を](https://docs.equinix.com/ja/iam/oidc/overview.md#access-control-scopes)参照してください。 * `subject_token`- OIDC IDトークン。 * `subject_token_type`-をOIDC IDトークンとして識別するに`subject_token`使用します。`urn:ietf:params:oauth:token-type:id_token` サンプル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リクエストの承認ヘッダーを作成します。`Authorization: Bearer `