Wiederverwendung von Passkeys auf Ihren Websites für Anfragen zu ähnlichen Quellen zulassen

Passkeys sind an eine bestimmte Website gebunden und können nur für die Anmeldung auf der Website verwendet werden, für die sie erstellt wurden.

Dies wird in der Relying Party ID (RP ID) angegeben. Für Passkeys, die für die Domain example.com erstellt wurden, kann dies www.example.com oder example.com sein.

RP-IDs verhindern zwar, dass Passkeys als einzelne Anmeldedaten für die Authentifizierung überall verwendet werden, sie verursachen jedoch Probleme für:

  • Websites mit mehreren Domains: Nutzer können sich nicht mit demselben Passkey auf verschiedenen länderspezifischen Domains (z. B. example.com und example.co.uk) anmelden, die vom selben Unternehmen verwaltet werden.
  • Markendomains: Nutzer können nicht dieselben Anmeldedaten für verschiedene Domains verwenden, die von einer einzelnen Marke verwendet werden (z. B. acme.com und acmerewards.com).
  • Mobile Apps: Mobile Apps haben oft keine eigene Domain, was die Verwaltung von Anmeldedaten erschwert.

Es gibt Problemumgehungen, die auf der Identitätsföderation basieren, und andere, die auf iFrames basieren. Diese sind jedoch in einigen Fällen unpraktisch. Anfragen an ähnliche Ursprünge bieten eine Lösung.

Lösung

Mit Anfragen von zugehörigen Ursprüngen kann eine Website Ursprünge angeben, die ihre RP-ID verwenden dürfen.

So können Nutzer denselben Passkey auf mehreren von Ihnen betriebenen Websites wiederverwenden.

Wenn Sie Anfragen von ähnlichen Ursprüngen verwenden möchten, müssen Sie eine spezielle JSON-Datei unter einer bestimmten URL https://{RP ID}/.well-known/webauthn bereitstellen. Wenn example.com den zusätzlichen Ursprüngen erlauben möchte, sie als RP-ID zu verwenden, sollte die folgende Datei unter https://example.com/.well-known/webauthn: bereitgestellt werden:

{
  "origins": [
    "https://example.co.uk",
    "https://example.de",
    "https://example-rewards.com"
  ]
}

Wenn eine dieser Websites das nächste Mal einen Aufruf zur Passkey-Erstellung (navigator.credentials.create) oder Authentifizierung (navigator.credentials.get) mit example.com als RP-ID sendet, erkennt der Browser, dass die RP-ID nicht mit dem anfragenden Ursprung übereinstimmt. Wenn der Browser Anfragen für ähnliche Ursprünge unterstützt, sucht er zuerst nach einer webauthn-Datei unter https://{RP ID}/.well-known/webauthn. Wenn die Datei vorhanden ist, prüft der Browser, ob der Ursprung, von dem die Anfrage stammt, in der allowlist enthalten ist. Wenn ja, wird mit den Schritten zur Passkey-Erstellung oder ‑Authentifizierung fortgefahren.

Wenn der Browser keine Anfragen an ähnliche Ursprünge unterstützt, wird ein SecurityError ausgelöst.

Unterstützte Browser

Anfragen zu ähnlichen Ursprüngen werden in Chrome und Safari unterstützt. Stand Januar 2026 wird die Funktion von Firefox noch geprüft. Den Status können Sie im Mozilla-Problem zur Positionierung von Standards verfolgen.

In der folgenden Demo werden zwei Websites verwendet: https://ror-1.glitch.me und https://ror-2.glitch.me. Damit sich Nutzer auf beiden Websites mit demselben Passkey anmelden können, werden Anfragen von ähnlichen Ursprüngen verwendet, um ror-2.glitch.me die Verwendung von ror-1.glitch.me als RP-ID zu ermöglichen.

Demo

https://ror-2.glitch.me implementiert Related Origin Requests, um ror-1.glitch.me als RP-ID zu verwenden. Daher verwenden sowohl ror-1 als auch ror-2 ror-1.glitch.me als RP-ID, wenn ein Passkey erstellt oder damit authentifiziert wird. Außerdem haben wir eine gemeinsame Passkey-Datenbank für diese Websites eingerichtet.

Beachten Sie die folgende Nutzererfahrung:

  • Sie können einen Passkey auf ror-2 erstellen und sich damit authentifizieren, obwohl die RP-ID ror-1 (und nicht ror-2) lautet.
  • Wenn Sie einen Passkey auf ror-1 oder ror-2 erstellt haben, können Sie sich damit sowohl auf ror-1 als auch auf ror-2 authentifizieren. Da ror-2 ror-1 als RP-ID angibt, ist das Erstellen eines Passkeys oder das Senden einer Authentifizierungsanfrage von einer dieser Websites dasselbe wie das Senden der Anfrage auf ror-1. Die RP-ID ist das Einzige, was eine Anfrage mit einem Ursprung verknüpft.
  • Wenn Sie einen Passkey auf ror-1 oder ror-2 erstellen, kann er von Chrome sowohl auf ror-1 als auch auf ror-2 automatisch ausgefüllt werden.
  • Anmeldedaten, die auf einer dieser Websites erstellt werden, haben die RP-ID ror-1.
Chrome füllt die Felder auf beiden Websites automatisch aus.
Dank Related Origin Requests können Nutzer dieselben Passkey-Anmeldedaten für ror-1 und ror-2 verwenden. Chrome füllt die Anmeldedaten dann automatisch aus.

Code anzeigen:

  • Sehen Sie sich die Datei /.well-known/webauthn an, die in der ror-1-Codebasis eingerichtet ist.
  • RP_ID_ROR Vorkommen in der ror-2-Codebasis ansehen.

Schritt 1: Gemeinsame Kontodatenbank implementieren

Wenn Sie möchten, dass sich Ihre Nutzer mit demselben Passkey sowohl bei site-1 als auch bei site-2 anmelden können, implementieren Sie eine Kontodatenbank, die von diesen beiden Websites gemeinsam genutzt wird.

Schritt 2: JSON-Datei „.well-known/webauthn“ auf site-1 einrichten

Konfigurieren Sie zuerst site-1.com so, dass site-2.com es als RP-ID verwenden kann. Erstellen Sie dazu Ihre WebAuthn-JSON-Datei:

{
    "origins": [
        "https://site-2.com"
    ]
}

Das JSON-Objekt muss einen Schlüssel namens „origins“ enthalten, dessen Wert ein Array aus einem oder mehreren Strings mit Webursprüngen ist.

Wichtige Einschränkung: maximal 5 Labels

Jedes Element dieser Liste wird verarbeitet, um das Label für die eTLD+1 zu extrahieren. Beispiel: Die eTLD+1-Labels von example.co.uk und example.de sind beide example. Das eTLD+1-Label von example-rewards.com ist jedoch example-rewards. In Chrome sind maximal 5 Labels zulässig.

Schritt 3: .well-known/webauthn-JSON-Datei auf site-1 bereitstellen

Stellen Sie dann Ihre JSON-Datei unter site-1.com/.well-known/webauthn bereit.

Beispiel in Express:

app.get("/.well-known/webauthn", (req, res) => {
  const origins = {
    origins: ["https://site-2.com"],
  };
  return res.json(origins);
});

Hier verwenden wir Express res.json, das bereits den richtigen content-type ('application/json') festlegt.

Schritt 4: RP-ID auf Website 2 angeben

Legen Sie in Ihrer site-2-Codebasis überall dort, wo es erforderlich ist, site-1.com als RP-ID fest:

  • Nach dem Erstellen der Anmeldedaten:
    • Legen Sie site-1.com als RP-ID in den options für die Erstellung von Anmeldedaten fest, die an den Frontend-Aufruf navigator.credentials.create übergeben und normalerweise serverseitig generiert werden.
    • Legen Sie site-1.com als erwartete RP-ID fest, da Sie die Anmeldedaten überprüfen, bevor Sie sie in Ihrer Datenbank speichern.
  • Nach der Authentifizierung:
    • Legen Sie site-1.com als RP-ID in den Authentifizierungs-options fest, die an den Frontend-Aufruf navigator.credentials.get übergeben und normalerweise serverseitig generiert werden.
    • Legen Sie site-1.com als erwartete RP-ID fest, die auf dem Server überprüft werden soll, da Sie die Anmeldedaten vor der Authentifizierung des Nutzers überprüfen.

Fehlerbehebung

Pop-up mit Fehlermeldung in Chrome.
Fehlermeldung in Chrome beim Erstellen von Anmeldedaten. Dieser Fehler wird ausgegeben, wenn die Datei `.well-known/webauthn` nicht unter `https://{RP ID}/.well-known/webauthn` gefunden werden kann.
Pop-up mit Fehlermeldung in Chrome.
Fehlermeldung in Chrome beim Erstellen von Anmeldedaten. Dieser Fehler wird ausgegeben, wenn Ihre Datei „.well-known/webauthn“ gefunden werden kann, aber nicht den Ursprung enthält, von dem aus Sie versuchen, Anmeldedaten zu erstellen.

Weitere Hinweise

Passkeys auf Websites und in mobilen Apps teilen

Mit Anfragen von ähnlichen Ursprüngen können Nutzer einen Passkey auf mehreren Websites wiederverwenden. Wenn Sie Ihren Nutzern die Möglichkeit geben möchten, einen Passkey sowohl auf einer Website als auch in einer mobilen App zu verwenden, nutzen Sie die folgenden Methoden:

Passwörter auf mehreren Websites verwenden

Mit Anfragen von ähnlichen Ursprüngen können Nutzer einen Passkey auf mehreren Websites verwenden. Die Lösungen für die Freigabe von Passwörtern für mehrere Websites variieren je nach Passwortmanager. Verwenden Sie für den Google Passwortmanager Digital Asset Links . Safari hat ein anderes System.

Rolle von Anmeldedaten-Managern und User-Agents

Dies geht über Ihren Aufgabenbereich als Website-Entwickler hinaus. Beachten Sie jedoch, dass die RP-ID langfristig kein für Nutzer sichtbares Konzept im User-Agent oder im von Ihren Nutzern verwendeten Credential Manager sein sollte. Stattdessen sollten User-Agents und Credential Manager den Nutzern zeigen, wo ihre Anmeldedaten verwendet wurden. Die Umsetzung dieser Änderung wird einige Zeit in Anspruch nehmen. Eine vorübergehende Lösung wäre, sowohl die aktuelle Website als auch die ursprüngliche Registrierungsseite anzuzeigen.