(Verouderd) Aanmelding en afmelding zonder vernieuwen tefresh-less-login-and-logout

Overzicht overview

Voor webtoepassingen moet u rekening houden met enkele verschillende mogelijke scenario's voor het verifiëren en afmelden van gebruikers. MVPDs vereist dat de gebruikers login op de Web-pagina van MVPD voor authentiek verklaren, met de volgende extra factoren die in spel komen:

Voorafgaand aan Adobe Pass-verificatie 2.7 zorgden al deze scenario's voor het verifiëren van een gebruiker voor een volledige pagina van de pagina van de programmeur. Voor 2.7 en volgende versies verbeterde het Adobe Pass-verificatieteam deze stromen, zodat de gebruiker geen pagina hoeft te vernieuwen in uw app tijdens het aanmelden en het afmelden.

Gedetailleerde beschrijving detailed_description

Laten we beginnen met een samenvatting van de oorspronkelijke verificatie- en logout-stromen, en dat vervolgens volgen met de verbeterde verificatie- en logout-stromen. Merk op dat de eerste vier secties normale MVPDs (niet-TempPass) richten, terwijl de laatste sectie de speciale implementatie beschrijft die voor TempPass moet worden toegepast:

Oorspronkelijke verificatie-/afmeldingsstromen orig_authn

Authentificatie

De het Webcliënten van de Authentificatie van Adobe Pass hebben twee manieren om voor authentiek te verklaren, afhankelijk van de vereisten van MVPDs:

De displayProviderDialog callback (teweeggebracht door getAuthentication/ getAuthorization) keert een lijst van MVPDs en hun aangewezen montages terug. Met de eigenschap iFrameRequired van een MVPD kan de programmeur controleren of flow 1 of flow 2 moet worden geactiveerd. Merk op dat de programmeur extra actie (het creëren van een iFrame/popup) slechts voor stroom 2 moet ondernemen.

annuleert Authentificatie

Er is ook de situatie waarin de gebruiker uitdrukkelijk de authentificatiestroom door de login pagina te sluiten annuleert. Hier volgen de scenario's en de voorgestelde oplossing voor de programmeurs:

Oorspronkelijke afmeldingsstroom orig_logout

De logout-API van de AccessEnabler wist de lokale status van de bibliotheek en laadt de MVPD-aanmeldings-URL in het huidige tabblad/venster. De browser navigeert naar het MVPD logout-eindpunt en nadat het proces is voltooid, wordt de gebruiker teruggeleid naar de website van de programmeur. De enige actie die namens de gebruiker wordt vereist is het drukken van de Logout knoop/verbinding en het in werking stellen van de stroom; geen gebruikersinteractie wordt vereist op het MVPD logout eindpunt.

Oorspronkelijke Authentificatie/Logout Stroom met Pagina verfrist zich

Verbeterde (Vernieuwen) verificatie improved_authn

Zowel de hierboven beschreven verificatie- (aanmelding) als aanmeldstromen bieden een vergelijkbare gebruikerservaring door de hoofdpagina opnieuw te laden nadat elke flow is voltooid. De huidige functie is bedoeld om de gebruikerservaring te verbeteren door aanmeldingsgegevens en aanmeldgegevens zonder vernieuwen (background) te bieden. De programmeur kan aanmeldingsgegevens voor de achtergrond in- en uitschakelen door twee Booleaanse markeringen (backgroundLogin en backgroundLogout ) door te geven aan de parameter configInfo van de setRequestor API. Standaard is aanmeldingsnaam/afmelding op de achtergrond uitgeschakeld (dit biedt compatibiliteit met de vorige implementatie).

Voorbeeld:

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

Authentificatie

De volgende punten beschrijven de overgang tussen de originele authentificatiestromen en de verbeterde stromen:

annuleert Authentificatie

Dit zijn de stromen voor het annuleren van authentificatie:

Verbeterde afmeldingsstroom improved_logout

De nieuwe logout-flow wordt uitgevoerd in een verborgen iFrame, waardoor de volledige paginareeiding wordt verwijderd. Dit is mogelijk omdat de gebruiker geen specifieke actie hoeft uit te voeren op de MVPD-aanmeldpagina.

Nadat de logout-flow is voltooid, wordt het iFrame omgeleid naar een aangepast Adobe Pass-verificatieeindpunt. Dit zal een fragment van JS dienen dat window.postMessage aan de ouder uitvoert, die AccessEnabler op de hoogte brengt dat logout volledig is. De volgende callbacks worden getriggerd: setAuthenticationStatus() en sendTrackingData(AUTHENTICATION_DETECTION ...) , die aangeven dat de gebruiker niet langer geverifieerd is.

In de onderstaande afbeelding ziet u de workflow zonder vernieuwen waarmee een gebruiker zich kan aanmelden bij zijn of haar MVPD zonder de mainpage van uw toepassing te vernieuwen:

Verbeterde (verfrissen-minder) Authentificatie/Logout Stroom

TempPass Flow improved_temppas

Logbestand zonder vernieuwen volgt een andere aanpak voor MVPD's van het type TempPass.

Aangezien voor de TempPass-flow automatisch een venster moet worden gemaakt en gesloten zonder expliciete gebruikersinteractie, kan dit een probleem opleveren voor sommige browsers (popup blockers). Daarom voert AccessEnabler de login fase achter de scènes uit, zonder een Webcontainer te vereisen die door Programmer wordt gecreeerd.

Hier zijn de aspecten die de programmeur zich van bewust moet zijn wanneer het uitvoeren van TempPass voor login en logout verfrissen zich zonder:

Het volgende codevoorbeeld toont hoe te om een venster van MVPD op de website van een Programmer (zowel voor normale MVPDs als voor TempPass) te behandelen:

    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);
            }
        }
    }