Configurer un fournisseur téléphonique personnalisé avec Terraform

Découvrez comment configurer un fournisseur téléphonique personnalisé à l’aide du provider Auth0 pour Terraform

Vous pouvez configurer un fournisseur téléphonique personnalisé à l’aide du provider Auth0 pour Terraform. Le provider Auth0 pour Terraform sert à interagir avec la Auth0 Management API afin de configurer un locataire Auth0. Pour en savoir plus, consultez la documentation du provider Auth0 pour Terraform.

• Si vous utilisez Terraform pour configurer un fournisseur téléphonique personnalisé, supprimez le fournisseur de téléphone personnalisé existant de votre locataire Auth0.
• Auth0 impose une limite d’une seule Action pour les Actions associées aux déclencheurs suivants : custom-phone-provider et custom-email-provider.

Les étapes suivantes expliquent comment configurer un fournisseur téléphonique personnalisé avec Terraform :

1. Créez une auth0_action :

resource "auth0_action" "custom_phone_provider" {
  name    = "Custom Phone Provider"
  runtime = "node22"
  deploy  = true
  code    = <<-EOT
    /**
    * Gestionnaire à exécuter lors de l'envoi d'une notification téléphonique
    * @param {Event} event - Détails sur l'utilisateur et le contexte dans lequel il se connecte.
    * @param {CustomPhoneProviderAPI} api - Méthodes et utilitaires pour modifier le comportement de l'envoi d'une notification téléphonique.
    */
    exports.onExecuteCustomPhoneProvider = async (event, api) => {
      // Le code va ici
      return;
    };
  EOT
  supported_triggers {
    id      = "custom-phone-provider"
    version = "v1"
  }
}

Pour associer un auth0_action Terraform à un auth0_trigger_action, définissez auth0_action avec deploy = true. Pour en savoir plus, consultez la documentation de Terraform sur auth0_action.

2. Associez le auth0_action au auth0_trigger_action custom-phone-provider :

resource "auth0_trigger_action" "custom_phone_provider" {
  trigger = "custom-phone-provider"
  actions {
    id           = auth0_action.custom_phone_provider.id
    display_name = auth0_action.custom_phone_provider.name
  }
  depends_on = [
    auth0_action.custom_phone_provider
  ]
}

3. Configurez la ressource auth0_phone_provider pour utiliser auth0_action :

resource "auth0_phone_provider" "custom_phone_provider" {
  depends_on = [auth0_trigger_actions.custom_phone_provider] # S'assurer que l'action est créée en premier avec `custom-phone-provider` comme supported_triggers
  name       = "custom"                         # Indique une implémentation personnalisée
  disabled   = false                            # Désactive le fournisseur de téléphone par défaut
  configuration {
    delivery_methods = ["text", "voice"]
  }
  credentials {}
},

Pour en savoir plus, consultez la documentation Terraform sur auth0_phone_provider.

​

Dépannage

Scénario : le fournisseur téléphonique personnalisé configuré à l’aide de Terraform n’est pas appliqué, et le Auth0 Dashboard affiche une autre Action.

Il se peut que vous ayez plusieurs Actions de fournisseur personnalisé avec deploy: true. Auth0 autorise au maximum une seule Action pour les Actions associées aux déclencheurs suivants : custom-phone-provider et custom-email-provider.

• Si vous rencontrez ce scénario, nous vous recommandons de répertorier vos Actions afin d’identifier les doublons à supprimer.
• Si vous rencontrez ce scénario après avoir géré vos fournisseurs personnalisés à l’aide de plusieurs méthodes (Terraform, Auth0 Dashboard, Management API et/ou les SDK Auth0), il est conseillé de réinitialiser la configuration du fournisseur personnalisé. Nous vous recommandons d’éviter d’utiliser plusieurs méthodes pour gérer votre fournisseur personnalisé.

Pour réinitialiser le fournisseur téléphonique personnalisé, accédez à Auth0 Dashboard > Branding > Phone Provider. Ensuite, sélectionnez le bouton Reset dans la section Configuration du fournisseur pour rétablir votre fournisseur personnalisé à sa configuration par défaut.