# OIDCと役割 役割ベースのアクセス制御を使用している場合は、OIDCの主要な役割を割り当てて、Equinixインフラストラクチャへのアクセスを許可できます。次に、OIDCプリンシパルが[トークン交換を](https://docs.equinix.com/ja/equinix-api/oidc-api-authentication.md)実行する場合は、scopeパラメータにを使用します。`roleassignments:`プリンシパルに組織内で役割が割り当てられている場合、トークンエクスチェンジはベアラトークンを発行します。 ロールの割り当てと管理に必要な権限は次のいずれかです: * 役割ベースのアクセス制御-`IAM Admin`役割。 * 属性ベースのアクセス制御-以下を含むアクセスポリシー:`use/createRoleAssignment`、`use/listRoleAssignments`、`use/getRoleAssignment`、。`use/deleteRoleAssignment` ## 利用可能な役割[​](#利用可能な役割 "への直接リンク利用可能な役割") すべての役割を一覧表示するには、エンドポイントにリクエストを[`/v1/roles`](https://docs.equinix.com/ja/api-catalog/accessv1/v1-role/listroles.md)送信します。`GET` サンプルcURLリクエスト: ``` curl -X GET 'https://access.eqix.equinix.com/v1/roles' \ -H 'Authorization: Bearer ' ``` 特定のプロジェクトで使用可能な役割を一覧表示するには、エンドポイントにリクエストを[`/v1/projects/{projectId}/roles`](https://docs.equinix.com/ja/api-catalog/accessv1/v1-role/listrolesbyprojectid.md)送信します。`GET` サンプルcURLリクエスト: ``` curl -X GET 'https://access.eqix.equinix.com/v1/projects/project:{projectId}/roles' \ -H 'Authorization: Bearer ' ``` 応答には、ロールの ID と割り当てスコープが含まれます。 `assignmentScope.type`このフィールドには、その役割に許可されている割り当て範囲が次のリストから一覧表示されます。`assignmentScopeType=PDS_ORG``assignmentScopeType=ORGANIZATION`、、`assignmentScopeType=PROJECT`、、`assignmentScopeType=BILLING_ACCOUNT`、`assignmentScopeType=SUBSCRIPTION_KEY``assignmentScopeType=PORT`です。は、`assignmentScope.id`そのスコープの一意のIDです。 役割割り当てを作成するときは、プロジェクトIDとスコープ情報を指定する必要があります。 ## 役割割り当ての作成[​](#役割割り当ての作成 "への直接リンク役割割り当ての作成") 役割の割り当てを作成するには、エンドポイントにリクエストを[`/v1/roleAssignments`](https://docs.equinix.com/ja/api-catalog/accessv1/v1-role-assignment/createroleassignment.md)送信します。`POST` サンプルcURLリクエスト: ``` curl -X POST 'https://access.eqix.equinix.com/v1/roleAssignments' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "principal": "", "roleId": "", "assignmentScope": { "id": "", "type": "" } }' ``` ## 役割割り当ての一覧[​](#役割割り当ての一覧 "への直接リンク役割割り当ての一覧") 割り当てスコープタイプのすべての役割割り当てを一覧表示するには、エンドポイントにリクエストを[`/v1/roleAssignments`](https://docs.equinix.com/ja/api-catalog/accessv1/v1-role-assignment/listroleassignments.md)送信します。`GET`と`assignmentScopeType`クエリパラメータを使用して、`assignmentScopeId`応答を指定されたスコープタイプに制限します。 サンプルcURLリクエスト: ``` curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments?assignmentScopeId=&assignmentScopeType=' \ -H 'Authorization: Bearer ' ``` ## 役割割り当ての詳細を取得[​](#役割割り当ての詳細を取得 "への直接リンク役割割り当ての詳細を取得") 特定の役割割り当ての詳細を取得するには、エンドポイントにリクエストを[`/v1/roleAssignments/{roleAssignmentId}`](https://docs.equinix.com/ja/api-catalog/accessv1/v1-role-assignment/getroleassignment.md)送信します。`GET` サンプルcURLリクエスト: ``` curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments/{roleassignment:roleAssignmentId}' \ -H 'Authorization: Bearer ' ``` ## 役割割り当ての削除[​](#役割割り当ての削除 "への直接リンク役割割り当ての削除") 役割の割り当てを削除すると、OIDCユーザーはその役割によって付与された権限へのアクセス権を失います。役割の割り当てを削除するには、エンドポイントにリクエストを[`/v1/roleAssignments/{roleAssignmentId}`](https://docs.equinix.com/ja/api-catalog/accessv1/v1-role-assignment/deleteroleassignment.md)送信します。`DELETE` サンプルcURLリクエスト: ``` curl -X DELETE 'https://access.eqix.equinix.com/v1/roleAssignments/roleassignment:{roleAssignmentId}' \ -H 'Authorization: Bearer ' ```