(Heredado) Inicio y cierre de sesión sin actualización tefresh-less-login-and-logout

Información general overview

Para las aplicaciones web, debe tener en cuenta diferentes escenarios posibles para autenticar y cerrar la sesión de los usuarios. Las MVPD requieren que los usuarios inicien sesión en la página web de MVPD para autenticarse, y que entren en juego los siguientes factores adicionales:

Antes de la autenticación de Adobe Pass 2.7, todos estos escenarios para autenticar a un usuario implicaban una actualización de la página completa de la página del programador. En las versiones 2.7 y posteriores, el equipo de autenticación de Adobe Pass mejoró estos flujos para que el usuario no tenga que experimentar una actualización de la página en la aplicación durante el inicio de sesión y el cierre de sesión.

Descripción detallada detailed_description

Empecemos con un resumen de los flujos de autenticación y cierre de sesión originales, y luego continuemos con los flujos de autenticación y cierre de sesión mejorados. Tenga en cuenta que las primeras cuatro secciones tratan las MVPD normales (que no son TempPass), mientras que la última sección describe la implementación especial que debe aplicarse para TempPass:

Flujos de autenticación/cierre de sesión originales orig_authn

Autenticación

Los clientes web de autenticación de Adobe Pass tienen dos formas de autenticarse, según los requisitos de las MVPD:

La llamada de retorno displayProviderDialog (desencadenada por getAuthentication/getAuthorization) devuelve una lista de MVPD y su configuración apropiada. La propiedad iFrameRequired de un MVPD permite al programador saber si debe activar el flujo 1 o el flujo 2. Tenga en cuenta que el programador debe realizar una acción adicional (crear un iFrame/popup) solo para el flujo 2.

Cancelar autenticación

También se da el caso de que el usuario cancela explícitamente el flujo de autenticación cerrando la página de inicio de sesión. Estos son los escenarios y la solución propuesta para los Programadores:

Flujo de cierre de sesión original orig_logout

La API de cierre de sesión de AccessEnabler borra el estado local de la biblioteca y carga la URL de cierre de sesión de MVPD en la pestaña o ventana actual. El explorador se desplaza al extremo de cierre de sesión de MVPD y, una vez completado el proceso, se redirige al usuario al sitio web del programador. La única acción necesaria en nombre del usuario es pulsar el botón/vínculo Cerrar sesión e iniciar el flujo; no se requiere la interacción del usuario en el punto final de cierre de sesión de MVPD.

Flujo De Autenticación/Cierre De Sesión Original Con Actualización De Página

Autenticación mejorada (sin actualización) improved_authn

Los flujos de autenticación (inicio de sesión) y cierre de sesión mencionados anteriormente proporcionan una experiencia de usuario similar al volver a cargar la página principal después de completar cada flujo. La función actual pretende mejorar la experiencia del usuario al proporcionar un inicio y un cierre de sesión sin actualización (en segundo plano). El programador puede habilitar/deshabilitar el inicio y cierre de sesión en segundo plano pasando dos indicadores booleanos (backgroundLogin y backgroundLogout) al parámetro configInfo de la API setRequestor. De forma predeterminada, el inicio y cierre de sesión en segundo plano están desactivados (esto proporciona compatibilidad con la implementación anterior).

Ejemplo:

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

Autenticación

Los siguientes puntos describen la transición entre los flujos de autenticación originales y los flujos mejorados:

Cancelar autenticación

Estos son los flujos para cancelar la autenticación:

Flujo de cierre de sesión mejorado improved_logout

El nuevo flujo de cierre de sesión se realizará en un iFrame oculto, lo que elimina el redireccionamiento de página completa. Esto es posible porque el usuario no necesita realizar ninguna acción específica en la página de cierre de sesión de MVPD.

Una vez completado el flujo de cierre de sesión, redireccionará el iFrame a un punto final de autenticación de Adobe Pass personalizado. Esto servirá un fragmento de JS que realiza un window.postMessage al elemento principal, notificando al AccessEnabler que el cierre de sesión se ha completado. Se desencadenan las siguientes llamadas de retorno: setAuthenticationStatus() y sendTrackingData(AUTHENTICATION_DETECTION ...), lo que indica que el usuario ya no está autenticado.

La siguiente ilustración muestra el flujo sin actualización que permite a un usuario iniciar sesión en su MVPD sin actualizar la página principal de la aplicación:

Flujo de autenticación/cierre de sesión mejorado (sin actualización)

Flujo TempPass improved_temppas

El inicio de sesión sin actualización sigue un enfoque diferente para las MVPD de tipo TempPass.

Dado que el flujo TempPass requiere que se cree una ventana automáticamente y se cierre sin interacción explícita del usuario, puede suponer un problema para algunos exploradores (bloqueadores de ventanas emergentes). Por lo tanto, AccessEnabler implementa la fase de inicio de sesión entre bastidores, sin necesidad de un contenedor web creado por el programador.

Estos son los aspectos que el programador debe tener en cuenta al implementar TempPass para el inicio y cierre de sesión sin actualización:

En el siguiente ejemplo de código se muestra cómo controlar una ventana de MVPD en el sitio web de un programador (tanto para MVPD normales como para 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);
            }
        }
    }