OIDC API認証
Equinix APIは、OAuth 2.0プロトコルを使用して、APIエンドポイントに対するOIDCユーザーのリクエストを認証します。 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です。
詳細については、「アクセス制御範囲」を参照してください。
アクセストークンのリクエスト
ベアラアクセストークンをリクエストするには、エンドポイントにリクエストを/v1/token送信します。POST
リクエスト本文に
grant_type-アクセストークンの受信に使用します。urn:ietf:params:oauth:grant-type:token-exchangescope(必須)-範囲を指定します。トークンによって付与された権限は、プリンシパルに適切な役割またはアクセスポリシーが付与されているかどうかと照合されます。詳細については、「アクセス制御範囲」を参照してください。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=<role_or_access_policy>' \
--data-urlencode 'subject_token=<oidc_id_token>'
アクセストークンの使用
とやり取りするには、にアクセストークンを送信して、Equinix APIリクエストの承認ヘッダーを作成します。Authorization: Bearer <token>