Ir para o conteúdo principal

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 Admin funçã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>'
Esta página foi útil?