Configurar un proveedor telefónico personalizado con Terraform

Aprenda a configurar un proveedor telefónico personalizado con el proveedor Auth0 de Terraform

Puede configurar un proveedor telefónico personalizado con el proveedor Auth0 de Terraform. El proveedor Auth0 de Terraform se utiliza para interactuar con la Auth0 Management API a fin de configurar un tenant de Auth0. Para obtener más información, consulte la documentación de Terraform sobre Auth0 Provider.

• Si utiliza Terraform para configurar un proveedor telefónico personalizado, elimine el proveedor telefónico personalizado existente de su tenant de Auth0.
• Auth0 tiene un límite máximo de una sola Action para las Actions asociadas a los siguientes desencadenadores: custom-phone-provider y custom-email-provider.

Los siguientes pasos describen cómo configurar un proveedor telefónico personalizado con Terraform:

1. Cree un auth0_action:

resource "auth0_action" "custom_phone_provider" {
  name    = "Custom Phone Provider"
  runtime = "node22"
  deploy  = true
  code    = <<-EOT
    /**
    * Handler que se ejecuta al enviar una notificación telefónica
    * @param {Event} event - Detalles sobre el usuario y el contexto en el que está iniciando sesión.
    * @param {CustomPhoneProviderAPI} api - Métodos y utilidades para modificar el comportamiento del envío de una notificación telefónica.
    */
    exports.onExecuteCustomPhoneProvider = async (event, api) => {
      // El código va aquí
      return;
    };
  EOT
  supported_triggers {
    id      = "custom-phone-provider"
    version = "v1"
  }
}

Para vincular un auth0_action de Terraform a un auth0_trigger_action, establezca deploy = true en auth0_action. Para obtener más información, consulte la documentación de Terraform sobre auth0_action.

2. Vincule el auth0_action al 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. Configure el recurso auth0_phone_provider para usar auth0_action:

resource "auth0_phone_provider" "custom_phone_provider" {
  depends_on = [auth0_trigger_actions.custom_phone_provider] # Asegúrese de que la acción se cree primero con `custom-phone-provider` como supported_triggers
  name       = "custom"                         # Indica una implementación personalizada
  disabled   = false                            # Deshabilita el proveedor telefónico predeterminado
  configuration {
    delivery_methods = ["text", "voice"]
  }
  credentials {}
},

Para obtener más información, consulta la documentación de Terraform para auth0_phone_provider.

​

Solucionar problemas

Escenario: el proveedor telefónico personalizado configurado con Terraform no surte efecto y el Auth0 Dashboard muestra una Action distinta.

Es posible que tenga varias Actions de proveedor personalizado con deploy: true. Auth0 tiene un límite máximo de una Action para las Actions asociadas a los siguientes desencadenadores: custom-phone-provider y custom-email-provider.

• Si se encuentra en este escenario, se recomienda que liste sus Actions para identificar los duplicados que deba eliminar.
• Si se encuentra en este escenario después de administrar sus proveedores personalizados mediante varios métodos (Terraform, Auth0 Dashboard, Management API y/o los SDK de Auth0), es aconsejable restablecer la configuración del proveedor personalizado. Le recomendamos que evite usar varios métodos para administrar su proveedor personalizado.

Para restablecer el proveedor telefónico personalizado, vaya a Auth0 Dashboard > Branding > Phone Provider. Luego, seleccione el botón Reset en Provider Configuration para restaurar su proveedor personalizado a su configuración predeterminada.