Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Handbuch wird erläutert, wie Sie die Passkeyunterstützung für ein neues oder vorhandenes Blazor Web App mit ASP.NET Core Identityimplementieren.
Eine Übersicht über Passkeys und allgemeine Konfigurationsanleitungen finden Sie unter Aktivieren von Webauthentifizierungs-API (WebAuthn) Passkeys.
Voraussetzungen
.NET SDK (.NET 10 oder höher)
Erstellen der Datei Blazor Web App
Verwenden Sie die folgenden Anleitungen, um ein neues Blazor Web App mit ASP.NET Core Identityzu erstellen, das Passkeys-Unterstützung enthält.
Hinweis
Visual Studio 2022 oder höher und .NET 10 oder höher SDK sind erforderlich.
In Visual Studio:
- Wählen Sie im Startfenster die Option Neues Projekt erstellen aus. Wählen Sie alternativ auf der Menüleiste Datei>Neu>Projekt aus.
- Wählen Sie im Dialogfeld Neues Projekt erstellen in der Liste der Projektvorlagen Blazor Web App aus. Wählen Sie die Schaltfläche Weiter aus.
- Benennen Sie im Dialogfeld Neues Projekt konfigurieren das Projekt im Feld Projektname mit
BlazorWebAppPasskeys, und achten Sie dabei auf die entsprechende Groß-/Kleinschreibung. Die Verwendung dieses genauen Projektnamens ist wichtig, um sicherzustellen, dass die Namespaces mit Code übereinstimmen, den Sie aus dem Artikel in die App kopieren, die Sie erstellen. - Vergewissern Sie sich, dass der Standort für die App geeignet ist. Lassen Sie das Kontrollkästchen Legen Sie die Projektmappe und das Projekt im selben Verzeichnis ab aktiviert. Wählen Sie die Schaltfläche Weiter aus.
- Legen Sie im Dialogfeld "Zusätzliche Informationen " den Authentifizierungstyp auf "Einzelne Konten" fest. Verwenden Sie die folgenden Einstellungen für die anderen Optionen:
- Framework: Neueste Framework-Version (.NET 10 oder höher)
- Für HTTPS konfigurieren: Aktiviert
- Interaktiver Rendermodus: Server
- Interaktivitätsort: Global
- Beispielseiten einschließen: Aktiviert
- Keine Anweisungen der obersten Ebene verwenden: Nicht aktiviert
- Verwenden Sie die .dev.localhost TLD in der Anwendungs-URL: Nicht ausgewählt
- Wählen Sie "Erstellen" aus.
Die vorherigen Anweisungen erstellen ein Blazor Web App mit:
- ASP.NET Core Identity für die Benutzerauthentifizierung unter Verwendung der
-au|--authentication-Option konfiguriert. - Entity Framework Core mit SQLite für die Datenspeicherung.
- Passkey-Registrierung und Authentifizierungsendpunkte.
- UI-Komponenten zur Verwaltung von Passkeys.
Hinweis
Derzeit enthält nur die Blazor Web App Projektvorlage integrierte Passkeyunterstützung.
Ausführen der Anwendung
Drücken Sie F5-, um die App mit Debugging auszuführen, oder STRG+F5-, um die App ohne Debugging auszuführen.
Die folgende Anleitung basiert auf einer App, die mit Einzelne Konten für den Authentifizierungstyp oder die Gerüsterstellung Identity einer vorhandenen App erstellt wurde.
Voraussetzungen
- Ein vorhandenes Blazor Web App (.NET 10 oder höher) mit ASP.NET Core Identity
- .NET SDK (.NET 10 oder höher)
Anleitungen zur Migration finden Sie unter Migrieren einer ASP.NET Core-App.
Referenzquellenleitfaden
Die Links in diesem Artikel zum .NET-Referenzquellcode laden den Standardbranch des Repositorys, der den aktuellen Entwicklungsstand für die nächste .NET-Version darstellt. Um ein Tag für ein bestimmtes Release auszuwählen, wählen Sie diesen mit der Dropdownliste Switch branches or tags (Branches oder Tags wechseln) aus.
Schemaversion aktualisieren Identity
Aktualisieren Sie in Program.cs die Konfiguration Identity so, dass Schema-Version 3 verwendet wird, die die Passkey-Unterstützung umfasst:
builder.Services.AddIdentityCore<ApplicationUser>(options =>
{
options.SignIn.RequireConfirmedAccount = true;
options.Stores.SchemaVersion = IdentitySchemaVersions.Version3;
})
.AddEntityFrameworkStores<ApplicationDbContext>()
.AddSignInManager()
.AddDefaultTokenProviders();
Erstellen und Ausführen einer Datenbankmigration
Doppelklicken Sie im Projektmappen-Explorer von Visual Studio auf Verbundene Dienste. Wählen Sie im Bereich "Dienstabhängigkeiten " die Auslassungspunkte (...) gefolgt von "Migration hinzufügen " im BEREICH SQL Server Express LocalDB aus.
Geben Sie der Migration den MigrationsnamenAddPasskeySupport, um die Migration zu beschreiben. Warten Sie, bis der Datenbankkontext im Feld "DbContext-Klassennamen " geladen wird. Wählen Sie "Fertig stellen" aus, um die Migration zu erstellen. Wählen Sie die Schaltfläche " Schließen " aus, wenn der Vorgang abgeschlossen ist.
Wählen Sie erneut die Ellipse (...) und anschließend den Befehl Datenbank aktualisieren aus.
Das Dialogfeld Datenbank mit der neuesten Migration aktualisieren wird geöffnet. Warten Sie, bis das DbContext-Klassennamen-Feld aktualisiert wurde und frühere Migrationen geladen sind. Wählen Sie die Schaltfläche "Fertig stellen" aus . Wählen Sie die Schaltfläche " Schließen " aus, wenn der Vorgang abgeschlossen ist.
Passkey-Modellklassen erstellen
Fügen Sie dem Projekt im Components/Account Ordner die folgenden Modellklassen hinzu, und aktualisieren Sie den Namespace so, dass er BlazorWebCSharp._1.Components.Account mit der App übereinstimmt (z. B.: ): Contoso.Components.Account
Components/Account/PasskeyInputModel.cs: Enthält die JSON-Passkey-Anmeldeinformationen für Passkey-Anmeldevorgänge (LoginKomponente) und das Hinzufügen von Passkeys (PasskeysKomponente).Components/Account/PasskeyOperation.cs: Definiert die auszuführende Authentifizierungsaktion (PassKeySubmitKomponente), entweder das Registrieren eines neuen Schlüssels (Create/0) oder die Authentifizierung mit einem vorhandenen Passkey (Request/1).
-
Components/Account/PasskeyAuthenticators.cs: Ordnet Authenticator Attestation GUIDs (AAGUIDs) benutzerfreundlichen Anzeigenamen zu, sodass ein neuer Passkey von einem bekannten Authenticator automatisch benannt wird, anstatt den Benutzer zur Eingabe aufzufordern.
Erstellen der PasskeySubmit Komponente
Fügen Sie die folgende PasskeySubmit Komponente zum Behandeln von Passkeyvorgängen hinzu:
Components/Account/Shared/PasskeySubmit.razor
JavaScript für Passkey-Vorgänge hinzufügen
Fügen Sie die folgende JavaScript-Datei zum Behandeln von WebAuthn-API-Interaktionen hinzu:
Components/Account/Shared/PasskeySubmit.razor.js
Passkey-Endpunkte hinzufügen
Aktualisieren Sie die Datei IdentityComponentsEndpointRouteBuilderExtensions.cs (oder erstellen Sie die Datei, falls sie nicht vorhanden ist, und rufen Sie MapAdditionalIdentityEndpoints in der Datei Program auf), um die Passkey-spezifischen Endpunkte aufzunehmen:
/PasskeyCreationOptions und /PasskeyRequestOptions Endpunkte
Aktualisieren der Anmeldeseite
Ersetzen Sie die vorhandene Login Komponente durch die folgende Komponente, und aktualisieren Sie den Namespace so, dass er BlazorWebCSharp._1.Data mit der App übereinstimmt (z. B.: ): Contoso.Components.Account.Data
Components/Account/Pages/Login.razor
Erstellen von Passkey-Verwaltungsseiten zum Hinzufügen und Umbenennen von Passkeys
Fügen Sie die folgende Passkeys Komponente zum Verwalten von Schlüsseln hinzu, und aktualisieren Sie den Namespace so, dass er BlazorWebCSharp._1.Data mit der App übereinstimmt (z. B.: ): Contoso.Components.Account.Data
Components/Account/Pages/Manage/Passkeys.razor
Fügen Sie die folgende RenamePasskey Komponente zum Umbenennen von Passkeys hinzu, und aktualisieren Sie den Namespace so, dass er BlazorWebCSharp._1.Data mit der App übereinstimmt (z. B.: ): Contoso.Components.Account.Data
Components/Account/Pages/Manage/RenamePasskey.razor
Aktualisieren des Menüs "Navigation verwalten"
Fügen Sie in der App-Komponente einen Link zur Kennungsverwaltungsseite ManageNavMenu hinzu.
In Components/Account/Shared/ManageNavMenu.razor fügen Sie die folgende NavLink Komponente für die Passkeys Komponente hinzu:
<li class="nav-item">
<NavLink class="nav-link" href="Account/Manage/Passkeys">Passkeys</NavLink>
</li>
Einschließen der JavaScript-Datei
Suchen Sie in der App Komponente (Components/App.razor) das Blazor Skript-Tag :
<script src="@Assets["_framework/blazor.web.js"]"></script>
Fügen Sie unmittelbar nach dem Blazor Skripttag einen Verweis auf das PasskeySubmit JavaScript-Modul hinzu:
<script src="@Assets["Components/Account/Shared/PasskeySubmit.razor.js"]" type="module"></script>
Registrieren eines Kennungsschlüssels
So testen Sie die Passkey-Funktionalität:
- Registrieren Sie ein neues Konto, oder melden Sie sich mit einem vorhandenen Konto an.
- Navigieren Sie zu "Konto verwalten " (wählen Sie den Benutzernamen im Navigationsmenü aus).
- Wählen Sie im Navigationsmenü Passkeys aus.
- Wählen Sie "Neuen Schlüssel hinzufügen" aus.
- Folgen Sie den Anweisungen des Browsers, um einen Passkey mithilfe des Authentifikators Ihres Geräts zu erstellen.
Mit einem Passkey anmelden
Nach der Registrierung eines Passkeys:
- Melden Sie sich bei der App ab.
- Geben Sie auf der Anmeldeseite Ihre E-Mail-Adresse ein.
- Wählen Sie "Anmelden mit einem Schlüssel" aus.
- Folgen Sie den Anweisungen des Browsers, um sich bei Ihrem Kennungsschlüssel zu authentifizieren.
- Navigieren Sie zu
Account/Manage/Passkeys, um Passkeys hinzuzufügen, umzubenennen oder zu löschen. - Wenn der Passkey das automatische Ausfüllen mit Passkeys (Conditional UI) beim Anmelden unterstützt, testen Sie die Funktion zum automatischen Ausfüllen mit Passkeys, indem Sie das E-Mail-Eingabefeld auswählen, wenn Sie gespeicherte Passkeys haben.
Beheben Sie den PublicKeyCredential.toJSON Fehler (TypeError: Illegal invocation)
Einige Kennwortmanager implementieren die PublicKeyCredential.toJSON Methode nicht ordnungsgemäß, was erforderlich JSON.stringify ist, um beim Serialisieren von Schlüsselanmeldeinformationen zu arbeiten. Beim Registrieren oder Authentifizieren eines Benutzers mit einer App, die auf der Blazor Web App-Projektvorlage basiert, tritt beim Versuch, einen Passkey hinzuzufügen, der folgende Fehler auf:
Error: Could not add a passkey: Illegal invocation
Anleitungen zum Beheben dieses Fehlers finden Sie unter Aktivieren von Webauthentifizierungs-API (WebAuthn) Passkeys.