Pour encoder l'URL de redirection, l'agent utilise des variables d'environnement Apache et des paramètres de configuration :
Cesparamètres peuvent être configurés dans le manager, dans Paramètres généraux
> Paramètres avancés
> Redirections des agents
.
Les agents utilisent le code d'erreur d'Apache dans les cas suivants :
Ces erreurs peuvent être interceptées via la directive ErrorDocument
d'Apache pour rediriger les utilisateurs vers une page spécifique :
# Common error page and security parameters ErrorDocument 403 http://auth.example.com/?lmError=403 ErrorDocument 500 http://auth.example.com/?lmError=500 ErrorDocument 503 http://auth.example.com/?lmError=503
Il est également possible de rediriger les utilisateurs sans utiliser ErrorDocument
: l'agent ne retournera pas les codes 403, 500, 503 mais le code 302 (REDIRECT).
L'utilisateur sera redirigé vers l'URL du portail avec une erreur dans le paramètre lmError
de l'URL.
Ces paramètres peuvent être configurés dans le manager, dans Paramètres généraux
> Paramètres avancés
> Redirections des agents
:
Cette redirection du portail peut être effectuée via le code 303 (See Other) ou par une redirection JavaScript.
Souvent la redirection prend du temps car c'est le premier accès de l'utilisateur à l'application protégée et il faut créer la session applicative ; la redirection JavaScript améliore le ressenti utilisateur en l'informant que l'authentification est réussie et en évitant qu'il clique de nouveau sur le bouton.