HelperStable

Obtenir une URL de parcours utilisateur

Crée un grant d’accès pour un participant du processus et expose l’URL protégée qui lui permet d’ouvrir son parcours utilisateur.

Participant + durée
Obtenir une URL de parcours utilisateur
Grant participant
URL protégée

Vue d’ensemble

Utilisez ce node lorsqu’une URL doit être produite à l’intérieur du processus — par exemple avant une notification. Pour une intégration qui demande directement une URL depuis l’API, utilisez plutôt le contrat public journey-link documenté avec les parcours utilisateurs.

Exemple

Créer l’accès du participant approver, puis transmettre l’URL par un node de notification compatible avec les règles de protection des secrets.

Paramètres 2

participantRequisstring
Participant déclaré pour lequel l’accès au parcours utilisateur doit être créé.
expires_inOptionnelduration
Durée ISO 8601 de validité du grant. La valeur par défaut du node est PT24H lorsqu’aucune durée n’est fournie.

Sorties 4

urlurl
URL porteuse du grant d’accès du participant. Cette valeur est classifiée secret et doit être transmise uniquement à son destinataire légitime.
participant_keystring
Clé du participant pour lequel le grant a été créé.
expires_atdatetime
Date et heure d’expiration de ce grant d’accès.
access_grant_idstring
Identifiant du grant sous-jacent, utile pour la traçabilité sans exposer son URL secrète.

Comportement

Résoudre le participant

Le node utilise la clé du participant de l’instance courante.

Créer le grant

La durée ISO fournie est convertie en durée de validité et un grant dédié est créé.

Protéger l’URL

L’URL est conservée comme donnée secrète dérivée ; la trace peut s’appuyer sur access_grant_id sans révéler le bearer URL.

À retenir Posséder l’URL suffit à exercer les droits du grant. Ne l’enregistrez pas dans une metadata normale et ne l’affichez pas dans des surfaces non prévues pour des secrets.

Limites et responsabilités

  • Le node fonctionne dans le contexte d’une instance et d’un participant ; il n’est pas un générateur d’URL public générique.
  • La durée doit être une durée ISO 8601 valide.
  • Créer un accès ne complète aucune action utilisateur : il permet seulement au participant d’ouvrir l’expérience correspondante.