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:
Chrome 60
Chrome 60 introduceert verschillende belangrijke wijzigingen in de Credential Management API:
Omdat de aangepaste functie
fetch()niet meer nodig is om het wachtwoord op te halen, wordt deze binnenkort beëindigd.navigator.credentials.get()accepteert nu een enummediationin plaats van de Booleaanse markeringunmediated.De naam van
requireUserMediation()is gewijzigd inpreventSilentAccess().De nieuwe methode
navigator.credentials.create()maakt asynchroon objecten met inloggegevens.
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.
navigator.credentials.get() accepteert nu een enum-bemiddeling
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.