Envoyer un message téléphonique

Découvrez les Actions Envoyer un message téléphonique, qui s’exécutent pendant les processus d’inscription et de vérification lorsque les SMS ou la voix sont utilisés comme facteurs d’authentification multifacteur (MFA).

Le déclencheur send-phone-message s’exécute lorsque vous utilisez les SMS ou la voix comme facteur pour l’authentification multifacteur (MFA). Il s’exécute pour les processus d’inscription et de vérification (event.message_options.action), ainsi que pour le type de message voice lorsque vous utilisez la nouvelle expérience de Universal Login (event.message_options.message_type === 'voice'). Lorsque vous utilisez un fournisseur personnalisé pour envoyer les messages, ce déclencheur est nécessaire à la configuration de votre fournisseur personnalisé.

Les Actions de ce flux sont bloquantes (synchrones) : elles s’exécutent dans le cadre du processus du déclencheur et empêchent le reste du pipeline Auth0 de s’exécuter jusqu’à ce que l’Action soit terminée.

​

Références

• Objet Event : Fournit des renseignements contextuels sur le message à envoyer et l’utilisateur auquel envoyer une demande de vérification ou à inscrire.
• Objet API : Fournit des méthodes permettant de modifier le comportement du flux.

​

Cas d’utilisation courants

​

Utiliser un fournisseur SMS personnalisé

Une action send-phone-message permet d’envoyer des messages MFA au moyen d’un fournisseur SMS personnalisé :

const AWS = require("aws-sdk");

/**
 * @param {Event} event - Renseignements sur l’utilisateur et le contexte dans lequel il se connecte.
 */
exports.onExecuteSendPhoneMessage = async (event) => {
  const text = event.message_options.text;
  const recipient = event.message_options.recipient;

  const awsSNS = new AWS.SNS({
    apiVersion: "2010-03-31",
    region: event.secrets.AWS_REGION,
    credentials: new AWS.Credentials(event.secrets.AWS_ACCESS_KEY_ID, event.secrets.AWS_SECRET_ACCESS_KEY)
  });

  const params = { Message: text, PhoneNumber: recipient };

  return awsSNS
    .publish(params)
    .promise();
};

Pour que cette Action s’exécute correctement, elle doit contenir les secrets nommés AWS_REGION, AWS_ACCESS_KEY_ID et AWS_SECRET_ACCESS_KEY, et dépendre du package npm aws-sdk.