(Legacy) Anmeldung und Abmeldung ohne Aktualisierung tefresh-less-login-and-logout

Überblick overview

Bei Web-Anwendungen müssen Sie einige verschiedene mögliche Szenarien für die Authentifizierung und das Abmelden von Benutzern berücksichtigen. Bei MVPDs müssen sich Benutzer zur Authentifizierung auf der MVPD-Webseite anmelden, wobei die folgenden zusätzlichen Faktoren eine Rolle spielen:

Vor der Adobe Pass-Authentifizierung 2.7 erforderten alle diese Szenarien zur Authentifizierung eines Benutzers eine vollständige Seitenaktualisierung der Programmiererseite. Für die Version 2.7 und die nachfolgenden Versionen verbesserte das Adobe Pass-Authentifizierungsteam diese Abläufe, sodass der Benutzer während der Anmeldung und des Abmeldens keine Seitenaktualisierung in Ihrer App erleben muss.

Ausführliche Beschreibung detailed_description

Beginnen wir mit einer Zusammenfassung der ursprünglichen Authentifizierungs- und Abmeldevorgänge und folgen ihr dann mit den verbesserten Authentifizierungs- und Abmeldevorgängen. Beachten Sie, dass sich die ersten vier Abschnitte auf normale MVPDs (non-TempPass) beziehen, während der letzte Abschnitt die spezielle Implementierung beschreibt, die für TempPass angewendet werden muss:

Ursprüngliche Authentifizierung/Abmeldevorgänge orig_authn

Authentifizierung

Die Adobe Pass-Authentifizierungs-Webclients haben je nach den Anforderungen der MVPDs zwei Möglichkeiten zur Authentifizierung:

Der displayProviderDialog Callback (ausgelöst durch getAuthentication/getAuthorization) gibt eine Liste der MVPDs und ihrer entsprechenden Einstellungen zurück. Die iFrameRequired-Eigenschaft eines MVPD ermöglicht es dem Programmierer zu wissen, ob er Fluss 1 oder Fluss 2 aktivieren soll. Beachten Sie, dass der Programmierer nur für Fluss 2 zusätzliche Aktionen ausführen muss (Erstellen eines iFrames/Popup).

Authentifizierung

Es gibt auch die Situation, dass der Benutzer den Authentifizierungsfluss explizit abbricht, indem er die Anmeldeseite schließt. Im Folgenden finden Sie die Szenarien und die vorgeschlagene Lösung für die Programmierer:

Ursprünglicher Abmeldefluss orig_logout

Die Abmelde-API von AccessEnabler löscht den lokalen Status der Bibliothek und lädt die Abmelde-URL von MVPD in die aktuelle Registerkarte/das aktuelle Fenster. Der Browser navigiert zum Abmelde-Endpunkt von MVPD und nach Abschluss des Vorgangs wird der Benutzer zurück zur Website des Programmierers weitergeleitet. Die einzige Aktion, die im Namen des Benutzers erforderlich ist, ist das Drücken der Schaltfläche/des Links Abmelden und das Initiieren des Flusses; es ist keine Benutzerinteraktion auf dem Abmelde-Endpunkt von MVPD erforderlich.

Ursprüngliche Authentifizierung/Abmeldefluss mit Seitenaktualisierung

Verbesserte Authentifizierung (ohne Aktualisierung) improved_authn

Sowohl der Authentifizierungs- (Anmelde-) als auch der Abmelde-Fluss bieten ein ähnliches Benutzererlebnis, indem die Hauptseite nach Abschluss jedes Flusses neu geladen wird. Die aktuelle Funktion zielt darauf ab, das Benutzererlebnis zu verbessern, indem sie eine aktualisierungsfreie (Hintergrund-)Anmeldung und Abmeldung ermöglicht. Der Programmierer kann die Hintergrundanmeldung und die Abmeldung aktivieren/deaktivieren, indem er zwei boolesche Flags (backgroundLogin und backgroundLogout) an den configInfo der setRequestor-API übergibt. Standardmäßig sind Anmeldung/Abmeldung im Hintergrund deaktiviert (dies sorgt für Kompatibilität mit der vorherigen Implementierung).

Beispiel:

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

Authentifizierung

Die folgenden Punkte beschreiben den Übergang zwischen den ursprünglichen Authentifizierungsflüssen und den verbesserten Flüssen:

Authentifizierung

Dies sind die Flüsse zum Abbrechen der Authentifizierung:

Verbesserter Abmeldefluss improved_logout

Der neue Abmeldefluss wird in einem ausgeblendeten iFrame ausgeführt, sodass die vollständige Seitenumleitung entfällt. Dies ist möglich, da der/die Benutzende auf der Abmeldeseite von MVPD keine spezielle Aktion ausführen muss.

Nachdem der Abmeldefluss abgeschlossen ist, wird der iFrame an einen benutzerdefinierten Authentifizierungsendpunkt für Adobe Pass umgeleitet. Dies stellt ein JS-Snippet bereit, das eine window.postMessage an das übergeordnete Element durchführt und den AccessEnabler darüber informiert, dass die Abmeldung abgeschlossen ist. Die folgenden Callbacks werden ausgelöst: setAuthenticationStatus() und sendTrackingData(AUTHENTICATION_DETECTION ...), was anzeigt, dass der Benutzer nicht mehr authentifiziert ist.

Die folgende Abbildung zeigt den Fluss ohne Aktualisierung, der es einem Benutzer ermöglicht, sich bei seiner MVPD anzumelden, ohne die Hauptseite Ihrer Anwendung zu aktualisieren:

Verbesserter Authentifizierungs-/Abmeldefluss (ohne Aktualisierung

TempPass-Fluss improved_temppas

Die „Refresh-Less“-Anmeldung folgt einem anderen Ansatz für MVPDs vom Typ TempPass.

Da der TempPass-Fluss erfordert, dass ein Fenster automatisch erstellt und ohne explizite Benutzerinteraktion geschlossen wird, kann er bei einigen Browsern (Popup-Blockern) ein Problem darstellen. Daher führt AccessEnabler die Anmeldephase hinter den Kulissen durch, ohne dass ein vom Programmierer erstellter Web-Container erforderlich ist.

Im Folgenden finden Sie die Aspekte, die der Programmierer beachten muss, wenn er TempPass für die Anmeldung und das Abmelden ohne Aktualisierung implementiert:

Das folgende Codebeispiel veranschaulicht die Handhabung eines MVPD-Fensters auf der Website eines Programmierers (sowohl für normale MVPDs als auch für 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);
            }
        }
    }