Merge pull request #36815 from dotnet/main

Merge to Live

Author: wadepickett

aspnetcore/security/authentication/identity-configuration.md

@@ -1,11 +1,12 @@
 ---
 title: Configure ASP.NET Core Identity
+ai-usage: ai-assisted
 author: AdrienTorris
 description: Understand ASP.NET Core Identity default values and learn how to configure Identity properties to use custom values.
 ms.author: tdykstra
 monikerRange: '>= aspnetcore-3.1'
 ms.custom: mvc
-ms.date: 3/09/2024
+ms.date: 02/24/2026
 uid: security/authentication/identity-configuration
 ---
 # Configure ASP.NET Core Identity
@@ -119,7 +120,7 @@ The following code sets `SignIn` settings (to default values):
 
 ### Cookie settings
 
-Configure the app's cookie in `Program.cs`. [ConfigureApplicationCookie](xref:Microsoft.Extensions.DependencyInjection.IdentityServiceCollectionExtensions.ConfigureApplicationCookie(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.Action{Microsoft.AspNetCore.Authentication.Cookies.CookieAuthenticationOptions})) must be called **after** calling `AddIdentity` or `AddDefaultIdentity`.
+Configure the app's cookie in `Program.cs`. [ConfigureApplicationCookie](xref:Microsoft.Extensions.DependencyInjection.IdentityServiceCollectionExtensions.ConfigureApplicationCookie(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.Action{Microsoft.AspNetCore.Authentication.Cookies.CookieAuthenticationOptions})) must be called **after** calling `AddIdentityCore`, `AddIdentity`, or `AddDefaultIdentity`.
 
 [!code-csharp[](identity-configuration/sample6/RPauth/Program.cs?name=snippet_cookie)]
 
@@ -267,7 +268,7 @@ The following code sets `SignIn` settings (to default values):
 
 ### Cookie settings
 
-Configure the app's cookie in `Startup.ConfigureServices`. [ConfigureApplicationCookie](xref:Microsoft.Extensions.DependencyInjection.IdentityServiceCollectionExtensions.ConfigureApplicationCookie(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.Action{Microsoft.AspNetCore.Authentication.Cookies.CookieAuthenticationOptions})) must be called **after** calling `AddIdentity` or `AddDefaultIdentity`.
+Configure the app's cookie in `Startup.ConfigureServices`. [ConfigureApplicationCookie](xref:Microsoft.Extensions.DependencyInjection.IdentityServiceCollectionExtensions.ConfigureApplicationCookie(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.Action{Microsoft.AspNetCore.Authentication.Cookies.CookieAuthenticationOptions})) must be called **after** calling `AddIdentityCore`, `AddIdentity`, or `AddDefaultIdentity`.
 
 [!code-csharp[](identity-configuration/sample/Startup.cs?name=snippet_cookie)]
 

aspnetcore/security/authentication/social/facebook-logins.md

@@ -1,62 +1,39 @@
 ---
 title: Facebook external login setup in ASP.NET Core
+ai-usage: ai-assisted
 author: wadepickett
 description: Tutorial with code examples demonstrating the integration of Facebook account user authentication into an existing ASP.NET Core app.
-ms.author: wpickett
-ms.custom: mvc, sfi-image-nochange
-ms.date: 12/08/2021
 monikerRange: '>= aspnetcore-3.0'
+ms.author: wpickett
+ms.custom: mvc
+ms.date: 02/27/2026
 uid: security/authentication/facebook-logins
 ---
 
 # Facebook external login setup in ASP.NET Core
 
 By [Valeriy Novytskyy](https://github.com/01binary) and [Rick Anderson](https://twitter.com/RickAndMSFT)
 
-<!-- per @rick-anderson and scott addie, don't update images. Remove images and point the customer to the FB set up page. FB needs to maintain  instructions to get key and secret.
--->
-
-This tutorial with code examples shows how to enable your users to sign in with their Facebook account using a sample ASP.NET Core project created on the [previous page](xref:security/authentication/social/index). We start by creating a Facebook App ID by following the [official steps](https://developers.facebook.com).
+This tutorial with code examples shows how to enable your users to sign in with their Facebook account using a sample ASP.NET Core project created on the [previous page](xref:security/authentication/social/index).
 
 ## Create the app in Facebook
 
 * Add the [Microsoft.AspNetCore.Authentication.Facebook](https://www.nuget.org/packages/Microsoft.AspNetCore.Authentication.Facebook) NuGet package to the project.
 
-* Navigate to the [Facebook Developers app](https://developers.facebook.com/apps/) page and sign in. If you don't already have a Facebook account, use the **Sign up for Facebook** link on the login page to create one.  Once you have a Facebook account, follow the instructions to register as a Facebook Developer.
-
-* From the **My Apps** menu select **Create App**. The **Create an app** form appears.
-   ![Facebook for developers portal open in Microsoft Edge](index/_static/FBMyApps.png)
-
-* Select an app type that best fits your project. For this project, select **Consumer**, and then **Next**. A new App ID is created.
-
-* Fill out the form and tap the **Create App** button.
-
-  ![Create a New App ID form](index/_static/FBNewAppId.png)
+* Follow the [Facebook App Registration](https://developers.facebook.com/docs/apps/register) instructions to create a Facebook app and obtain your **App ID** and **App Secret**.
 
-* On the **Add Products to Your App** page, select **Set Up** on the **Facebook Login** card.
+* Follow the [Facebook Login for Web](https://developers.facebook.com/docs/facebook-login/web) instructions to configure Facebook Login for your app. Add your development URI with */signin-facebook* appended (for example: `https://localhost:44320/signin-facebook`) to the **Valid OAuth Redirect URIs**.
 
-  ![Product Setup page](index/_static/FBProductSetup.png)
-
-* The **Quickstart** wizard launches with **Choose a Platform** as the first page. Bypass the wizard for now by clicking the **FaceBook Login** **Settings** link in the menu on the lower left:
-
-  ![Skip Quick Start](index/_static/FBSkipQuickStart.png)
-
-* The **Client OAuth Settings** page is presented:
-
-  ![Client OAuth Settings page](index/_static/FBOAuthSetup.png)
-
-* Enter your development URI with */signin-facebook* appended into the **Valid OAuth Redirect URIs** field (for example: `https://localhost:44320/signin-facebook`). The Facebook authentication configured later in this tutorial will automatically handle requests at */signin-facebook* route to implement the OAuth flow.
+  The Facebook authentication configured later in this tutorial automatically handles requests at the */signin-facebook* route to implement the OAuth flow.
 
 > [!NOTE]
 > The URI */signin-facebook* is set as the default callback of the Facebook authentication provider. You can change the default callback URI while configuring the Facebook authentication middleware via the inherited <xref:Microsoft.AspNetCore.Authentication.RemoteAuthenticationOptions.CallbackPath%2A?displayProperty=nameWithType> property of the <xref:Microsoft.AspNetCore.Authentication.Facebook.FacebookOptions> class.
 
-* Select **Save Changes**.
-
-* Select **Settings** > **Basic** link in the left navigation.
+* Follow the [Facebook Login Permissions](https://developers.facebook.com/docs/facebook-login/permissions) guide to enable the **email** permission for your app. The ASP.NET Core Facebook authentication middleware requests the `email` scope by default. If the **email** permission isn't enabled on your Facebook app, authentication may fail or the user's email address will be missing after sign-in.
 
-* Make a note of your `App ID` and your `App Secret`. You will add both into your ASP.NET Core application in the next section:
+* Make a note of your **App ID** and **App Secret**. You add both into your ASP.NET Core application in the next section.
 
-* When deploying the site you need to revisit the **Facebook Login** setup page, and register a new public URI.
+* When deploying the site, revisit the **Facebook Login** setup page and register a new public URI.
 
 ## Store the Facebook app ID and secret
 
@@ -106,7 +83,7 @@ Add the Authentication service to the `Program`:
 * Enter your Facebook credentials.
 * You are redirected back to your site where you can set your email.
 
-You are now logged in using your Facebook credentials:
+You are now logged in using your Facebook credentials.
 
 <a name="react"></a>
 
@@ -143,6 +120,7 @@ For more information on configuration options supported by Facebook authenticati
 
 * **ASP.NET Core 2.x only:** If Identity isn't configured by calling `services.AddIdentity` in `ConfigureServices`, attempting to authenticate will result in *ArgumentException: The 'SignInScheme' option must be provided*. The project template used in this tutorial ensures that this is done.
 * If the site database has not been created by applying the initial migration, you get *A database operation failed while processing the request* error. Tap **Apply Migrations** to create the database and refresh to continue past the error.
+* If you receive an error during Facebook sign-in or the user's email address is missing after sign-in, verify that the **email** permission is enabled for your Facebook app. See the [Facebook Login Permissions](https://developers.facebook.com/docs/facebook-login/permissions) guide for details on enabling permissions in the Facebook Developer portal.
 
 ## Next steps
 

aspnetcore/security/authentication/social/index/_static/FBLogin.png

@@ -1,10 +1,11 @@
 ---
 title: Part 8, add a new field to an ASP.NET Core MVC app
+ai-usage: ai-assisted
 author: wadepickett
 description: Part 8 of tutorial series on ASP.NET Core MVC.
 monikerRange: '>= aspnetcore-3.1'
 ms.author: wpickett
-ms.date: 01/22/2026
+ms.date: 02/24/2026
 uid: tutorials/first-mvc-app/new-field
 ---
 # Part 8, add a new field to an ASP.NET Core MVC app
@@ -66,7 +67,9 @@ You can copy/paste the previous "form group" and let intelliSense help you updat
 
 # [Visual Studio Code](#tab/visual-studio-code)
 
-:::image type="content" source="~/tutorials/first-mvc-app/new-field/media/vscode-update-form.png" alt-text="Updating the existed form by inserting the new field Rating.":::
+You can copy/paste the previous "form group" and let IntelliSense help you update the fields. IntelliSense works with [Tag Helpers](xref:mvc/views/tag-helpers/intro). The [C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit) extension provides IntelliSense support in Visual Studio Code.
+
+:::image type="content" source="~/tutorials/first-mvc-app/new-field/media/vscode-update-form.png" alt-text="Updating the existing form by inserting the new field Rating.":::
 
 ---
 

aspnetcore/security/authentication/social/index/_static/FBMyApps.png

@@ -54,7 +54,9 @@ You can copy/paste the previous "form group" and let intelliSense help you updat
 
 # [Visual Studio Code](#tab/visual-studio-code)
 
-![Updating the existed form by inserting the new field "Rating".](~/tutorials/first-mvc-app/new-field/_static/VSCode-UpdatingForm.png)
+You can copy/paste the previous "form group" and let IntelliSense help you update the fields. IntelliSense works with [Tag Helpers](xref:mvc/views/tag-helpers/intro). The [C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit) extension provides IntelliSense support in Visual Studio Code.
+
+![Updating the existing form by inserting the new field "Rating".](~/tutorials/first-mvc-app/new-field/_static/VSCode-UpdatingForm.png)
 
 ---