# OIDC 和角色 如果您正在使用基于角色的访问控制,则可以分配OIDC主要角色,以授予他们对您的Equinix基础设施的访问权限。OIDC主体执行[令牌交换](https://docs.equinix.com/zh-Hans/equinix-api/oidc-api-authentication.md)时,请使用`roleassignments:`for the Scope参数。如果主体在组织中分配了角色,令牌交换将颁发一个承载令牌。 分配和管理角色所需的权限包括: * 角色访问控制-`IAM Admin`角色。 * 基于属性的访问控制-包含以下内容的访问策略:`use/createRoleAssignment`,`use/listRoleAssignments` `use/getRoleAssignment`,`use/deleteRoleAssignment`。 ## 现有职位[​](#现有职位 "直接链接至现有职位") 要列出所有角色,请向端点发送`GET`请求[`/v1/roles`](https://docs.equinix.com/zh-Hans/api-catalog/accessv1/v1-role/listroles.md)。 cURL 请求示例: ``` curl -X GET 'https://access.eqix.equinix.com/v1/roles' \ -H 'Authorization: Bearer ' ``` 要列出特定项目中可用的角色,请向端点发送`GET`请求[`/v1/projects/{projectId}/roles`](https://docs.equinix.com/zh-Hans/api-catalog/accessv1/v1-role/listrolesbyprojectid.md)。 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 和范围信息。 ## 创建角色分配[​](#创建角色分配 "直接链接至创建角色分配") 要创建角色分配,请向端点发送`POST`请求[`/v1/roleAssignments`](https://docs.equinix.com/zh-Hans/api-catalog/accessv1/v1-role-assignment/createroleassignment.md)。 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": "" } }' ``` ## 列出角色分配[​](#列出角色分配 "直接链接至列出角色分配") 要列出分配范围类型的所有角色分配,请向端点发送`GET`请求[`/v1/roleAssignments`](https://docs.equinix.com/zh-Hans/api-catalog/accessv1/v1-role-assignment/listroleassignments.md)。使用`assignmentScopeId`AND`assignmentScopeType`查询参数将响应限制为指定的范围类型。 cURL 请求示例: ``` curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments?assignmentScopeId=&assignmentScopeType=' \ -H 'Authorization: Bearer ' ``` ## 获取角色分配详情[​](#获取角色分配详情 "直接链接至获取角色分配详情") 要获取特定角色分配的详细信息,请向端点发送`GET`请求[`/v1/roleAssignments/{roleAssignmentId}`](https://docs.equinix.com/zh-Hans/api-catalog/accessv1/v1-role-assignment/getroleassignment.md)。 cURL 请求示例: ``` curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments/{roleassignment:roleAssignmentId}' \ -H 'Authorization: Bearer ' ``` ## 删除角色分配[​](#删除角色分配 "直接链接至删除角色分配") 删除角色分配后,OIDC用户将失去该角色授予的权限。要删除角色分配,请向端点发送`DELETE`请求[`/v1/roleAssignments/{roleAssignmentId}`](https://docs.equinix.com/zh-Hans/api-catalog/accessv1/v1-role-assignment/deleteroleassignment.md)。 cURL 请求示例: ``` curl -X DELETE 'https://access.eqix.equinix.com/v1/roleAssignments/roleassignment:{roleAssignmentId}' \ -H 'Authorization: Bearer ' ```