אפשר להשתמש שוב במפתחות גישה באתרים שלך באמצעות בקשות מקור קשורות

מפתחות גישה מקושרים לאתר ספציפי, ואפשר להשתמש בהם רק כדי להיכנס לאתר שבשבילו הם נוצרו.

הדומיין הזה מצוין במזהה הצד המסתמך (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 בנושא עמדות לגבי תקנים.

בהדגמה הבאה נעשה שימוש בשני אתרים, 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.
‫Chrome ממלא אוטומטית את הפרטים בשני האתרים.
בזכות Related Origin Requests, המשתמשים יכולים להשתמש באותם פרטי כניסה של מפתח הגישה ב-ror-1 וב-ror-2. ‫Chrome גם ימלא באופן אוטומטי את פרטי הכניסה.

הצגת הקוד:

שלב 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.
הודעת שגיאה ב-Chrome כשיוצרים פרטי כניסה. השגיאה הזו מופיעה אם לא ניתן למצוא את הקובץ ‎ `.well-known/webauthn` ‎ בכתובת ‎ `https://{RP ID}/.well-known/webauthn`‎.
הודעת שגיאה קופצת ב-Chrome.
הודעת שגיאה ב-Chrome בזמן יצירת פרטי כניסה. השגיאה הזו מופיעה אם הקובץ ‎.well-known/webauthn נמצא, אבל לא מופיע בו המקור שממנו אתם מנסים ליצור פרטי כניסה.

שיקולים נוספים

שיתוף מפתחות גישה בין אתרים ואפליקציות לנייד

בקשות למקורות קשורים מאפשרות למשתמשים להשתמש במפתח גישה בכמה אתרים. כדי לאפשר למשתמשים להשתמש במפתח גישה גם באתר וגם באפליקציה לנייד, צריך להשתמש בשיטות הבאות:

שיתוף סיסמאות בין אתרים

בקשות למקורות קשורים מאפשרות למשתמשים לעשות שימוש חוזר במפתח גישה באתרים שונים. הפתרונות לשיתוף סיסמאות בין אתרים משתנים בין מנהלי הסיסמאות. במנהל הסיסמאות של Google, משתמשים ב-Digital Asset Links . ל-Safari יש מערכת אחרת.

התפקיד של Credential Manager וסוכני משתמשים

זה חורג מהתפקיד שלכם כמפתחי אתרים, אבל חשוב לציין שבטווח הארוך, מזהה ה-RP לא אמור להיות גלוי למשתמשים בסוכן המשתמש או ב-Credential Manager שבהם המשתמשים משתמשים. במקום זאת, סוכני משתמשים ומנהלי פרטי כניסה צריכים להראות למשתמשים איפה נעשה שימוש בפרטי הכניסה שלהם. השינוי הזה ייקח זמן. פתרון זמני הוא להציג גם את האתר הנוכחי וגם את אתר הרישום המקורי.