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.comundexample.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.comundacmerewards.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.
Anfragen zu ähnlichen Ursprüngen einrichten
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-2erstellen und sich damit authentifizieren, obwohl die RP-IDror-1(und nichtror-2) lautet. - Wenn Sie einen Passkey auf
ror-1oderror-2erstellt haben, können Sie sich damit sowohl aufror-1als auch aufror-2authentifizieren. Daror-2ror-1als 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-1oderror-2erstellen, kann er von Chrome sowohl aufror-1als auch aufror-2automatisch ausgefüllt werden. - Anmeldedaten, die auf einer dieser Websites erstellt werden, haben die RP-ID
ror-1.
Code anzeigen:
- Sehen Sie sich die Datei
/.well-known/webauthnan, die in der ror-1-Codebasis eingerichtet ist. RP_ID_RORVorkommen 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.comals RP-ID in denoptionsfür die Erstellung von Anmeldedaten fest, die an den Frontend-Aufrufnavigator.credentials.createübergeben und normalerweise serverseitig generiert werden. - Legen Sie
site-1.comals erwartete RP-ID fest, da Sie die Anmeldedaten überprüfen, bevor Sie sie in Ihrer Datenbank speichern.
- Legen Sie
- Nach der Authentifizierung:
- Legen Sie
site-1.comals RP-ID in den Authentifizierungs-optionsfest, die an den Frontend-Aufrufnavigator.credentials.getübergeben und normalerweise serverseitig generiert werden. - Legen Sie
site-1.comals erwartete RP-ID fest, die auf dem Server überprüft werden soll, da Sie die Anmeldedaten vor der Authentifizierung des Nutzers überprüfen.
- Legen Sie
Fehlerbehebung
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:
- In Chrome: Digital Asset Links. Weitere Informationen findest du unter Unterstützung für Digital Asset Links hinzufügen.
- In Safari: Verknüpfte Domains.
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.