Authentification de l'API de l'OIDC
Les API Equinix utilisent le protocole OAuth 2,0 pour authentifier les demandes de votre utilisateur OIDC auprès des terminaux API. Pour interagir avec les API Equinix, vous avez besoin d'un jeton d'accès porteur.
Conditions préalables
-
Un fournisseur OIDC .
-
Un jeton d'identification OIDC de votre fournisseur OIDC enregistré.
-
Autorisations spécifiques au produit ou au service pour spécifier l'étendue du jeton d'accès API. Vous avez besoin de :
ern:<access-policy-ern>où<access-policy-ern>est une stratégie d'accès unique qui a été accordée à l'entité de sécurité.roleassignments:<org-id>Où<org-id>est l'identifiant de l'organisation à laquelle l'entité de sécurité OIDC a attribué des rôles.projectpolicies:<project-id>Où<project-id>est un identifiant de projet pour lequel l'entité de sécurité OIDC a obtenu une ou plusieurs politiques d'accès.orgpolicies:<org-id>Où<org-id>est un identifiant d'organisation pour lequel l'entité de sécurité s'est vu accorder une ou plusieurs stratégies d'accès.orgpolicies:<org-id> roleassignments:<org-id>Où<org-id>est un identifiant d'organisation pour lequel l'entité de sécurité a obtenu à la fois des rôles et des stratégies d'accès.
Pour plus d'informations, reportez-vous à la rubrique étendues de contrôle d'accès .
Demander un jeton d'accès
Pour demander un jeton d’accès porteur, envoyez une POST demande au /v1/tokenpoint final.
Dans le corps de la demande, indiquez :
grant_type- À utiliserurn:ietf:params:oauth:grant-type:token-exchangepour recevoir un jeton d'accès.scope(Obligatoire) - indiquez le champ d'application. Les autorisations accordées par le jeton sont vérifiées par rapport au fait que l'entité de sécurité a reçu les rôles ou les stratégies d'accès appropriés. Pour plus d'informations, reportez-vous à la rubrique étendues de contrôle d'accès .subject_token- Le jeton d'identifiant OIDC.subject_token_type- Utilisationurn:ietf:params:oauth:token-type:id_tokenqui identifie votresubject_tokencomme jeton d'identifiant OIDC.
Exemple de requête 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>'
Utilisation de jetons d'accès
Pour interagir avec Equinix API, envoyez votre jeton d’accès dans l’en-tête autorisation de la demande HTTP avec Authorization: Bearer <token>.