Exemples de cas d’utilisation : Actions et authentification sans mot de passe

Découvrez comment utiliser les Actions pour personnaliser les flux d’authentification sans mot de passe, notamment en acheminant les OTP par SMS et par courriel vers des fournisseurs personnalisés.

Les Actions vous permettent d’étendre les connexions sans mot de passe en acheminant l’envoi d’OTP par SMS et par courriel vers des fournisseurs personnalisés. Les Actions Auth0 vous permettent de choisir les services téléphoniques et de courriel qui gèrent vos messages d’authentification.

​

Envoyer un courriel Passwordless avec un fournisseur de courriel personnalisé

Lorsqu’un utilisateur s’authentifie au moyen d’une connexion Passwordless par courriel, Auth0 déclenche l’Action custom-email-provider pour transmettre l’OTP. Utilisez cette Action pour acheminer les messages par l’intermédiaire de n’importe quel service de courriel.

Pour configurer l’Action, accédez à Branding > Email Provider, activez la bascule Use my own email provider, puis sélectionnez l’option Custom Provider. Ajoutez l’adresse par défaut de votre fournisseur personnalisé dans le champ From. Pour en savoir plus, consultez configurer un fournisseur de courriel avec une Action personnalisée.

Dans l’éditeur Actions, utilisez l’exemple suivant.

Vous devez ajouter le endpoint de service de votre fournisseur de courriel au code Actions et la clé API dans l’onglet Secrets de l’éditeur Actions.

/**
 * Gestionnaire appelé lorsqu’Auth0 doit envoyer un OTP par courriel Passwordless.
 * @param {Event} event - Détails de la notification.
 * @param {CustomEmailProviderAPI} api - Méthodes permettant de contrôler le comportement de la notification.
 */
exports.onExecuteCustomEmailProvider = async (event, api) => {
  try {
    const response = await fetch('https://api.example.com/send-email', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${event.secrets.API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        to: event.notification.to,
        from: event.notification.from,
        subject: event.notification.subject,
        html: event.notification.html,
        text: event.notification.text,
      }),
    });

    if (response.status >= 400) {
      api.notification.retry(`Request failed with status: ${response.status}`);
      return;
    }
  } catch (error) {
    api.notification.drop(`Unexpected error: ${error.message}`);
  }
};

Sélectionnez Envoyer un courriel de test pour tester votre configuration.

Pour en savoir plus sur les propriétés d’événement disponibles, consultez Déclencheurs Actions : custom-email-provider - Objet d’événement.

​

Envoyer des SMS sans mot de passe avec un fournisseur de téléphonie personnalisé

Lorsqu’un utilisateur s’authentifie au moyen d’une connexion SMS sans mot de passe, Auth0 déclenche l’Action custom-phone-provider pour envoyer l’OTP. Utilisez cette Action pour acheminer les messages par l’intermédiaire de n’importe quel fournisseur de SMS.

Pour configurer l’Action, accédez à Branding > Phone Provider. Activez Phone Message Provider et sélectionnez l’option Custom. Choisissez Text, Voice ou les deux comme méthode de livraison. Pour en savoir plus, consultez Configurer un fournisseur de téléphonie personnalisé.

Dans l’éditeur Actions, utilisez l’exemple suivant.

Vous devez ajouter l’endpoint de service de votre fournisseur de téléphonie au code Actions, ainsi que la clé API dans l’onglet Secrets de l’éditeur Actions.

/**
 * Gestionnaire appelé lorsque Auth0 doit transmettre un OTP par SMS sans mot de passe.
 * @param {Event} event - Détails de la notification.
 * @param {CustomPhoneProviderAPI} api - Méthodes permettant de contrôler le comportement de la notification.
 */
exports.onExecuteCustomPhoneProvider = async (event, api) => {
  const response = await fetch('https://api.example.com/messages', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${event.secrets.API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      to: event.notification.recipient,
      from: event.notification.from,
      body: event.notification.as_text,
    }),
  });

  if (response.status >= 400) {
    api.notification.retry(`La requête a échoué avec le statut : ${response.status}`);
  }
};

Choisissez Envoyer un message texte pour tester votre configuration.

Pour en savoir plus sur les propriétés d’événement disponibles, consultez Déclencheurs Actions : custom-phone-provider - objet d’événement.

​

En savoir plus

• Configurer un fournisseur de courriel avec une Action personnalisée
• Configurer un fournisseur de téléphonie personnalisé
• Configurer un fournisseur de téléphonie personnalisé avec Twilio Verify
• Configurer une passerelle SMS personnalisée pour les connexions Passwordless
• Utiliser l’expérience téléphonique unifiée pour Passwordless
• Bonnes pratiques relatives aux connexions Passwordless