# Fournisseur Equinix Le fournisseur Equinix est utilisé pour interagir avec les ressources fournies par la plateforme Equinix. Le fournisseur doit être configuré avec les identifiants appropriés avant de pouvoir être utilisé. Pour plus d'informations sur l'obtention de la clé API et du secret requis pour Equinix Fabric et Network Edge, reportez-vous à la section [génération d'un identifiant client et d'une clé secrète client](https://docs.equinix.com/equinix-api/api-authentication/) à partir [du portail de la plateforme pour développeurs Equinix](https://docs.equinix.com) . Equinix Fabric prend également en charge l'authentification à l'aide d'un [jeton d'identité de charge de travail](https://developer.hashicorp.com/terraform/cloud-docs/workspaces/dynamic-provider-credentials/workload-identity-tokens) , qui peut être utilisé à la place des `client_id`arguments et `client_secret`. Nécessite un périmètre d’autorisation et un jeton OIDC d’un fournisseur d’identité approuvé par les STS Equinix. Il s'agit d'une fonctionnalité alpha qui n'est pas disponible pour tous les utilisateurs. L'utilisation de jetons d'identité de charge de travail remplacera l'identifiant/secret du client. Vous devez utiliser [des alias de fournisseur](https://developer.hashicorp.com/terraform/language/providers/configuration#alias-multiple-provider-configurations) pour gérer à la fois les jetons d'identité de charge de travail et l'identifiant/secret du client dans une seule configuration Terraform. Utilisez la navigation à gauche pour découvrir les ressources disponibles. ## Exemple d'utilisation[​](#exemple-dutilisation "Lien direct vers Exemple d'utilisation") Exemple de HCL avec [configuration de fournisseur](https://developer.hashicorp.com/terraform/language/providers/configuration) et [définition de fournisseurs requise](https://developer.hashicorp.com/terraform/language/providers/requirements) : ``` terraform { required_providers { equinix = { source = "equinix/equinix" } } } # Credentials for all Equinix resources provider "equinix" { client_id = "someEquinixAPIClientID" client_secret = "someEquinixAPIClientSecret" } ``` Les jetons d'identité de charge de travail peuvent être utilisés dans des scénarios d'autorisation de service, tels que HCP Terraform. Lors de l'utilisation de cette méthode, d'autres variables d'informations d'identification sont facultatives pour les `equinix_fabric_*` ressources et les sources de données. ``` # Configuration for using Workload Identity Federation provider "equinix" { # Desired scope of the requested security token. Must be an Access Policy ERN or a string of the form `roleassignments:` token_exchange_scope = "roleassignments:" # The name of the environment variable containing the token exchange subject token # For example, HCP Terraform automatically sets TFC_WORKLOAD_IDENTITY_TOKEN token_exchange_subject_token_env_var = "TFC_WORKLOAD_IDENTITY_TOKEN" } ``` Exemple de configuration de fournisseur à l'aide `environment variables`de : ``` export EQUINIX_API_CLIENTID=someEquinixAPIClientID export EQUINIX_API_CLIENTSECRET=someEquinixAPIClientSecret ``` ### Authentification par jeton[​](#authentification-par-jeton "Lien direct vers Authentification par jeton") Les jetons peuvent être générés pour le client API à l'aide des fonctionnalités de jetons OAuth2 décrites dans la documentation OAuth2 [API](https://docs.equinix.com/api-catalog/accesstokenv1#operation/GetOAuth2AccessToken). Les jetons API peuvent être fournis à l'aide de l'`token`argument Provider ou de la `EQUINIX_API_TOKEN`variable evironnement. Les `client_id`arguments et `client_secret`seront ignorés en présence d'un `token` argument. Pour plus de détails sur les pratiques de test recommandées, consultez le guide de[test Equinix API](https://docs.equinix.com/equinix-api/testing). ``` provider "equinix" { token = "someToken" } ``` ## Référence de l'argument[​](#référence-de-largument "Lien direct vers Référence de l'argument") Le fournisseur Equinix nécessite quelques paramètres de base. Bien que les arguments d'authentification soient facultatifs individuellement, soit `token` ou `client_id` et `client_secret` doivent être définis via des arguments ou des paramètres d'environnement pour interagir avec les services Equinix Fabric et Network Edge. Ces paramètres peuvent être fournis dans [des fichiers variables Terraform](https://developer.hashicorp.com/terraform/language/values/variables#variable-definitions-tfvars-files) ou en tant que variables d'environnement. Il [n'](https://developer.hashicorp.com/terraform/language/state/sensitive-data)est [pas recommandé de conserver les données sensibles dans des fichiers texte brut](https://developer.hashicorp.com/terraform/language/state/sensitive-data) . ## Schéma[​](#schéma "Lien direct vers Schéma") ### Facultatif[​](#facultatif "Lien direct vers Facultatif") * `client_id` (String) clé client API disponible sous « mes applications » dans Developer Portal. Cet argument peut également être spécifié avec la `EQUINIX_API_CLIENTID`variable d'environnement shell. * `client_secret` (String) secret du consommateur API disponible sous « mes applications » dans Developer Portal. Cet argument peut également être spécifié avec la `EQUINIX_API_CLIENTSECRET`variable d'environnement shell. * `endpoint` (String) URL de base Equinix API pour indiquer l'environnement souhaité. Cet argument peut également être spécifié avec la `EQUINIX_API_ENDPOINT`variable d'environnement shell. (Valeur par défaut `https://api.equinix.com`) * `max_retries` (Number) nombre maximal de tentatives en cas de panne du réseau. * `max_retry_wait_seconds` (Number) nombre maximal de secondes à attendre avant de réessayer une demande. * `request_timeout` (Nombre) durée, en secondes, pendant laquelle le client API de la plateforme Equinix doit attendre avant d'annuler une demande API. Les demandes annulées peuvent tout de même entraîner le provisionnement de ressources. (Valeur par défaut `30`) * `response_max_page_size` (Nombre) nombre maximal d'enregistrements dans une seule réponse pour les requêtes REST qui produisent des réponses paginées. (La valeur par défaut est spécifique au client) * `sts_endpoint` (Chaîne) URL de base API STS pour pointer vers l'environnement souhaité. Cet argument peut également être spécifié avec la `EQUINIX_STS_ENDPOINT`variable d'environnement shell. (Valeur par défaut `https://sts.eqix.equinix.com`). STS est une fonctionnalité alpha qui n'est pas disponible pour tous les utilisateurs. * `token` (Chaîne) les jetons API sont générés à partir de clients consommateurs API à l'aide de l'[API OAuth2](https://docs.equinix.com/equinix-api/api-authentication/) . Cet argument peut également être spécifié avec la `EQUINIX_API_TOKEN`variable d'environnement shell. * `token_exchange_scope` (Chaîne) portée du jeton d'authentification. Il doit s'agir d'un ERN de politique d'accès ou d'une chaîne du formulaire `roleassignments:`. Cet argument peut également être spécifié avec la `EQUINIX_TOKEN_EXCHANGE_SCOPE`variable d'environnement shell. L’échange de jetons est une fonctionnalité alpha qui n’est pas disponible pour tous les utilisateurs. * `token_exchange_subject_token` (Chaîne) jeton d'objet à utiliser pour l'authentification d'échange de jetons. Il doit s'agir d'un jeton d'identifiant OIDC émis par un fournisseur OIDC approuvé par Equinix STS. Si elle n'est pas définie, le fournisseur utilisera la variable d'environnement spécifiée dans `token_exchange_subject_token_env_var`. L’échange de jetons est une fonctionnalité alpha qui n’est pas disponible pour tous les utilisateurs. * `token_exchange_subject_token_env_var` (Chaîne) nom de la variable d'environnement contenant le jeton d'objet pour l'échange de jetons. Cet argument peut également être spécifié avec la `EQUINIX_TOKEN_EXCHANGE_SUBJECT_TOKEN_ENV_VAR`variable d'environnement shell. (Valeur par défaut `EQUINIX_TOKEN_EXCHANGE_SUBJECT_TOKEN`). L’échange de jetons est une fonctionnalité alpha qui n’est pas disponible pour tous les utilisateurs.