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>'