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

OIDCと役割

役割ベースのアクセス制御を使用している場合は、OIDCの主要な役割を割り当てて、Equinixインフラストラクチャへのアクセスを許可できます。次に、OIDCプリンシパルがトークン交換を実行する場合は、scopeパラメータにを使用します。roleassignments:<org-id>プリンシパルに組織内で役割が割り当てられている場合、トークンエクスチェンジはベアラトークンを発行します。

ロールの割り当てと管理に必要な権限は次のいずれかです:

  • 役割ベースのアクセス制御-IAM Admin役割。
  • 属性ベースのアクセス制御-以下を含むアクセスポリシー:use/createRoleAssignment、use/listRoleAssignments、use/getRoleAssignment、。use/deleteRoleAssignment

利用可能な役割​

すべての役割を一覧表示するには、エンドポイントにリクエストを/v1/roles送信します。GET

サンプルcURLリクエスト:

curl -X GET 'https://access.eqix.equinix.com/v1/roles' \
-H 'Authorization: Bearer <token>'

特定のプロジェクトで使用可能な役割を一覧表示するには、エンドポイントにリクエストを/v1/projects/{projectId}/roles送信します。GET サンプルcURLリクエスト:

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

応答には、ロールの ID と割り当てスコープが含まれます。

assignmentScope.typeこのフィールドには、その役割に許可されている割り当て範囲が次のリストから一覧表示されます。assignmentScopeType=PDS_ORG``assignmentScopeType=ORGANIZATION、、assignmentScopeType=PROJECT、、assignmentScopeType=BILLING_ACCOUNT、assignmentScopeType=SUBSCRIPTION_KEY``assignmentScopeType=PORTです。は、assignmentScope.idそのスコープの一意のIDです。

役割割り当てを作成するときは、プロジェクトIDとスコープ情報を指定する必要があります。

役割割り当ての作成​

役割の割り当てを作成するには、エンドポイントにリクエストを/v1/roleAssignments送信します。POST

サンプルcURLリクエスト:

curl -X POST 'https://access.eqix.equinix.com/v1/roleAssignments' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"principal": "<principal:principal_id>",
"roleId": "<role:role_id>",
"assignmentScope": {
"id": "<role_assignment_scope_id>",
"type": "<role_assignment_scope>"
}
}'

役割割り当ての一覧​

割り当てスコープタイプのすべての役割割り当てを一覧表示するには、エンドポイントにリクエストを/v1/roleAssignments送信します。GETとassignmentScopeTypeクエリパラメータを使用して、assignmentScopeId応答を指定されたスコープタイプに制限します。

サンプルcURLリクエスト:

curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments?assignmentScopeId=<assignment_scope_id>&assignmentScopeType=<assignment_scope_type>' \
-H 'Authorization: Bearer <token>'

役割割り当ての詳細を取得​

特定の役割割り当ての詳細を取得するには、エンドポイントにリクエストを/v1/roleAssignments/{roleAssignmentId}送信します。GET

サンプルcURLリクエスト:

curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments/{roleassignment:roleAssignmentId}' \
-H 'Authorization: Bearer <token>'

役割割り当ての削除​

役割の割り当てを削除すると、OIDCユーザーはその役割によって付与された権限へのアクセス権を失います。役割の割り当てを削除するには、エンドポイントにリクエストを/v1/roleAssignments/{roleAssignmentId}送信します。DELETE

サンプルcURLリクエスト:

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