Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questa guida illustra come implementare il supporto passkey per un elemento nuovo o esistente Blazor Web App con ASP.NET Core Identity.
Per una panoramica delle passkey e delle linee guida generali per la configurazione, vedere Abilitare passkey api di autenticazione Web (WebAuthn).
Prerequisiti
.NET SDK (.NET 10 o versione successiva)
Crea un Blazor Web App
Usa le indicazioni seguenti per creare un nuovo Blazor Web App con ASP.NET Core Identity, che include il supporto per le passkey.
Annotazioni
Sono necessari Visual Studio 2022 o versione successiva e l'SDK di .NET 10 o versione successiva.
In Visual Studio:
- Selezionare Crea un nuovo progetto dalla finestra di avvio o selezionare File>> dalla barra dei menu.
- Nella finestra di dialogo Crea un nuovo progetto selezionare Blazor Web App dall'elenco dei modelli di progetto. Seleziona il pulsante Avanti.
- Nella finestra di dialogo Configura il nuovo progetto, assegna al progetto il nome
BlazorWebAppPasskeysnel campo Nome progetto, rispettando anche l'uso di maiuscole e minuscole. Usare esattamente questo nome di progetto è importante per garantire che i namespace corrispondano a quelli del codice che copi dall'articolo nell'applicazione che stai creando. - Verificare che la posizione per l'app sia adatta. Lascia selezionata la casella di controllo Posiziona soluzione e progetto nella stessa directory. Seleziona il pulsante Avanti.
- Nella finestra di dialogo Informazioni aggiuntive, imposta Tipo di autenticazione su Account individuali. Usare le impostazioni seguenti per le altre opzioni:
- Framework: versione più recente del framework (.NET 10 o versione successiva)
- Configura per HTTPS: selezionato
- Modalità di rendering interattiva: Server
- Posizione di interattività: Globale
- Includi pagine di esempio: selezionato
- Non usare istruzioni di primo livello: Non selezionato
- Usare il TLD .dev.localhost nell'URL dell'applicazione: Non selezionato
- Fare clic su Crea.
Le istruzioni precedenti creano un oggetto Blazor Web App con:
- ASP.NET Core Identity configurato per l'autenticazione utente tramite l'
-au|--authenticationopzione. - Entity Framework Core con SQLite per l'archiviazione dei dati.
- Endpoint per la registrazione e l'autenticazione di passkey.
- Componenti dell'interfaccia utente per la gestione dei passkey.
Annotazioni
Attualmente, solo il modello di progetto Blazor Web App include il supporto integrato per le passkey.
Eseguire l'applicazione
Premere F5 per eseguire l'app con debug o CTRL+F5 per eseguire l'app senza eseguire il debug.
Le indicazioni seguenti si basano su un'app creata con Account individuali per il tipo di autenticazione dell'app o l'aggiunta dello scaffolding Identity a un'app esistente.
Prerequisiti
- Un Blazor Web App esistente (.NET 10 o versioni successive) con ASP.NET Core Identity
- .NET SDK (.NET 10 o versione successiva)
Per indicazioni sulla migrazione, vedere Eseguire la migrazione di un'app ASP.NET Core.
Linee guida sulla fonte di riferimento
I collegamenti in questo articolo all'origine di riferimento .NET caricano il ramo predefinito del repository, che rappresenta lo sviluppo corrente per la versione successiva di .NET. Per selezionare un tag per una versione specifica, utilizzare il menu a tendina Seleziona rami o tag.
Aggiornare la Identity versione dello schema
In Program.cs, aggiorna la configurazione Identity per usare la versione 3 dello schema, che include il supporto per le passkey:
builder.Services.AddIdentityCore<ApplicationUser>(options =>
{
options.SignIn.RequireConfirmedAccount = true;
options.Stores.SchemaVersion = IdentitySchemaVersions.Version3;
})
.AddEntityFrameworkStores<ApplicationDbContext>()
.AddSignInManager()
.AddDefaultTokenProviders();
Creare ed eseguire una migrazione del database
In Esplora soluzioni di Visual Studio fare doppio clic su Servizi connessi. Nell'area Dipendenze servizio, selezionare i puntini di sospensione (...), quindi Aggiungi migrazione nell'area SQL Server Express LocalDB.
Assegnare alla migrazione un nome di migrazione di AddPasskeySupport per descrivere la migrazione. Attendi che il contesto del database venga caricato nel campo Nomi classi DbContext. Selezionare Fine per creare la migrazione. Selezionare il pulsante Chiudi al termine dell'operazione.
Selezionare di nuovo i puntini di sospensione (...) seguiti dal comando Aggiorna database .
Verrà visualizzata la finestra di dialogo Aggiorna database con la migrazione più recente . Attendere che il campo nomi delle classi DbContext venga aggiornato e che vengano caricate le migrazioni precedenti. Selezionare il pulsante Fine . Selezionare il pulsante Chiudi al termine dell'operazione.
Creare classi di modelli passkey
Aggiungere le classi di modello seguenti al progetto nella Components/Account cartella e aggiornare lo BlazorWebCSharp._1.Components.Account spazio dei nomi in modo che corrisponda all'app (ad esempio: Contoso.Components.Account):
Components/Account/PasskeyInputModel.cs: contiene la credenziale JSON della passkey per le operazioni di accesso con passkey (Logincomponente) e l'aggiunta di passkey (Passkeyscomponente).Components/Account/PasskeyOperation.cs: definisce l'azione di autenticazione da eseguire (PassKeySubmitcomponente), registrando una nuova passkey (Create/0) o eseguendo l'autenticazione con una passkey esistente (Request/1).
-
Components/Account/PasskeyAuthenticators.cs: associa i GUID di attestazione dell'autenticatore (AAGUID) a nomi visualizzati intuitivi, in modo che a una nuova chiave di accesso proveniente da un autenticatore noto venga assegnato automaticamente un nome anziché chiedere all'utente di specificarlo.
Crea il componente PasskeySubmit
Aggiungere il componente seguente PasskeySubmit per gestire le operazioni passkey:
Components/Account/Shared/PasskeySubmit.razor
Aggiungi JavaScript per le operazioni con passkey
Aggiungere il file JavaScript seguente per gestire le interazioni dell'API WebAuthn:
Components/Account/Shared/PasskeySubmit.razor.js
Aggiungere endpoint passkey
Aggiornare il IdentityComponentsEndpointRouteBuilderExtensions.cs file (o creare il file se non esiste e chiamare MapAdditionalIdentityEndpoints nel Program file) per includere gli endpoint specifici della passkey:
endpoint /PasskeyCreationOptions e /PasskeyRequestOptions
Aggiorna la pagina di accesso
Sostituire il componente esistente Login con il componente seguente e aggiornare lo BlazorWebCSharp._1.Data spazio dei nomi in modo che corrisponda all'app (ad esempio: Contoso.Components.Account.Data):
Components/Account/Pages/Login.razor
Creare pagine di gestione passkey per l'aggiunta e la ridenominazione di passkey
Aggiungere il componente seguente Passkeys per la gestione delle chiavi di accesso e aggiornare lo spazio dei nomi BlazorWebCSharp._1.Data in modo che corrisponda all'app (ad esempio: Contoso.Components.Account.Data):
Components/Account/Pages/Manage/Passkeys.razor
Aggiungere il componente seguente RenamePasskey per rinominare le passkey e aggiornare lo BlazorWebCSharp._1.Data spazio dei nomi in modo che corrisponda all'app (ad esempio: Contoso.Components.Account.Data):
Components/Account/Pages/Manage/RenamePasskey.razor
Aggiornare il menu di navigazione Gestisci
Aggiungere un collegamento alla pagina di gestione delle chiavi di accesso nel componente ManageNavMenu dell'app.
In Components/Account/Shared/ManageNavMenu.razor, aggiungere il seguente componente NavLink per il componente Passkeys:
<li class="nav-item">
<NavLink class="nav-link" href="Account/Manage/Passkeys">Passkeys</NavLink>
</li>
Includere il file JavaScript
Nel App componente (Components/App.razor), individuare il tag Blazor script:
<script src="@Assets["_framework/blazor.web.js"]"></script>
Subito dopo il Blazor tag script, aggiungere un riferimento al PasskeySubmit modulo JavaScript:
<script src="@Assets["Components/Account/Shared/PasskeySubmit.razor.js"]" type="module"></script>
Registrare una passkey
Per testare la funzionalità passkey:
- Registrare un nuovo account o accedere con un account esistente.
- Passare a Gestisci l'account (selezionare il nome utente nel menu di spostamento).
- Selezionare Passkeys dal menu di navigazione.
- Selezionare Aggiungi una nuova passkey
- Seguire le istruzioni del browser per creare una passkey usando l'autenticatore del dispositivo.
Accedi con una passkey
Dopo la registrazione di una passkey:
- Esci dall'app.
- Nella pagina di accesso immettere l'indirizzo di posta elettronica.
- Selezionare Accedi con una passkey.
- Seguire le istruzioni del browser per l'autenticazione con la passkey.
- Vai a
Account/Manage/Passkeysper aggiungere, rinominare o eliminare le chiavi di accesso. - Se la passkey supporta la compilazione automatica con passkey (UI condizionale) per l'accesso, prova la funzionalità di compilazione automatica con passkey selezionando il campo email se hai delle passkey salvate.
Attenuare l'errore PublicKeyCredential.toJSON (TypeError: Illegal invocation)
Alcuni gestori di password non implementano correttamente il metodo
Error: Could not add a passkey: Illegal invocation
Per indicazioni sulla mitigazione di questo errore, vedere Abilitare passkey api di autenticazione Web (WebAuthn).