Nieuwste updates voor de API voor inloggegevensbeheer

Sommige van de hier beschreven updates worden uitgelegd in de Google I/O-sessie Secure and Seamless Sign-In: Keeping Users Engaged:

Chrome 57

In Chrome 57 is deze belangrijke wijziging in de Credential Management API geïntroduceerd.

Inloggegevens kunnen worden gedeeld vanuit een ander subdomein

Chrome kan nu inloggegevens ophalen die zijn opgeslagen in een ander subdomein met de Credential Management API. Als een wachtwoord bijvoorbeeld is opgeslagen in login.example.com, kan een script op www.example.com het tonen als een van de accountitems in het dialoogvenster van de accountkiezer.

Je moet het wachtwoord expliciet opslaan met navigator.credentials.store(), zodat het wachtwoord wordt doorgegeven en gekopieerd naar de huidige oorsprong als een gebruiker een inloggegeven kiest door op het dialoogvenster te tikken.

Nadat het wachtwoord is opgeslagen, is het beschikbaar als inloggegeven in exact dezelfde oorsprong www.example.com.

In het volgende screenshot is de inloggegevens die zijn opgeslagen onder login.aliexpress.com zichtbaar voor m.aliexpress.com en beschikbaar voor de gebruiker om uit te kiezen:

Accountkiezer met inloggegevens voor het geselecteerde subdomein

Chrome 60

Chrome 60 introduceert verschillende belangrijke wijzigingen in de Credential Management API:

Functiedetectie vereist aandacht

Als je wilt nagaan of de Credential Management API voor toegang tot op wachtwoorden gebaseerde en federatieve inloggegevens beschikbaar is, check je of window.PasswordCredential of window.FederatedCredential beschikbaar is.

if (window.PasswordCredential || window.FederatedCredential) {
  // The Credential Management API is available
}

Het object PasswordCredential bevat nu een wachtwoord

De Credential Management API hanteerde een conservatieve aanpak voor de verwerking van wachtwoorden. Het verborg wachtwoorden voor JavaScript, waardoor ontwikkelaars het PasswordCredential-object rechtstreeks naar hun server moesten sturen voor validatie via een extensie voor de fetch() API.

Maar deze aanpak bracht een aantal beperkingen met zich mee. We hebben feedback gekregen dat ontwikkelaars de API niet kunnen gebruiken omdat:

  • Ze moesten het wachtwoord sturen als onderdeel van een json-object.

  • Ze moesten de hash-waarde van het wachtwoord naar hun server sturen.

Na een beveiligingsanalyse hebben we vastgesteld dat het verbergen van wachtwoorden voor JavaScript niet alle aanvalsvectoren zo effectief voorkomt als we hadden gehoopt. Daarom hebben we besloten een wijziging aan te brengen.

De Credential Management API bevat nu een onbewerkt wachtwoord in een geretourneerd inloggegevensobject, zodat je er toegang toe hebt als platte tekst. Je kunt bestaande methoden gebruiken om inloggegevens aan je server te leveren:

navigator.credentials.get({
    password: true,
    federated: {
    providers: [ 'https://accounts.google.com' ]
    },
    mediation: 'silent'
}).then(passwordCred => {
    if (passwordCred) {
    let form = new FormData();
    form.append('email', passwordCred.id);
    form.append('password', passwordCred.password);
    form.append('csrf_token', csrf_token);
    return fetch('/signin', {
        method: 'POST',
        credentials: 'include',
        body: form
    });
    } else {

    // Fallback to sign-in form
    }
}).then(res => {
    if (res.status === 200) {
    return res.json();
    } else {
    throw 'Auth failed';
    }
}).then(profile => {
    console.log('Auth succeeded', profile);
});

Aangepast ophalen wordt binnenkort beëindigd

Als je wilt bepalen of je een aangepaste fetch()-functie gebruikt, controleer je of deze een PasswordCredential-object of een FederatedCredential-object gebruikt als waarde van de credentials-property, bijvoorbeeld:

fetch('/signin', {
    method: 'POST',
    credentials: c
})

We raden je aan een normale fetch()-functie te gebruiken, zoals in het vorige codevoorbeeld, of een XMLHttpRequest te gebruiken.

Tot Chrome 60 accepteerde navigator.credentials.get() een optionele property unmediated met een Booleaanse vlag. Voorbeeld:

navigator.credentials.get({
    password: true,
    federated: {
    providers: [ 'https://accounts.google.com' ]
    },
    unmediated: true
}).then(c => {

    // Sign-in
});

Als je unmediated: true instelt, toont de browser de accountkiezer niet als er een inloggegeven wordt doorgegeven.

De markering is nu uitgebreid als bemiddeling. Gebruikersbemiddeling kan plaatsvinden als:

  • Een gebruiker moet een account kiezen om mee in te loggen.

  • Een gebruiker wil expliciet inloggen na een navigator.credentials.requireUseMediation()-gesprek.

Kies een van de volgende opties voor de waarde mediation:

Waarde van mediation Vergeleken met booleaanse vlag Gedrag
silent Is gelijk aan unmediated: true Inloggegevens doorgegeven zonder een accountkiezer te tonen.
optional Is gelijk aan unmediated: false Toont een accountkiezer als preventSilentAccess() eerder is aangeroepen.
required Een nieuwe optie Altijd een accountkiezer tonen. Dit is handig als je een gebruiker wilt laten wisselen van account via het systeemeigen dialoogvenster voor accountkeuze.

In dit voorbeeld worden de inloggegevens doorgegeven zonder een accountkiezer te tonen, het equivalent van de vorige vlag, unmediated: true:

navigator.credentials.get({
    password: true,
    federated: {
    providers: [ 'https://accounts.google.com' ]
    },
    mediation: 'silent'
}).then(c => {

    // Sign-in
});

Naam van requireUserMediation() gewijzigd in preventSilentAccess()

De methode navigator.credentials.requireUserMediation() is hernoemd naar navigator.credentials.preventSilentAccess() om beter aan te sluiten bij de nieuwe property mediation die wordt aangeboden in de aanroep get().

De hernoemde methode voorkomt dat inloggegevens worden doorgegeven zonder de accountkiezer te tonen (soms ook wel zonder gebruikersbemiddeling genoemd). Dit is handig als een gebruiker uitlogt van een website of de registratie ongedaan maakt en niet automatisch opnieuw wil worden ingelogd bij het volgende bezoek.

signoutUser();
if (navigator.credentials) {
    navigator.credentials.preventSilentAccess();
}

Asynchroon objecten voor inloggegevens maken met de nieuwe methode navigator.credentials.create()

Je kunt nu asynchroon objecten voor inloggegevens maken met de nieuwe methode navigator.credentials.create(). Lees verder voor een vergelijking tussen de synchrone en asynchrone aanpak.

Een PasswordCredential-object maken

Synchronisatieaanpak
let c = new PasswordCredential(form);
Asynchrone aanpak (nieuw)
let c = await navigator.credentials.create({
    password: form
});

of:

let c = await navigator.credentials.create({
    password: {
    id: id,
    password: password
    }
});

Een FederatedCredential-object maken

Synchronisatieaanpak
let c = new FederatedCredential({
    id:       'agektmr',
    name:     'Eiji Kitamura',
    provider: 'https://accounts.google.com',
    iconURL:  'https://*****'
});
Asynchrone aanpak (nieuw)
let c = await navigator.credentials.create({
    federated: {
    id:       'agektmr',
    name:     'Eiji Kitamura',
    provider: 'https://accounts.google.com',
    iconURL:  'https://*****'
    }
});

Migratiehandleiding

Heb je een bestaande implementatie van de Credential Management API? We hebben een migratiehandleiding die je kunt volgen om te upgraden naar de nieuwe versie.