Untuk memproses login pengguna, ambil kredensial dari sandi browser dan menggunakannya untuk memasukkan pengguna ke dalam log secara otomatis. Untuk pengguna dengan beberapa akun, membiarkan mereka memilih akun hanya dengan satu ketukan menggunakan pemilih akun.
Login Otomatis
Login otomatis dapat dilakukan di mana saja di situs Anda; tidak hanya halaman atas tetapi juga halaman {i>leaf<i} lainnya. Hal ini berguna saat pengguna mencapai berbagai halaman di {i>website<i} Anda, melalui mesin telusur.
Untuk mengaktifkan login otomatis:
- Mendapatkan informasi kredensial.
- Mengautentikasi pengguna.
- Update UI atau lanjutkan ke halaman yang dipersonalisasi.
Mendapatkan informasi kredensial
Untuk mendapatkan informasi kredensial, panggil
navigator.credentials.get()
Tentukan jenis kredensial yang akan diminta
dengan memberinya password
atau federated
.
Selalu gunakan mediation: 'silent'
untuk login otomatis,
sehingga Anda dapat dengan mudah menutup proses jika pengguna:
- Tidak memiliki kredensial yang disimpan.
- Menyimpan beberapa kredensial.
- Telah logout.
Sebelum mendapatkan kredensial, jangan lupa untuk memeriksa apakah pengguna sudah login:
if (window.PasswordCredential || window.FederatedCredential) {
if (!user.isSignedIn()) {
navigator.credentials.get({
password: true,
federated: {
providers: ['https://accounts.google.com'],
},
mediation: 'silent',
});
// ...
}
}
Promise yang ditampilkan oleh navigator.credentials.get()
me-resolve
dengan objek kredensial atau null
.
Untuk menentukan apakah permintaan tersebut adalah PasswordCredential
atau FederatedCredential
,
cukup lihat properti .type
dari objek,
yang dapat berupa password
atau federated
.
Jika .type
adalah federated
,
properti .provider
adalah string yang mewakili penyedia identitas.
Autentikasi pengguna
Setelah memiliki kredensial,
menjalankan alur otentikasi
tergantung pada jenis kredensial,
password
atau federated
:
}).then(c => {
if (c) {
switch (c.type) {
case 'password':
return sendRequest(c);
break;
case 'federated':
return gSignIn(c);
break;
}
} else {
return Promise.resolve();
}
Ketika promise diselesaikan, periksa apakah Anda telah menerima objek kredensial. Jika tidak, login otomatis tidak dapat dilakukan. Hentikan proses login otomatis secara diam-diam.
Mengupdate UI
Jika otentikasi berhasil, mengupdate UI atau meneruskan pengguna ke halaman yang dipersonalisasi:
}).then(profile => {
if (profile) {
updateUI(profile);
}
Jangan lupa untuk menampilkan pesan error autentikasi
Untuk menghindari kebingungan, pengguna akan melihat toast biru yang bertuliskan “Masuk” pada saat mendapatkan objek kredensial:
![Toast biru yang menampilkan pengguna sedang login.](https://web.developers.google.cn/static/articles/security-credential-management-retrieve-credentials/image/blue-toast-showing-user-i-434a344bb78b3.png?authuser=5&hl=id)
Satu tips penting: jika Anda berhasil mendapatkan objek kredensial tetapi gagal mengautentikasi pengguna, Anda akan menampilkan pesan error:
}).catch(error => {
showError('Sign-in Failed');
});
}
}
Contoh kode lengkap
if (window.PasswordCredential || window.FederatedCredential) {
if (!user.isSignedIn()) {
navigator.credentials
.get({
password: true,
federated: {
providers: ['https://accounts.google.com'],
},
mediation: 'silent',
})
.then((c) => {
if (c) {
switch (c.type) {
case 'password':
return sendRequest(c);
break;
case 'federated':
return gSignIn(c);
break;
}
} else {
return Promise.resolve();
}
})
.then((profile) => {
if (profile) {
updateUI(profile);
}
})
.catch((error) => {
showError('Sign-in Failed');
});
}
}
Login melalui pemilih akun
Jika pengguna memerlukan mediasi, atau memiliki beberapa akun, menggunakan pemilih akun agar pengguna bisa masuk, melewati formulir login biasa, misalnya:
![Pemilih Akun Google yang menampilkan beberapa akun.](https://web.developers.google.cn/static/articles/security-credential-management-retrieve-credentials/image/google-account-chooser-sh-76222c6b4a3fb.png?authuser=5&hl=id)
Langkah-langkah untuk login melalui pemilih akun sama dengan yang ada di login otomatis, dengan panggilan tambahan untuk menunjukkan pemilih akun sebagai bagian dari proses untuk mendapatkan informasi kredensial:
- Dapatkan informasi kredensial dan tampilkan pemilih akun.
- Autentikasi pengguna.
- Update UI atau lanjutkan ke halaman yang dipersonalisasi.
Mendapatkan informasi kredensial dan menampilkan pemilih akun
Menampilkan pemilih akun sebagai respons atas tindakan pengguna yang ditentukan,
misalnya, saat pengguna mengetuk tombol "Login" tombol. Telepon
navigator.credentials.get()
,
dan tambahkan mediation: 'optional'
atau mediation: 'required'
untuk menampilkan pemilih akun.
Jika mediation
adalah required
, pengguna akan selalu melihat pemilih akun untuk login.
Opsi ini memungkinkan pengguna dengan beberapa akun untuk beralih antar-akun dengan mudah.
Jika mediation
adalah optional
,
pengguna secara eksplisit diperlihatkan pemilih akun untuk login setelah
navigator.credentials.preventSilentAccess()
panggilan telepon.
Hal ini biasanya untuk memastikan agar login otomatis tidak terjadi
setelah pengguna memilih untuk logout atau membatalkan pendaftaran.
Contoh yang menampilkan mediation: 'optional'
:
var signin = document.querySelector('#signin');
signin.addEventListener('click', e => {
if (window.PasswordCredential || window.FederatedCredential) {
navigator.credentials.get({
password: true,
federated: {
providers: [
'https://accounts.google.com'
]
},
mediation: 'optional'
}).then(c => {
Setelah pengguna memilih akun,
promise tersebut di-resolve dengan kredensial.
Jika pengguna membatalkan
pemilih akun,
atau tidak ada kredensial yang disimpan,
promise akan di-resolve dengan null
.
Dalam hal ini, kembali ke pengalaman formulir login.
Jangan lupa untuk kembali ke formulir login
Anda harus kembali ke formulir login karena salah satu alasan berikut:
- Tidak ada kredensial yang disimpan.
- Pengguna menutup pemilih akun tanpa memilih akun.
- API ini tidak tersedia.
}).then(profile => {
if (profile) {
updateUI(profile);
} else {
location.href = '/signin';
}
}).catch(error => {
location.href = '/signin';
});
Contoh kode lengkap
var signin = document.querySelector('#signin');
signin.addEventListener('click', (e) => {
if (window.PasswordCredential || window.FederatedCredential) {
navigator.credentials
.get({
password: true,
federated: {
providers: ['https://accounts.google.com'],
},
mediation: 'optional',
})
.then((c) => {
if (c) {
switch (c.type) {
case 'password':
return sendRequest(c);
break;
case 'federated':
return gSignIn(c);
break;
}
} else {
return Promise.resolve();
}
})
.then((profile) => {
if (profile) {
updateUI(profile);
} else {
location.href = '/signin';
}
})
.catch((error) => {
location.href = '/signin';
});
}
});
Login Gabungan
Login gabungan memungkinkan pengguna login dengan sekali ketuk dan tanpa harus mengingat detail {i>login<i} tambahan untuk situs web Anda.
Untuk menerapkan login gabungan:
- Autentikasi pengguna dengan identitas pihak ketiga.
- Menyimpan informasi identitas.
- Update UI atau lanjutkan ke halaman yang dipersonalisasi (sama seperti login otomatis).
Mengautentikasi pengguna dengan identitas pihak ketiga
Saat pengguna mengetuk tombol {i>
federated login<i},
menjalankan alur otentikasi penyedia
identitas tertentu dengan
FederatedCredential
Misalnya, jika penyedianya adalah Google, gunakan Library JavaScript Login dengan Google:
navigator.credentials
.get({
password: true,
mediation: 'optional',
federated: {
providers: ['https://account.google.com'],
},
})
.then(function (cred) {
if (cred) {
// Instantiate an auth object
var auth2 = gapi.auth2.getAuthInstance();
// Is this user already signed in?
if (auth2.isSignedIn.get()) {
var googleUser = auth2.currentUser.get();
// Same user as in the credential object?
if (googleUser.getBasicProfile().getEmail() === cred.id) {
// Continue with the signed-in user.
return Promise.resolve(googleUser);
}
}
// Otherwise, run a new authentication flow.
return auth2.signIn({
login_hint: id || '',
});
}
});
Login dengan Google menghasilkan token ID sebagai bukti autentikasi.
Secara umum, {i>login<i} gabungan dibuat di atas protokol standar seperti OpenID Connect atau OAuth. Untuk mempelajari cara mengotentikasi dengan akun gabungan, merujuk ke masing-masing penyedia identitas gabungan dokumen. Contoh populernya meliputi:
Informasi identitas toko
Setelah autentikasi selesai, Anda dapat menyimpan informasi identitas.
Informasi yang akan Anda simpan di sini adalah id
dari penyedia identitas
dan string penyedia yang merepresentasikan penyedia identitas
(name
dan iconURL
bersifat opsional).
Pelajari informasi ini lebih lanjut di
Spesifikasi Pengelolaan Kredensial.
Untuk menyimpan detail akun gabungan, buat instance baru
FederatedCredential
dengan ID pengguna dan ID penyedia.
Kemudian panggil
navigator.credentials.store()
untuk menyimpan informasi identitas.
Setelah federasi sukses,
buat instance FederatedCredential
secara sinkron, atau asinkron:
Contoh pendekatan sinkron:
// Create credential object synchronously.
var cred = new FederatedCredential({
id: id, // id in IdP
provider: 'https://account.google.com', // A string representing IdP
name: name, // name in IdP
iconURL: iconUrl, // Profile image url
});
Contoh pendekatan asinkron:
// Create credential object asynchronously.
var cred = await navigator.credentials.create({
federated: {
id: id,
provider: 'https://accounts.google.com',
name: name,
iconURL: iconUrl,
},
});
Kemudian, simpan objek kredensial:
// Store it
navigator.credentials.store(cred).then(function () {
// continuation
});
Logout
Membuat pengguna logout saat tombol logout diketuk. Pertama, akhiri sesi ini, kemudian nonaktifkan masuk otomatis pada kunjungan berikutnya. (Bagaimana Anda mengakhiri sesi Anda sepenuhnya terserah Anda.)
Nonaktifkan login otomatis untuk kunjungan berikutnya
Telepon
navigator.credentials.preventSilentAccess()
:
signoutUser();
if (navigator.credentials && navigator.credentials.preventSilentAccess) {
navigator.credentials.preventSilentAccess();
}
Tindakan ini akan memastikan login otomatis tidak akan terjadi sampai pengguna mengaktifkan login otomatis lagi. Untuk melanjutkan login otomatis, pengguna dapat memilih untuk login secara sengaja dengan memilih akun yang ingin mereka gunakan untuk login dari pemilih akun. Kemudian, pengguna akan selalu login kembali hingga secara eksplisit logout.