メインコンテンツにスキップ

OIDC API認証

Equinix APIは、OAuth 2.0プロトコルを使用して、APIエンドポイントに対するOIDCユーザーのリクエストを認証します。 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です。

    詳細については、「アクセス制御範囲」を参照してください。

アクセストークンのリクエスト​

ベアラアクセストークンをリクエストするには、エンドポイントにリクエストを/v1/token送信します。POST

リクエスト本文に

  • grant_type-アクセストークンの受信に使用します。urn:ietf:params:oauth:grant-type:token-exchange
  • scope(必須)-範囲を指定します。トークンによって付与された権限は、プリンシパルに適切な役割またはアクセスポリシーが付与されているかどうかと照合されます。詳細については、「アクセス制御範囲」を参照してください。
  • 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>

このページは役に立ちましたか?