מפתחות גישה מקושרים לאתר ספציפי, ואפשר להשתמש בהם רק כדי להיכנס לאתר שבשבילו הם נוצרו.
הדומיין הזה מצוין במזהה הצד המסתמך (RP ID). במפתחות גישה שנוצרו לדומיין example.com, המזהה יכול להיות www.example.com או example.com.
מזהי RP מונעים שימוש במפתחות גישה כפרטי כניסה יחידים לאימות בכל מקום, אבל הם יוצרים בעיות במקרים הבאים:
- אתרים עם כמה דומיינים: המשתמשים לא יכולים להשתמש באותו מפתח גישה כדי להיכנס לדומיינים שונים ספציפיים למדינה (לדוגמה,
example.comו-example.co.uk) שמנוהלים על ידי אותה חברה. - דומיינים ממותגים: המשתמשים לא יכולים להשתמש באותם פרטי כניסה בדומיינים שונים שמשמשים מותג אחד (לדוגמה,
acme.comו-acmerewards.com). - אפליקציות לנייד: לאפליקציות לנייד בדרך כלל אין דומיין משלהן, ולכן קשה לנהל את פרטי הכניסה.
יש פתרונות עקיפים שמבוססים על איחוד שירותי אימות הזהות, ואחרים שמבוססים על iframe, אבל במקרים מסוימים הם לא נוחים. אפשר לפתור את הבעיה הזו באמצעות Related Origin Requests.
פתרון
באמצעות בקשות ממקורות קשורים, אתר יכול לציין מקורות שמורשים להשתמש במזהה ה-RP שלו.
כך המשתמשים יכולים להשתמש באותו מפתח גישה בכמה אתרים שאתם מפעילים.
כדי להשתמש בבקשות ממקורות קשורים, צריך להציג קובץ JSON מיוחד בכתובת URL ספציפית https://{RP ID}/.well-known/webauthn. אם example.com רוצה לאפשר למקורות הנוספים להשתמש בו כמזהה RP, הוא צריך להציג את הקובץ הבא בכתובת https://example.com/.well-known/webauthn:
{
"origins": [
"https://example.co.uk",
"https://example.de",
"https://example-rewards.com"
]
}
בפעם הבאה שאחד מהאתרים האלה יבצע קריאה ליצירת מפתח גישה (navigator.credentials.create) או לאימות (navigator.credentials.get) שמשתמש ב-example.com בתור מזהה RP, הדפדפן יזהה מזהה RP שלא תואם למקור הבקשה. אם הדפדפן תומך בבקשות למקורות קשורים, הוא מחפש קובץ webauthn ב-https://{RP ID}/.well-known/webauthn. אם הקובץ קיים, הדפדפן בודק אם המקור ששולח את הבקשה נמצא ב-allowlist.
אם כן, הוא ממשיך לשלבים של יצירת מפתח הגישה או האימות.
אם הדפדפן לא תומך בבקשות למקורות קשורים, הוא מחזיר SecurityError.
תמיכה בדפדפנים
בקשות מקור קשורות נתמכות ב-Chrome וב-Safari. נכון לינואר 2026, ב-Firefox עדיין שוקלים את התכונה. אפשר לעקוב אחרי הסטטוס של הבעיה בדף הבעיות של Mozilla בנושא עמדות לגבי תקנים.
הגדרת בקשות למקורות קשורים (ROR)
בהדגמה הבאה נעשה שימוש בשני אתרים, https://ror-1.glitch.me ו-https://ror-2.glitch.me.
כדי לאפשר למשתמשים להיכנס עם אותו מפתח גישה בשני האתרים האלה, הוא משתמש בבקשות למקורות קשורים כדי לאפשר ל-ror-2.glitch.me להשתמש ב-ror-1.glitch.me כמזהה ה-RP שלו.
הדגמה (דמו)
באתר https://ror-2.glitch.me מוטמעות בקשות למקורות קשורים כדי להשתמש ב-ror-1.glitch.me כמזהה RP, כך שגם ror-1 וגם ror-2 משתמשים ב-ror-1.glitch.me כמזהה RP כשיוצרים מפתח גישה או מאמתים באמצעותו.
בנוסף, הטמענו מסד נתונים משותף של מפתחות גישה באתרים האלה.
שימו לב לחוויית המשתמש הבאה:
- אתם יכולים ליצור מפתח גישה ולאמת אותו ב-
ror-2, גם אם מזהה ה-RP שלו הואror-1(ולאror-2). - אחרי שיוצרים מפתח גישה ב-
ror-1או ב-ror-2, אפשר לאמת את הזהות באמצעותו גם ב-ror-1וגם ב-ror-2. מכיוון ש-ror-2מציין אתror-1כמזהה RP, שליחת בקשה ליצירת מפתח גישה או לאימות מכל אחד מהאתרים האלה זהה לשליחת הבקשה ב-ror-1. מזהה ה-RP הוא הדבר היחיד שמקשר בין בקשה למקור. - אחרי שיוצרים מפתח גישה ב-
ror-1או ב-ror-2, Chrome יכול למלא אותו אוטומטית גם ב-ror-1וגם ב-ror-2. - לפרטי כניסה שנוצרו בכל אחד מהאתרים האלה יהיה מזהה RP של
ror-1.
הצגת הקוד:
- אפשר לראות את הקובץ
/.well-known/webauthnשמוגדר בבסיס הקוד ror-1. -
RP_ID_RORמופעים בבסיס הקוד ror-2.
שלב 1: מטמיעים מסד נתונים משותף של חשבונות
אם אתם רוצים שהמשתמשים יוכלו להיכנס עם אותו מפתח גישה גם ב-site-1 וגם ב-site-2, אתם צריכים להטמיע מסד נתונים של חשבונות שמשותף לשני האתרים האלה.
שלב 2: מגדירים את קובץ ה-JSON .well-known/webauthn ב-site-1
קודם כול, מגדירים את site-1.com כך שיאפשר ל-site-2.com להשתמש בו כמזהה RP. כדי לעשות את זה, יוצרים קובץ JSON של webauthn:
{
"origins": [
"https://site-2.com"
]
}
אובייקט ה-JSON חייב להכיל מפתח בשם origins, שהערך שלו הוא מערך של מחרוזת אחת או יותר שמכילות מקורות באינטרנט.
מגבלה חשובה: אפשר להוסיף עד 5 תוויות
כל רכיב ברשימה הזו יעובד כדי לחלץ את התווית eTLD + 1.
לדוגמה, תוויות ה-eTLD + 1 של example.co.uk ו-example.de הן example. אבל התווית של eTLD + 1 של example-rewards.com היא example-rewards.
ב-Chrome, המספר המקסימלי של תוויות הוא 5.
שלב 3: מציגים את קובץ ה-JSON של .well-known/webauthn באתר 1
אחר כך, מציגים את קובץ ה-JSON בכתובת site-1.com/.well-known/webauthn.
לדוגמה, ב-Express:
app.get("/.well-known/webauthn", (req, res) => {
const origins = {
origins: ["https://site-2.com"],
};
return res.json(origins);
});
כאן אנחנו משתמשים ב-express res.json, שכבר מגדיר את ה-content-type ('application/json') הנכון;
שלב 4: מציינים את מזהה ה-RP באתר השני
בבסיס הקוד של site-2, מגדירים את site-1.com כמזהה ה-RP בכל מקום שצריך:
- כשיוצרים את פרטי הכניסה:
- מגדירים את
site-1.comבתור מזהה ה-RP בoptionsליצירת פרטי הכניסה, שמועברות לקריאה החוזרת (callback) של ממשק הקצה (frontend) שלnavigator.credentials.create, ובדרך כלל נוצרות בצד השרת. - מגדירים את
site-1.comכמזהה הצפוי של הגורם המסתמך, כשמריצים אימותים של פרטי כניסה לפני ששומרים אותם במסד הנתונים.
- מגדירים את
- אחרי האימות:
- מגדירים את
site-1.comכמזהה ה-RP בoptionsהאימות שמועברות לקריאת החזית שלnavigator.credentials.get, ובדרך כלל נוצרות בצד השרת. - מגדירים את
site-1.comכמזהה ה-RP הצפוי לאימות בשרת, כשמריצים אימותי פרטי כניסה לפני אימות המשתמש.
- מגדירים את
פתרון בעיות
שיקולים נוספים
שיתוף מפתחות גישה בין אתרים ואפליקציות לנייד
בקשות למקורות קשורים מאפשרות למשתמשים להשתמש במפתח גישה בכמה אתרים. כדי לאפשר למשתמשים להשתמש במפתח גישה גם באתר וגם באפליקציה לנייד, צריך להשתמש בשיטות הבאות:
- ב-Chrome: Digital Asset Links. מידע נוסף על הוספת תמיכה ב-Digital Asset Links
- ב-Safari: דומיינים משויכים.
שיתוף סיסמאות בין אתרים
בקשות למקורות קשורים מאפשרות למשתמשים לעשות שימוש חוזר במפתח גישה באתרים שונים. הפתרונות לשיתוף סיסמאות בין אתרים משתנים בין מנהלי הסיסמאות. במנהל הסיסמאות של Google, משתמשים ב-Digital Asset Links . ל-Safari יש מערכת אחרת.
התפקיד של Credential Manager וסוכני משתמשים
זה חורג מהתפקיד שלכם כמפתחי אתרים, אבל חשוב לציין שבטווח הארוך, מזהה ה-RP לא אמור להיות גלוי למשתמשים בסוכן המשתמש או ב-Credential Manager שבהם המשתמשים משתמשים. במקום זאת, סוכני משתמשים ומנהלי פרטי כניסה צריכים להראות למשתמשים איפה נעשה שימוש בפרטי הכניסה שלהם. השינוי הזה ייקח זמן. פתרון זמני הוא להציג גם את האתר הנוכחי וגם את אתר הרישום המקורי.