(Hérité) Connexion et déconnexion sans actualisation tefresh-less-login-and-logout

Vue d’ensemble overview

Pour les applications web, vous devez tenir compte de différents scénarios possibles pour l’authentification et la déconnexion des utilisateurs. Les fichiers MVPD exigent que les utilisateurs se connectent à la page web MVPD pour s’authentifier, avec les facteurs supplémentaires suivants en jeu :

Avant l’authentification Adobe Pass 2.7, tous ces scénarios d’authentification d’un utilisateur impliquaient une actualisation complète de la page du programmeur. Pour la version 2.7 et les versions ultérieures, l’équipe Authentification Adobe Pass a amélioré ces flux afin que l’utilisateur n’ait pas à effectuer une actualisation de la page de votre application lors de la connexion et de la déconnexion.

Description détaillée detailed_description

Commençons par un résumé des flux d’authentification et de déconnexion d’origine, puis suivons avec les flux d’authentification et de déconnexion améliorés. Notez que les quatre premières sections traitent des fichiers MVPD normaux (non-TempPass), tandis que la dernière section décrit l’implémentation spéciale qui doit être appliquée à TempPass :

Flux d’authentification/de déconnexion d’origine orig_authn

Authentification

Les clients web Adobe Pass Authentication disposent de deux méthodes d’authentification, selon les exigences des fichiers MVPD :

Le rappel displayProviderDialog (déclenché par getAuthentication/getAuthorization) renvoie une liste de fichiers MVPD et leurs paramètres appropriés. La propriété iFrameRequired d’un MVPD permet au programmeur de savoir s’il doit activer le flux 1 ou le flux 2. Notez que le programmeur doit effectuer une action supplémentaire (créer un iFrame/une fenêtre contextuelle) uniquement pour le flux 2.

Annuler l’authentification

Il existe également une situation dans laquelle l’utilisateur ou l’utilisatrice annule explicitement le flux d’authentification en fermant la page de connexion. Voici les scénarios et la solution proposée pour les programmeurs :

Flux de déconnexion d’origine orig_logout

L’API de déconnexion d’AccessEnabler efface le statut local de la bibliothèque et charge l’URL de déconnexion MVPD dans l’onglet/la fenêtre active. Le navigateur accède au point d’entrée de déconnexion MVPD. Une fois le processus terminé, l’utilisateur est redirigé vers le site web du programmeur. La seule action requise de la part de l’utilisateur est d’appuyer sur le bouton/lien de déconnexion et de lancer le flux ; aucune interaction utilisateur n’est requise sur le point d’entrée de déconnexion MVPD.

Authentification D’Origine/Flux De Déconnexion Avec Actualisation De Page

Amélioration de l’authentification (sans actualisation) improved_authn

Les flux d’authentification (connexion) et de déconnexion décrits ci-dessus offrent à l’utilisateur une expérience similaire en rechargeant la page principale une fois chaque flux terminé. La fonctionnalité actuelle vise à améliorer l’expérience utilisateur en fournissant une connexion et une déconnexion sans actualisation (en arrière-plan). Le programmeur peut activer/désactiver la connexion et la déconnexion en arrière-plan en transmettant deux indicateurs booléens (backgroundLogin et backgroundLogout) au paramètre configInfo de l’API setRequestor. Par défaut, la connexion/déconnexion en arrière-plan est désactivée (ce qui permet d’assurer la compatibilité avec la mise en œuvre précédente).

Exemple:

    var configInfo = {
        callSetConfig: true,
        backgroundLogin: true,
        backgroundLogout: true
    };
    accessEnabler.setRequestor(REQUESTOR_ID, null, configInfo);

Authentification

Les points suivants décrivent la transition entre les flux d’authentification d’origine et les flux améliorés :

Annuler l’authentification

Voici les flux permettant d’annuler l’authentification :

Flux de déconnexion amélioré improved_logout

Le nouveau flux de déconnexion sera exécuté dans un iFrame masqué, ce qui élimine la redirection de la page entière. Cela est possible, car l’utilisateur n’a pas besoin d’effectuer d’action spécifique sur la page de déconnexion de MVPD.

Une fois le flux de déconnexion terminé, il redirige l’iFrame vers un point d’entrée d’authentification Adobe Pass personnalisé. Cela servira un extrait de code JS qui effectue un window.postMessage au parent, informant l'AccessEnabler que la déconnexion est terminée. Les rappels suivants sont déclenchés : setAuthenticationStatus() et sendTrackingData(AUTHENTICATION_DETECTION ...), signalant que l’utilisateur n’est plus authentifié.

L’illustration ci-dessous montre le flux sans actualisation qui permet à un utilisateur de se connecter à son MVPD sans actualiser la page principale de votre application :

Amélioration du flux d’authentification/de déconnexion (sans actualisation)

Flux TempPass improved_temppas

La connexion sans actualisation suit une approche différente pour les fichiers MVPD de type TempPass.

Comme le flux TempPass exige qu'une fenêtre soit créée automatiquement et fermée sans interaction explicite de l'utilisateur, cela peut poser un problème pour certains navigateurs (bloqueurs de fenêtres contextuelles). Par conséquent, AccessEnabler implémente la phase de connexion en arrière-plan, sans avoir besoin d’un conteneur web créé par le programmeur.

Voici les aspects que le programmeur doit prendre en compte lors de l’implémentation de TempPass pour la connexion et la déconnexion sans actualisation :

L’exemple de code suivant montre comment gérer une fenêtre MVPD sur le site Web d’un programmeur (pour les MVPD standard et pour TempPass) :

    var aeHostname = "https://entitlement.auth.adobe.com";
    var mvpdWindow = null;
    var mvpd = <mvpd_object_from_displayProviderDialog>;
    var useIframeLogin = <boolean_depending_on_browser_or_Programmer_preferences>;
    var backgroundLogin = <boolean_depending_on_Programmer_preferences>;

    // Do not create any windows for refreshless and temp pass
    if (!(backgroundLogin && mvpd.tempPass)) {
        if (backgroundLogin && !mvpd.popup) {
            mvpdWindow = window.open(aeHostname, "mvpdwindow");
        } else if (mvpd.popup && !useIframeLogin) {
            var width = mvpd.width;
            var height = mvpd.height;
            // Center on screen
            var top = (document.all) ? window.screenTop : window.screenY + 100;
            var left = (document.all) ? window.screenLeft : window.screenX + window.innerWidth / 2 - width / 2;

            mvpdWindow = window.open(aeHostname, "mvpdframe",
                           "width=" + width + ",height=" + height + ",top=" + top + ",left=" + left);
            // Monitor the mvpd popup for close
            if (!backgroundLogin) {
                clearInterval(cancelTimer);
                cancelTimer = setInterval(function () {
                    if (mvpdWindow && mvpdWindow.closed) {
                        clearInterval(cancelTimer);
                        $('#mvpddiv').hide();
                        accessEnablerAPI.setSelectedProvider(null);
                    }
                }, 200);
            }
        }
    }