Pre User Registration

Découvrez les Actions Pre User Registration, qui s’exécutent avant qu’un utilisateur soit ajouté à une connexion Database ou Passwordless. Elles permettent d’ajouter des métadonnées au profil utilisateur avant sa création ou de rejeter un enregistrement.

Le déclencheur pre-user-registration s’exécute lorsqu’un utilisateur tente de s’enregistrer au moyen d’une connexion Database ou Passwordless, avant la création de l’utilisateur. Utilisez ce déclencheur pour ajouter des métadonnées au profil utilisateur avant sa création ou pour rejeter un enregistrement à l’aide d’une logique personnalisée.

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.

Vous ne pouvez actuellement pas utiliser les Actions pre-user-registration pour ajouter des métadonnées aux utilisateurs passwordless.

​

Références

• Objet Event : fournit des informations contextuelles sur la demande d’enregistrement d’un nouvel utilisateur.
• Objet API : fournit des méthodes permettant de modifier le comportement du flux.

​

Cas d’utilisation courants

​

Rejeter l’enregistrement selon l’emplacement

Une Action pre-user-registration peut être utilisée pour empêcher un utilisateur de s’inscrire :

/**
 * @param {Event} event - Détails sur le contexte et l'utilisateur qui tente de s'inscrire.
 * @param {PreUserRegistrationAPI} api - Interface dont les méthodes permettent de modifier le comportement de l'inscription.
 */
exports.onExecutePreUserRegistration = async (event, api) => {
  if (event.request.geoip.continentCode === "NA") {

    // localiser le message d'erreur 
    const LOCALIZED_MESSAGES = {
      en: 'You are not allowed to register.',
      es: 'No tienes permitido registrarte.'
    };

    const userMessage = LOCALIZED_MESSAGES[event.request.language] || LOCALIZED_MESSAGES['en'];
    api.access.deny('no_signups_from_north_america', userMessage);
  }
};

​

Définir des métadonnées dans le profil utilisateur

Une Action pre-user-registration permet d’ajouter des métadonnées au profil utilisateur avant sa création :

/**
 * @param {Event} event - Renseignements sur le contexte et l’utilisateur qui tente de s’inscrire.
 * @param {PreUserRegistrationAPI} api - Interface dont les méthodes permettent de modifier le comportement de l’inscription.
 */
exports.onExecutePreUserRegistration = async (event, api) => {
  api.user.setUserMetadata("screen_name", "username");
};

​

Stocker l’ID utilisateur d’un autre système dans le profil utilisateur

Une Action pre-user-registration peut servir à stocker l’ID utilisateur d’un autre système dans le profil utilisateur :

const axios = require('axios');

const REQUEST_TIMEOUT = 2000; // Exemple de timeout

/**
 * @param {Event} event - Détails sur le contexte et l'utilisateur qui tente de s'inscrire.
 * @param {PreUserRegistrationAPI} api - Interface dont les méthodes permettent de modifier le comportement de l’inscription.
 */
exports.onExecutePreUserRegistration = async (event, api) => {
  try {
    // Définir un secret USER_SERVICE_URL = 'https://yourservice.com'
    const remoteUser = await axios.get(event.secrets.USER_SERVICE_URL, {
      timeout: REQUEST_TIMEOUT,
      params: {
        email: event.user.email 
      }
    });

    if (remoteUser) {
      api.user.setAppMetadata('my-api-user-id', remoteUser.id); 
    }
  } catch (err) {
    api.validation.error('custom_error', 'Custom Error');
  }
};

Pour utiliser une bibliothèque npm telle que axios, vous devez l’ajouter comme dépendance à l’Action. Pour en savoir plus, consultez la section “Ajouter une dépendance” de Write Your First Action.

​

Rejeter l’accès en fonction d’empreintes JA3/JA4 précises

L’objet event.security_context contient les valeurs d’empreinte JA3/JA4 associées à la transaction en cours :

/**
 * @param {Event} event - Détails sur le contexte et l’utilisateur qui tente de s’inscrire.
 * @param {PreUserRegistrationAPI} api - Interface dont les méthodes peuvent être utilisées pour modifier le comportement de l’inscription.
 */
exports.onExecutePreUserRegistration = async (event, api) => {
  const clientJa4 = event?.security_context?.ja4;
  console.log('[ACTION]', {clientJa4});
  const badFingerprints = ['t13d1517h2_8daaf6152771_b6f405a00624','t13d1516h2_8daaf6152771_d8a2da3f94cd'];
  if (clientJa4 && badFingerprints.includes(clientJa4)){
    api.access.deny('suspicious_tls_fingerprint', 'Your TLS fingerprint has been flagged as suspicious');
  }
};