Passkeys coverage (#35943)

Author: guardrex

.openpublishing.redirection.json

@@ -960,11 +960,6 @@
             "redirect_url": "/aspnet/core/tutorials/web-api-javascript",
             "redirect_document_id": false
         },
-        {
-            "source_path": "aspnetcore/migration/index.md",
-            "redirect_url": "/aspnet/core/migration/fx-to-core/",
-            "redirect_document_id": false
-        },
         {
             "source_path": "aspnetcore/migration/proper-to-2x/index.md",
             "redirect_url": "/aspnet/core/migration/fx-to-core/",

aspnetcore/migration/80-90.md

@@ -1,16 +1,15 @@
 ---
 title: Migrate from ASP.NET Core in .NET 8 to ASP.NET Core in .NET 9
 author: wadepickett
-description: Learn how to migrate an ASP.NET Core in .NET 8 to ASP.NET Core in .NET 9
+description: Learn how to migrate an ASP.NET Core in .NET 8 to ASP.NET Core in .NET 9.
 ms.author: wpickett
 ms.date: 2/11/2024
 uid: migration/80-to-90
 ---
-
-<!-- New content should be added to ~/migration/includes/aspnetcore-9/includes/{FILE}.md files. This will help prevent merge conflicts in this file. -->
-
 # Migrate from ASP.NET Core in .NET 8 to ASP.NET Core in .NET 9
 
+<!-- New content should be added to the includes files in the '80-to-90' folder. This will help prevent merge conflicts in this file. -->
+
 This article explains how to update an ASP.NET Core in .NET 8 to ASP.NET Core in .NET 9.
 
 ## Prerequisites

aspnetcore/migration/90-to-100.md

@@ -0,0 +1,84 @@
+---
+title: Migrate from ASP.NET Core in .NET 9 to ASP.NET Core in .NET 10
+author: wadepickett
+description: Learn how to migrate an ASP.NET Core in .NET 9 to ASP.NET Core in .NET 10.
+ms.author: wpickett
+ms.date: 8/14/2025
+uid: migration/90-to-100
+---
+# Migrate from ASP.NET Core in .NET 9 to ASP.NET Core in .NET 10
+
+<!-- New content should be added to the includes files in the '90-to-100' folder. This will help prevent merge conflicts in this file. -->
+
+This article explains how to update an ASP.NET Core in .NET 9 to ASP.NET Core in .NET 10.
+
+## Prerequisites
+
+<!-- NOTE: The prereqs INCLUDES files have are in a poor state these days. I've opened 
+           https://github.com/dotnet/AspNetCore.Docs/issues/35937 to work on them. 
+           For now, we'll use what's available. 
+           
+           I'll remove this remark before merging the passkeys PR. -->
+
+# [Visual Studio](#tab/visual-studio)
+
+[!INCLUDE[](~/includes/net-prereqs-vs-10-latest.md)]
+
+# [Visual Studio Code](#tab/visual-studio-code)
+
+[!INCLUDE[](~/includes/net-prereqs-vsc-10.0.md)]
+
+---
+
+## Update the .NET SDK version in `global.json`
+
+If you rely on a [`global.json`](/dotnet/core/tools/global-json) file to target a specific .NET SDK version, update the `version` property to the .NET 10 SDK version that's installed. For example:
+
+```diff
+{
+  "sdk": {
+-    "version": "9.0.304"
++    "version": "10.0.100"
+  }
+}
+```
+
+## Update the target framework
+
+Update the project file's [Target Framework Moniker (TFM)](/dotnet/standard/frameworks) to `net10.0`:
+
+```diff
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+-    <TargetFramework>net9.0</TargetFramework>
++    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+</Project>
+```
+
+## Update package references
+
+In the project file, update each [`Microsoft.AspNetCore.*`](https://www.nuget.org/packages?q=Microsoft.AspNetCore.*), [`Microsoft.EntityFrameworkCore.*`](https://www.nuget.org/packages?q=Microsoft.EntityFrameworkCore.*), [`Microsoft.Extensions.*`](https://www.nuget.org/packages?q=Microsoft.Extensions.*), and [`System.Net.Http.Json`](https://www.nuget.org/packages/System.Net.Http.Json) package reference's `Version` attribute to 10.0.0 or later. For example:
+
+```diff
+<ItemGroup>
+-   <PackageReference Include="Microsoft.AspNetCore.JsonPatch" Version="9.0.0" />
+-   <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="9.0.0" />
+-   <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="9.0.0" />
+-   <PackageReference Include="System.Net.Http.Json" Version="9.0.0" />
++   <PackageReference Include="Microsoft.AspNetCore.JsonPatch" Version="10.0.0" />
++   <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="10.0.0" />
++   <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="10.0.0" />
++   <PackageReference Include="System.Net.Http.Json" Version="10.0.0" />
+</ItemGroup>
+```
+
+## Blazor
+
+[!INCLUDE[](~/migration/90-to-100/includes/blazor.md)]
+
+## Breaking changes
+
+Use the articles in [Breaking changes in .NET](/dotnet/core/compatibility/breaking-changes) to find breaking changes that might apply when upgrading an app to a newer version of .NET.

aspnetcore/migration/90-to-100/includes/blazor.md

@@ -0,0 +1,5 @@
+Complete migration coverage for Blazor apps is scheduled for September and October of 2025.
+
+### Adopt passkey user authentication in an existing Blazor Web App
+
+For guidance, see <xref:security/authentication/passkeys/blazor?pivots=existing-app>.

aspnetcore/migration/index.md

@@ -0,0 +1,11 @@
+---
+title: Migrate an ASP.NET Core app
+author: wadepickett
+description: Learn how to migrate an ASP.NET Core app.
+ms.author: wpickett
+ms.date: 8/19/2025
+uid: migration/index
+---
+# Migrate an ASP.NET Core app
+
+Use the guidance in this node to migrate an ASP.NET Core app.

aspnetcore/release-notes/aspnetcore-10.0.md

@@ -4,7 +4,7 @@ author: wadepickett
 description: Learn about the new features in ASP.NET Core in .NET 10.
 ms.author: wpickett
 ms.custom: mvc
-ms.date: 08/14/2025
+ms.date: 8/14/2025
 uid: aspnetcore-10
 ---
 # What's new in ASP.NET Core in .NET 10

aspnetcore/release-notes/aspnetcore-10/includes/blazor.md

@@ -601,13 +601,12 @@ For more information, see <xref:blazor/host-and-deploy/webassembly/bundle-cachin
 
 [Web Authentication (WebAuthn) API](https://developer.mozilla.org/docs/Web/API/Web_Authentication_API) support, known widely as *passkeys*, is a modern, phishing-resistant authentication method that improves security and user experience by leveraging public key cryptography and device-based authentication. ASP.NET Core Identity now supports passkey authentication based on WebAuthn and FIDO2 standards. This feature allows users to sign in without passwords, using secure, device-based authentication methods, such as biometrics or security keys.
 
-The Preview 7 Blazor Web App project template provides out-of-the-box passkey management and login functionality:
+The Blazor Web App project template provides out-of-the-box passkey management and login functionality.
 
-```dotnetcli
-dotnet new blazor -au Individual -o BlazorWebAppPasskeySample
-```
+For more information, see the following articles:
 
-We plan to publish migration guidance for existing apps by Friday, August 15.
+* <xref:security/authentication/passkeys/index>
+* <xref:security/authentication/passkeys/blazor>
 
 ### Circuit state persistence