- Niveau de l’application
- Niveau du locataire
Le
login_url doit pointer vers une route de l’application qui redirige ultimement vers le point de terminaison /authorize d’Auth0, par exemple https://mycompany.org/login. Notez qu’il doit utiliser https et qu’il ne peut pas pointer vers localhost. login_url peut inclure des paramètres de requête et un fragment d’URI.
Conformément à la spécification OIDC Third Party Initiated Login, le paramètre iss, qui contient l’identifiant de l’émetteur, sera ajouté à login_url en tant que paramètre de chaîne de requête avant la redirection.
URI de connexion dynamiques avec des espaces réservés de métadonnées
initiate_login_uri au niveau de l’application pour y inclure des espaces réservés de métadonnées. Ces espaces réservés sont remplacés dynamiquement au moment de l’exécution.
Espaces réservés pris en charge
| Espace réservé | Source | Exemple |
|---|---|---|
{custom_domain.metadata.KEY} | Métadonnées du domaine personnalisé utilisé dans la requête | https://{custom_domain.metadata.public_app_host}/login |
{organization.metadata.KEY} | Métadonnées de l’Organisation associée à la requête | https://{organization.metadata.public_login_host}/login |
public_ (par exemple, public_app_host). Les deux types d’espaces réservés peuvent être combinés dans la même URI si la requête comprend à la fois un domaine personnalisé et un contexte d’Organisation.
Pour consulter la liste complète des règles de validation et des restrictions, consultez Espaces réservés d’URL de domaine personnalisé.
Les espaces réservés de métadonnées sont pris en charge uniquement dans le
initiate_login_uri au niveau de l’application, et non dans le default_redirection_uri au niveau du locataire.Comportement de repli
default_redirection_uri du locataire comme solution de repli si un espace réservé ne peut pas être résolu. Par exemple, si l’Organisation est inconnue ou si la clé de métadonnées n’existe pas. Si le default_redirection_uri n’est pas non plus configuré, Auth0 affiche une page d’erreur. Nous recommandons de configurer un default_redirection_uri au niveau du locataire comme solution de repli fiable.
Scénarios de redirection pour la route de connexion par défaut
Les utilisateurs ajoutent la page de connexion à leurs favoris
https://{yourDomain}/authorize avec un ensemble de paramètres requis. Auth0 redirige ensuite les utilisateurs finaux vers une page https://{yourDomain}/login, avec une URL semblable à celle-ci :
https://{yourDomain}/login?state=g6Fo2SBjNTRyanlVa3ZqeHN4d1htTnh&...
Le paramètre state pointe vers un enregistrement dans une base de données interne où nous suivons l’état de la transaction d’autorisation. Une fois la transaction terminée, ou après un certain délai, l’enregistrement est supprimé de la base de données interne.
Si vous utilisez les Organisations et que l’utilisateur final ajoute l’invite de connexion de l’organisation à ses favoris, Auth0 inclut aussi le paramètre organization lorsqu’il redirige l’utilisateur vers la route de connexion par défaut.
Il arrive que des utilisateurs ajoutent la page de connexion à leurs favoris et que, lorsqu’ils accèdent à l’URL /login enregistrée, l’enregistrement de transaction n’existe plus et qu’Auth0 ne puisse pas poursuivre le flux de connexion. Dans ce cas, Auth0 redirige vers l’URL par défaut de l’application si elle est configurée, ou vers l’URL du locataire dans le cas contraire. Si aucune URL de connexion par défaut n’est définie, Auth0 affiche une page d’erreur.
Flux complet de réinitialisation du mot de passe
/post-password-change prend en charge la redirection des utilisateurs vers une application précise. Lorsque client_id est spécifié et que l’URI de connexion de l’application est définie, les utilisateurs verront un bouton qui les ramènera à l’application après la réinitialisation du mot de passe.
Flux complet de vérification du courriel
Inviter des membres d’une organisation
https://myapp.com/login, le lien envoyé dans le courriel d’invitation que reçoit l’utilisateur final sera le suivant : https://myapp.com/login?invitation={invitation_ticket_id}&organization={organization_id}&organization_name={organization_name}.
Ainsi, la route de votre application doit accepter les paramètres invitation et organization dans la chaîne de requête. Pour démarrer la transaction d’acceptation de l’invitation, elle doit transmettre ces deux paramètres, avec l’utilisateur final, à votre point de terminaison Auth0 /authorize.
Si un utilisateur accède à https://{yourDomain}/authorize alors que les témoins sont désactivés dans son navigateur, Auth0 redirige l’utilisateur vers l’URI de connexion de l’application. Si l’URI de connexion de l’application n’est pas définie, la redirection est plutôt envoyée vers l’URI de connexion du locataire.
Renvoyer l’utilisateur à la page de connexion peut entraîner une boucle de redirection. Pour éviter ce problème, utilisez une page de destination pour vérifier la disponibilité des témoins; s’ils sont désactivés, avertissez l’utilisateur qu’il doit les activer s’il souhaite continuer.