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

OIDCとアクセスポリシー

属性ベースのアクセス制御を使用している場合は、OIDCプリンシパルにアクセスポリシーを付与して、Equinixインフラストラクチャへのアクセスを許可できます。次に、OIDCプリンシパルがトークン交換を実行するときに、パラメータのアクセスポリシーのERNを指定します。scopeプリンシパルが付与されている場合、トークンエクスチェンジはベアラトークンを発行します。

グラントとアクセスポリシーを管理するために必要な権限は、次のいずれかです:

  • 役割ベースのアクセス制御-IAM Admin役割。
  • 属性ベースのアクセス制御-以下を含むアクセスポリシー:use/listAccessPolicies、use/addGrant、use/listGrants、。use/removeGrant
限定的な可用性

属性ベースのアクセス制御は、現在、制限付き可用性(LA)ステータスで提供されています。アクセスは、管理された一連のお客様とユースケースに制限されています。機能が不完全である可能性があり、変更される可能性があり、欠陥が含まれる可能性があります。運用上のセーフガードと容量制限が適用されます。このAPIを使用することにより、お客様は以下のことに同意したものとみなされ

  • 早期アクセスおよびフィードバックのみを目的としています。
  • 地域、セグメント、または容量の制約により、可用性が制限される場合があります。
  • 現段階では、機能、パフォーマンス、安定性は保証されていません。
  • ドキュメントとサポートリソースは進化している可能性があります。
  • このフェーズで提供されるフィードバックは、一般提供(GA)前の改善に反映されます。

アクセスポリシーを見る​

プロジェクトの既存のアクセスポリシーを表示するには、エンドポイントにリクエストを/v1/projects/{projectId}/accessPolicies送信します。GETアクセスポリシーに付与を追加する場合は、リクエストでアクセスポリシーIDを指定する必要があります。

サンプルcURLリクエスト:

curl -X GET 'https://access.eqix.equinix.com/v1/projects/{projectId}/accessPolicies' \
-H 'Authorization: Bearer <token>'

補助金の追加​

アクセスポリシーに付与を追加するには、エンドポイントにリクエストを/v1/projects/{projectId}/accessPolicies/{accessPolicyId}/grants送信します。POST指定:

  • リクエストのパスにプロジェクトとアクセスポリシーIDを追加します。

  • オブジェクト内でアクセスを許可するOIDCプリンシパルは、次のいずれかの形式でアクセスを許可しますgrantee。

    • principal:<projectId>:<idp>:<subject>ユーザーまたはサービスの場合。
    • group:<projectId>:<idp>:<groupName>グループの場合。
    • project:<projectId>別のプロジェクトがこのアクセスポリシーを別のプロジェクトにエクスポートする場合。

サンプルcURLリクエスト:

curl -X POST 'https://access.eqix.equinix.com/v1/projects/{projectId}/accessPolicies/{accessPolicyId}/grants' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"grantee": "principal:<projectId>:<idp>:<subject>"
}'

補助金一覧​

特定のアクセスポリシーが付与されているOIDCプリンシパルを確認するには、付与のリストを取得します。エンドポイントにリクエストを/v1/projects/{projectId}/accessPolicies/{accessPolicyId}/grants送信します。GET

サンプルcURLリクエスト:

curl -X GET 'https://access.eqix.equinix.com/v1/projects/{projectId}/accessPolicies/{accessPolicyId}/grants' \
-H 'Authorization: Bearer <token>'

補助金の削除​

権限付与を削除すると、OIDCプリンシパルはアクセスポリシーで付与された権限へのアクセスを失います。付与を削除するには、エンドポイントにリクエストを/v1/projects/{projectId}/accessPolicies/{accessPolicyId}/grants/{grantId}送信します。DELETE

サンプルcURLリクエスト:

curl -X DELETE 'https://access.eqix.equinix.com/v1/projects/{projectId}/accessPolicies/{accessPolicyId}/grants/{grantId}' \
-H 'Authorization: Bearer <token>'
このページは役に立ちましたか?