OIDC e Funções
Se você estiver usando controle de acesso baseado em funções, poderá atribuir funções principais do OIDC para dar acesso à sua infraestrutura Equinix. Em seguida, quando o principal do OIDC realizar uma troca de token , use o roleassignments:<org-id> para o parâmetro Scope. Se o principal tiver atribuições de função na organização, a troca de tokens emitirá um token ao portador.
As permissões necessárias para atribuir e gerenciar funções são:
- Controle de acesso baseado em função - A
IAM Adminfunção. - Controle de acesso baseado em atributos - uma política de acesso que contém:
use/createRoleAssignment,use/listRoleAssignments,use/getRoleAssignment,use/deleteRoleAssignment.
Vagas disponíveis
Para listar todas as funções, envie uma GET solicitação para o /v1/roles terminal.
Exemplo de solicitação cURL:
curl -X GET 'https://access.eqix.equinix.com/v1/roles' \
-H 'Authorization: Bearer <token>'
Para listar as funções disponíveis em um projeto específico, envie uma GET solicitação para o /v1/projects/{projectId}/roles terminal.
Exemplo de solicitação cURL:
curl -X GET 'https://access.eqix.equinix.com/v1/projects/project:{projectId}/roles' \
-H 'Authorization: Bearer <token>'
A resposta contém o ID da função e o escopo da atribuição.
O assignmentScope.type campo lista os possíveis escopos de atribuição permitidos para essa função na seguinte lista: assignmentScopeType=PDS_ORG``assignmentScopeType=ORGANIZATION, , assignmentScopeType=PROJECT, assignmentScopeType=BILLING_ACCOUNT, assignmentScopeType=SUBSCRIPTION_KEY, , assignmentScopeType=PORT. O assignmentScope.id é o ID exclusivo desse escopo.
Ao criar uma atribuição de função, você precisa especificar o ID do projeto e as informações de escopo.
Criar uma atribuição de função
Para criar uma atribuição de função, envie uma POST solicitação para o /v1/roleAssignments terminal.
Exemplo de solicitação 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>"
}
}'
Lista de atribuições de funções
Para listar todas as atribuições de função para um tipo de escopo de atribuição, envie uma GET solicitação ao /v1/roleAssignmentsterminal. Use os assignmentScopeIdparâmetros de consulta e assignmentScopeTypepara limitar a resposta ao tipo de escopo especificado.
Exemplo de solicitação cURL:
curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments?assignmentScopeId=<assignment_scope_id>&assignmentScopeType=<assignment_scope_type>' \
-H 'Authorization: Bearer <token>'
Obtenha detalhes sobre a atribuição de função.
Para obter os detalhes de uma atribuição de função específica, envie uma GET solicitação para o /v1/roleAssignments/{roleAssignmentId} terminal.
Exemplo de solicitação cURL:
curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments/{roleassignment:roleAssignmentId}' \
-H 'Authorization: Bearer <token>'
Excluir uma atribuição de função
Ao excluir uma atribuição de função, o usuário do OIDC perde o acesso às permissões concedidas pela função. Para excluir uma atribuição de função, envie uma DELETE solicitação ao /v1/roleAssignments/{roleAssignmentId} terminal.
Exemplo de solicitação cURL:
curl -X DELETE 'https://access.eqix.equinix.com/v1/roleAssignments/roleassignment:{roleAssignmentId}' \
-H 'Authorization: Bearer <token>'