Kunci sandi terkait dengan situs tertentu, dan hanya dapat digunakan untuk login di situs tempat kunci sandi tersebut dibuat.
Hal ini ditentukan dalam ID pihak tepercaya (RP ID), yang untuk kunci sandi yang dibuat untuk domain example.com dapat berupa www.example.com atau example.com.
Meskipun ID RP mencegah kunci sandi digunakan sebagai kredensial tunggal untuk autentikasi di mana saja, ID RP menimbulkan masalah untuk:
- Situs dengan beberapa domain: Pengguna tidak dapat menggunakan kunci sandi yang sama untuk
login di berbagai domain khusus negara (misalnya
example.com, danexample.co.uk) yang dikelola oleh perusahaan yang sama. - Domain bermerek: Pengguna tidak dapat menggunakan kredensial yang sama di berbagai
domain yang digunakan oleh satu merek (misalnya
acme.comdanacmerewards.com). - Aplikasi seluler: Aplikasi seluler sering kali tidak memiliki domain sendiri, sehingga pengelolaan kredensial menjadi sulit.
Ada solusi yang didasarkan pada penggabungan identitas, dan solusi lain yang didasarkan pada iframe, tetapi dalam beberapa kasus, solusi tersebut tidak praktis. Permintaan Origin Terkait menawarkan solusi.
Solusi
Dengan Permintaan Origin Terkait, situs dapat menentukan origin yang diizinkan untuk menggunakan RP ID-nya.
Hal ini memungkinkan pengguna menggunakan kembali kunci sandi yang sama di beberapa situs yang Anda operasikan.
Untuk menggunakan Permintaan Origin Terkait, Anda harus menyajikan file JSON khusus di
URL tertentu https://{RP ID}/.well-known/webauthn. Jika example.com ingin
mengizinkan origin tambahan untuk menggunakannya sebagai ID RP, origin tersebut harus menyajikan file berikut
di https://example.com/.well-known/webauthn:
{
"origins": [
"https://example.co.uk",
"https://example.de",
"https://example-rewards.com"
]
}
Saat salah satu situs ini melakukan panggilan untuk pembuatan kunci sandi
(navigator.credentials.create) atau autentikasi (navigator.credentials.get)
yang menggunakan example.com sebagai ID RP, browser akan melihat ID RP yang
tidak cocok dengan origin yang meminta. Jika browser mendukung Permintaan Origin Terkait, browser akan mencari file webauthn di https://{RP ID}/.well-known/webauthn terlebih dahulu. Jika file ada,
browser akan memeriksa apakah origin yang membuat permintaan ada di allowlist.
Jika ya, proses akan dilanjutkan ke langkah-langkah pembuatan atau autentikasi kunci sandi.
Jika browser tidak mendukung Permintaan Origin Terkait, browser akan menampilkan SecurityError.
Dukungan browser
Permintaan Origin Terkait didukung di Chrome dan Safari. Mulai Januari 2026, Firefox masih mempertimbangkan fitur ini. Anda dapat melacak statusnya di masalah posisi standar Mozilla.
Menyiapkan Permintaan Origin Terkait
Demo berikut menggunakan dua situs, https://ror-1.glitch.me dan https://ror-2.glitch.me.
Untuk memungkinkan pengguna login dengan kunci sandi yang sama di kedua situs tersebut, situs ini menggunakan Permintaan Origin Terkait untuk mengizinkan ror-2.glitch.me menggunakan ror-1.glitch.me sebagai ID RP-nya.
Demo
https://ror-2.glitch.me menerapkan Permintaan Origin Terkait untuk menggunakan ror-1.glitch.me sebagai ID RP, sehingga ror-1 dan ror-2 menggunakan ror-1.glitch.me sebagai ID RP saat membuat kunci sandi atau melakukan autentikasi dengannya.
Kami juga telah menerapkan database kunci sandi bersama di seluruh situs ini.
Amati pengalaman pengguna berikut:
- Anda dapat berhasil membuat kunci sandi, dan melakukan autentikasi dengannya, di
ror-2—meskipun ID RP-nya adalahror-1(dan bukanror-2). - Setelah membuat kunci sandi di
ror-1atauror-2, Anda dapat melakukan autentikasi dengan kunci sandi tersebut diror-1danror-2. Karenaror-2menentukanror-1sebagai RP ID, membuat permintaan pembuatan atau autentikasi kunci sandi dari salah satu situs ini sama dengan membuat permintaan di ror-1. ID RP adalah satu-satunya hal yang mengaitkan permintaan ke origin. - Setelah Anda membuat kunci sandi di
ror-1atauror-2, kunci sandi tersebut dapat diisi otomatis oleh Chrome diror-1danror-2. - Kredensial yang dibuat di salah satu situs ini akan memiliki ID RP
ror-1.
Lihat kode:
- Lihat file
/.well-known/webauthnyang disiapkan di codebase ror-1. - Lihat
RP_ID_RORkemunculan di codebase ror-2.
Langkah 1: Terapkan database akun bersama
Jika Anda ingin pengguna dapat login dengan kunci sandi yang sama di
site-1 dan site-2, terapkan database akun yang digunakan bersama di kedua
situs ini.
Langkah 2: Siapkan file JSON .well-known/webauthn di situs-1
Pertama, konfigurasikan site-1.com agar mengizinkan site-2.com menggunakannya sebagai
RP ID. Untuk melakukannya, buat file JSON webauthn Anda:
{
"origins": [
"https://site-2.com"
]
}
Objek JSON harus berisi kunci bernama origins yang nilainya berupa array dari satu atau beberapa string yang berisi origin web.
Batasan penting: Maksimum 5 label
Setiap elemen dalam daftar ini akan diproses untuk mengekstrak label eTLD + 1.
Misalnya, label eTLD + 1 dari example.co.uk dan example.de adalah
example. Namun, label eTLD + 1 dari example-rewards.com adalah example-rewards.
Di Chrome, jumlah maksimum label adalah 5.
Langkah 3: Tayangkan JSON .well-known/webauthn di situs-1
Kemudian, tayangkan file JSON Anda di site-1.com/.well-known/webauthn.
Misalnya, di express:
app.get("/.well-known/webauthn", (req, res) => {
const origins = {
origins: ["https://site-2.com"],
};
return res.json(origins);
});
Di sini, kita menggunakan express res.json, yang sudah menetapkan
content-type ('application/json') yang benar;
Langkah 4: Tentukan ID RP di situs-2
Di codebase site-2 Anda, tetapkan site-1.com sebagai ID RP di mana pun diperlukan:
- Setelah pembuatan kredensial:
- Tetapkan
site-1.comsebagai ID RP dalam pembuatan kredensialoptionsyang diteruskan ke panggilan frontendnavigator.credentials.create, dan biasanya dibuat di sisi server. - Tetapkan
site-1.comsebagai RP ID yang diharapkan, saat Anda menjalankan verifikasi kredensial sebelum menyimpannya ke database.
- Tetapkan
- Setelah autentikasi:
- Tetapkan
site-1.comsebagai RP ID dalamoptionsautentikasi yang diteruskan ke panggilan frontendnavigator.credentials.get, dan biasanya dibuat di sisi server. - Tetapkan
site-1.comsebagai ID RP yang diharapkan untuk diverifikasi di server, saat Anda menjalankan verifikasi kredensial sebelum mengautentikasi pengguna.
- Tetapkan
Pemecahan masalah
Pertimbangan lainnya
Membagikan kunci sandi di seluruh situs dan aplikasi seluler
Permintaan Origin Terkait memungkinkan pengguna Anda menggunakan kembali kunci sandi di beberapa situs. Untuk mengizinkan pengguna menggunakan kembali kunci sandi di situs dan aplikasi seluler, gunakan teknik berikut:
- Di Chrome: Digital Asset Links. Pelajari lebih lanjut di Menambahkan dukungan untuk Digital Asset Links.
- Di Safari: Domain terkait.
Berbagi sandi di berbagai situs
Permintaan Origin Terkait memungkinkan pengguna Anda menggunakan kembali kunci sandi di berbagai situs. Solusi untuk membagikan sandi di berbagai situs bervariasi di antara pengelola sandi. Untuk Pengelola Sandi Google, gunakan Digital Asset Links . Safari memiliki sistem yang berbeda.
Peran pengelola kredensial dan agen pengguna
Hal ini di luar cakupan Anda sebagai developer situs, tetapi perlu diperhatikan bahwa dalam jangka panjang, RP ID tidak boleh menjadi konsep yang terlihat oleh pengguna di agen pengguna atau pengelola kredensial yang digunakan pengguna Anda. Sebagai gantinya, agen pengguna dan pengelola kredensial harus menunjukkan kepada pengguna tempat kredensial mereka telah digunakan. Perubahan ini akan memerlukan waktu untuk diterapkan. Solusi sementaranya adalah menampilkan situs saat ini dan situs pendaftaran asli.