Autenticação da API OIDC
As APIs da Equinix usam o protocolo OAuth 2,0 para autenticar as solicitações do seu usuário OIDC para endpoints API. Para interagir com as APIs Equinix, você precisa de um token de acesso ao portador.
Pré-requisitos
-
Um provedor de OIDC .
-
Um token de identificação OIDC do seu provedor OIDC registrado.
-
Permissões específicas do produto ou serviço para especificar o escopo do token de acesso API. Você precisa de:
ern:<access-policy-ern>onde<access-policy-ern>é uma política de acesso único que foi concedida ao principal.roleassignments:<org-id>Onde<org-id>está o ID da organização para a qual o diretor do OIDC atribuiu funções.projectpolicies:<project-id>Onde<project-id>é um ID de projeto em que o principal do OIDC recebeu uma política de acesso ou políticas de acesso.orgpolicies:<org-id>Onde<org-id>é um ID da organização em que o principal recebeu uma política de acesso ou políticas de acesso.orgpolicies:<org-id> roleassignments:<org-id>Onde<org-id>é um ID da organização em que o principal recebeu funções e políticas de acesso.
Para obter mais informações, consulte Escopos de controle de acesso .
Solicitação de um token de acesso
Para solicitar um token de acesso ao portador, envie uma POST solicitação ao /v1/tokenterminal.
No corpo da solicitação, especifique:
grant_type- Useurn:ietf:params:oauth:grant-type:token-exchangepara receber um token de acesso.scope(Obrigatório) - Forneça o escopo. As permissões concedidas pelo token são verificadas em relação ao fato de o principal ter recebido as funções ou políticas de acesso apropriadas. Para obter mais informações, consulte Escopos de controle de acesso .subject_token- O token de ID do OIDC.subject_token_type- Useurn:ietf:params:oauth:token-type:id_tokenque identifica seusubject_tokencomo um token de ID OIDC.
Exemplo de solicitação cURL:
curl -X POST 'https://sts.eqix.equinix.com/v1/token' \
--data-urlencode 'grant_type=urn:ietf:params:oauth:grant-type:token-exchange' \
--data-urlencode 'subject_token_type=urn:ietf:params:oauth:token-type:id_token' \
--data-urlencode 'scope=<role_or_access_policy>' \
--data-urlencode 'subject_token=<oidc_id_token>'
Utilizando tokens de acesso
Para interagir com o Equinix API, envie seu token de acesso no cabeçalho de autorização da solicitação HTTP com Authorization: Bearer <token>.