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