toc.yml

items:
  - name: ASP.NET Core documentation
    href: index.yml
  - name: Overview
    uid: index
  - name: Get started
    uid: get-started
  - name: What's new
    items:
      - name: ASP.NET Core 11
        items:
          - name: What's new in 11
            uid: aspnetcore-11
      - name: ASP.NET Core 10
        items:
          - name: What's new in 10
            uid: aspnetcore-10
          - name: Breaking changes
            items:
              - name: Overview
                href: breaking-changes/10/overview.md
              - name: Cookie login redirects disabled for known API endpoints
                href: breaking-changes/10/cookie-authentication-api-endpoints.md
              - name: Deprecation of WithOpenApi extension method
                href: breaking-changes/10/withopenapi-deprecated.md
              - name: Exception diagnostics suppressed when TryHandleAsync returns true
                href: breaking-changes/10/exception-handler-diagnostics-suppressed.md
              - name: IActionContextAccessor and ActionContextAccessor are obsolete
                href: breaking-changes/10/iactioncontextaccessor-obsolete.md
              - name: IncludeOpenAPIAnalyzers property and MVC API analyzers are deprecated
                href: breaking-changes/10/openapi-analyzers-deprecated.md
              - name: IPNetwork and ForwardedHeadersOptions.KnownNetworks are obsolete
                href: breaking-changes/10/ipnetwork-knownnetworks-obsolete.md
              - name: Microsoft.Extensions.ApiDescription.Client package deprecated
                href: breaking-changes/10/apidescription-client-deprecated.md
              - name: Razor run-time compilation is obsolete
                href: breaking-changes/10/razor-runtime-compilation-obsolete.md
              - name: WebHostBuilder, IWebHost, and WebHost are obsolete
                href: breaking-changes/10/webhostbuilder-deprecated.md
      - name: ASP.NET Core 9
        items:
          - name: What's new in 9
            uid: aspnetcore-9
          - name: Breaking changes
            items:
              - name: Overview
                href: breaking-changes/9/overview.md
              - name: DefaultKeyResolution.ShouldGenerateNewKey has altered meaning
                href: breaking-changes/9/key-resolution.md
              - name: Dev cert export no longer creates folder
                href: breaking-changes/9/certificate-export.md
              - name: Forwarded Headers Middleware ignores X-Forwarded-* headers from unknown proxies
                href: breaking-changes/8/forwarded-headers-unknown-proxies.md
              - name: HostBuilder enables ValidateOnBuild/ValidateScopes in development environment
                href: breaking-changes/9/hostbuilder-validation.md
              - name: Legacy Mono and Emscripten APIs not exported to global namespace
                href: breaking-changes/9/legacy-apis.md
              - name: Middleware types with multiple constructors
                href: breaking-changes/9/middleware-constructors.md
      - name: ASP.NET Core 8
        items:
          - name: What's new in 8
            uid: aspnetcore-8
          - name: Breaking changes
            items:
              - name: Overview
                href: breaking-changes/8/overview.md
              - name: ConcurrencyLimiterMiddleware is obsolete
                href: breaking-changes/8/concurrencylimitermiddleware-obsolete.md
              - name: Custom converters for serialization removed
                href: breaking-changes/8/problemdetails-custom-converters.md
              - name: Forwarded Headers Middleware ignores X-Forwarded-* headers from unknown proxies
                href: breaking-changes/8/forwarded-headers-unknown-proxies.md
              - name: HTTP logging middleware requires AddHttpLogging()
                href: breaking-changes/8/httplogging-addhttplogging-requirement.md
              - name: ISystemClock is obsolete
                href: breaking-changes/8/isystemclock-obsolete.md
              - name: "Minimal APIs: IFormFile parameters require anti-forgery checks"
                href: breaking-changes/8/antiforgery-checks.md
              - name: Rate-limiting middleware requires AddRateLimiter
                href: breaking-changes/8/addratelimiter-requirement.md
              - name: Security token events return a JsonWebToken
                href: breaking-changes/8/securitytoken-events.md
              - name: TrimMode defaults to full for Web SDK projects
                href: breaking-changes/8/trimmode-full.md
      - name: ASP.NET Core 7
        items:
          - name: What's new in 7
            uid: aspnetcore-7
          - name: Breaking changes
            items:
              - name: Overview
                href: breaking-changes/7/overview.md
              - name: API controller actions try to infer parameters from DI
                href: breaking-changes/7/api-controller-action-parameters-di.md
              - name: ASPNET-prefixed environment variable precedence
                href: breaking-changes/7/environment-variable-precedence.md
              - name: AuthenticateAsync for remote auth providers
                href: breaking-changes/7/authenticateasync-anonymous-request.md
              - name: Authentication in WebAssembly apps
                href: breaking-changes/7/wasm-app-authentication.md
              - name: Default authentication scheme
                href: breaking-changes/7/default-authentication-scheme.md
              - name: Event IDs for some Microsoft.AspNetCore.Mvc.Core log messages changed
                href: breaking-changes/7/microsoft-aspnetcore-mvc-core-log-event-ids.md
              - name: Fallback file endpoints
                href: breaking-changes/7/fallback-file-endpoints.md
              - name: IHubClients and IHubCallerClients hide members
                href: breaking-changes/7/ihubclients-ihubcallerclients.md
              - name: "Kestrel: Default HTTPS binding removed"
                href: breaking-changes/7/https-binding-kestrel.md
              - name: Microsoft.AspNetCore.Server.Kestrel.Transport.Libuv and libuv.dll removed
                href: breaking-changes/7/libuv-transport-dll-removed.md
              - name: Microsoft.Data.SqlClient updated to 4.0.1
                href: breaking-changes/7/microsoft-data-sqlclient-updated-to-4-0-1.md
              - name: Middleware no longer defers to endpoint with null request delegate
                href: breaking-changes/7/middleware-null-requestdelegate.md
              - name: MVC's detection of an empty body in model binding changed
                href: breaking-changes/7/mvc-empty-body-model-binding.md
              - name: Output caching API changes
                href: breaking-changes/7/output-caching-renames.md
              - name: SignalR Hub methods try to resolve parameters from DI
                href: breaking-changes/7/signalr-hub-method-parameters-di.md
      - name: ASP.NET Core 6
        items:
          - name: What's new in 6
            uid: aspnetcore-6.0
          - name: Breaking changes
            items:
              - name: Overview
                href: breaking-changes/6/overview.md
              - name: ActionResult<T> sets StatusCode to 200
                href: breaking-changes/6/actionresult-statuscode.md
              - name: AddDataAnnotationsValidation method made obsolete
                href: breaking-changes/6/adddataannotationsvalidation-obsolete.md
              - name: Assemblies removed from shared framework
                href: breaking-changes/6/assemblies-removed-from-shared-framework.md
              - name: "Blazor: Parameter name changed in RequestImageFileAsync method"
                href: breaking-changes/6/blazor-parameter-name-changed-in-method.md
              - name: "Blazor: WebEventDescriptor.EventArgsType property replaced"
                href: breaking-changes/6/blazor-eventargstype-property-replaced.md
              - name: "Blazor: Byte-array interop"
                href: breaking-changes/6/byte-array-interop.md
              - name: ClientCertificate doesn't trigger renegotiation
                href: breaking-changes/6/clientcertificate-doesnt-trigger-renegotiation.md
              - name: EndpointName metadata not set automatically
                href: breaking-changes/6/endpointname-metadata.md
              - name: "Identity: Default Bootstrap version of UI changed"
                href: breaking-changes/6/identity-bootstrap4-to-5.md
              - name: "Kestrel: Log message attributes changed"
                href: breaking-changes/6/kestrel-log-message-attributes-changed.md
              - name: "MessagePack: Library changed in @microsoft/signalr-protocol-msgpack"
                href: breaking-changes/6/messagepack-library-change.md
              - name: Microsoft.AspNetCore.Http.Features split
                href: breaking-changes/6/microsoft-aspnetcore-http-features-package-split.md
              - name: "Middleware: HTTPS Redirection Middleware throws exception on ambiguous HTTPS ports"
                href: breaking-changes/6/middleware-ambiguous-https-ports-exception.md
              - name: "Middleware: New Use overload"
                href: breaking-changes/6/middleware-new-use-overload.md
              - name: Minimal API renames in RC 1
                href: breaking-changes/6/rc1-minimal-api-renames.md
              - name: Minimal API renames in RC 2
                href: breaking-changes/6/rc2-minimal-api-renames.md
              - name: MVC doesn't buffer IAsyncEnumerable types
                href: breaking-changes/6/iasyncenumerable-not-buffered-by-mvc.md
              - name: Nullable reference type annotations changed
                href: breaking-changes/6/nullable-reference-type-annotations-changed.md
              - name: Obsoleted and removed APIs
                href: breaking-changes/6/obsolete-removed-apis.md
              - name: PreserveCompilationContext not configured by default
                href: breaking-changes/6/preservecompilationcontext-not-set-by-default.md
              - name: "Razor: Compiler generates single assembly"
                href: breaking-changes/6/razor-compiler-doesnt-produce-views-assembly.md
              - name: "Razor: Logging ID changes"
                href: breaking-changes/6/razor-pages-logging-ids.md
              - name: "Razor: RazorEngine APIs marked obsolete"
                href: breaking-changes/6/razor-engine-apis-obsolete.md
              - name: "SignalR: Java Client updated to RxJava3"
                href: breaking-changes/6/signalr-java-client-updated.md
              - name: TryParse and BindAsync methods are validated
                href: breaking-changes/6/tryparse-bindasync-validation.md
      - name: ASP.NET Core 5
        items:
          - name: What's new in 5
            uid: aspnetcore-5.0
          - name: Breaking changes
            items:
              - name: Overview
                href: breaking-changes/5/overview.md
              - name: ASP.NET Core apps deserialize quoted numbers
                href: /dotnet/core/compatility/serialization/5.0/jsonserializer-allows-reading-numbers-as-strings
              - name: AzureAD.UI and AzureADB2C.UI APIs obsolete
                href: breaking-changes/5/authentication-aad-packages-obsolete.md
              - name: BinaryFormatter serialization methods are obsolete
                href: /dotnet/core/compatility/serialization/5.0/binaryformatter-serialization-obsolete
              - name: Resource in endpoint routing is HttpContext
                href: breaking-changes/5/authorization-resource-in-endpoint-routing.md
              - name: Microsoft-prefixed Azure integration packages removed
                href: breaking-changes/5/azure-integration-packages-removed.md
              - name: "Blazor: Route precedence logic changed in Blazor apps"
                href: breaking-changes/5/blazor-routing-logic-changed.md
              - name: "Blazor: Updated browser support"
                href: breaking-changes/5/blazor-browser-support-updated.md
              - name: "Blazor: Insignificant whitespace trimmed by compiler"
                href: breaking-changes/5/blazor-components-trim-insignificant-whitespace.md
              - name: "Blazor: JSObjectReference and JSInProcessObjectReference types are internal"
                href: breaking-changes/5/blazor-jsobjectreference-to-internal.md
              - name: "Blazor: Target framework of NuGet packages changed"
                href: breaking-changes/5/blazor-packages-target-framework-changed.md
              - name: "Blazor: ProtectedBrowserStorage feature moved to shared framework"
                href: breaking-changes/5/blazor-protectedbrowserstorage-moved.md
              - name: "Blazor: RenderTreeFrame readonly public fields are now properties"
                href: breaking-changes/5/blazor-rendertreeframe-fields-become-properties.md
              - name: "Blazor: Updated validation logic for static web assets"
                href: breaking-changes/5/blazor-static-web-assets-validation-logic-updated.md
              - name: Cryptography APIs not supported on browser
                href: /dotnet/core/compatility/cryptography/5.0/cryptography-apis-not-supported-on-blazor-webassembly
              - name: "Extensions: Package reference changes"
                href: breaking-changes/5/extensions-package-reference-changes.md
              - name: Kestrel and IIS BadHttpRequestException types are obsolete
                href: breaking-changes/5/http-badhttprequestexception-obsolete.md
              - name: HttpClient instances created by IHttpClientFactory log integer status codes
                href: breaking-changes/5/http-httpclient-instances-log-integer-status-codes.md
              - name: "HttpSys: Client certificate renegotiation disabled by default"
                href: breaking-changes/5/httpsys-client-certificate-renegotiation-disabled-by-default.md
              - name: "IIS: UrlRewrite middleware query strings are preserved"
                href: breaking-changes/5/iis-urlrewrite-middleware-query-strings-are-preserved.md
              - name: "Kestrel: Configuration changes detected by default"
                href: breaking-changes/5/kestrel-configuration-changes-at-run-time-detected-by-default.md
              - name: "Kestrel: Default supported TLS protocol versions changed"
                href: breaking-changes/5/kestrel-default-supported-tls-protocol-versions-changed.md
              - name: "Kestrel: HTTP/2 disabled over TLS on incompatible Windows versions"
                href: breaking-changes/5/kestrel-disables-http2-over-tls.md
              - name: "Kestrel: Libuv transport marked as obsolete"
                href: breaking-changes/5/kestrel-libuv-transport-obsolete.md
              - name: Obsolete properties on ConsoleLoggerOptions
                href: /dotnet/core/compatility/core-libraries/5.0/obsolete-consoleloggeroptions-properties
              - name: ResourceManagerWithCultureStringLocalizer class and WithCulture interface member removed
                href: breaking-changes/5/localization-members-removed.md
              - name: Pubternal APIs removed
                href: breaking-changes/5/localization-pubternal-apis-removed.md
              - name: Obsolete constructor removed in request localization middleware
                href: breaking-changes/5/localization-requestlocalizationmiddleware-constructor-removed.md
              - name: "Middleware: Database error page marked as obsolete"
                href: breaking-changes/5/middleware-database-error-page-obsolete.md
              - name: Exception handler middleware throws original exception
                href: breaking-changes/5/middleware-exception-handler-throws-original-exception.md
              - name: ObjectModelValidator calls a new overload of Validate
                href: breaking-changes/5/mvc-objectmodelvalidator-calls-new-overload.md
              - name: Cookie name encoding removed
                href: breaking-changes/5/security-cookie-name-encoding-removed.md
              - name: IdentityModel NuGet package versions updated
                href: breaking-changes/5/security-identitymodel-nuget-package-versions-updated.md
              - name: "SignalR: MessagePack Hub Protocol options type changed"
                href: breaking-changes/5/signalr-messagepack-hub-protocol-options-changed.md
              - name: "SignalR: MessagePack Hub Protocol moved"
                href: breaking-changes/5/signalr-messagepack-package.md
              - name: UseSignalR and UseConnections methods removed
                href: breaking-changes/5/signalr-usesignalr-useconnections-removed.md
              - name: CSV content type changed to standards-compliant
                href: breaking-changes/5/static-files-csv-content-type-changed.md
      - name: What's new in 3.1
        uid: aspnetcore-3.1
      - name: What's new in 3.0
        uid: aspnetcore-3.0
      - name: What's new in 2.2
        uid: aspnetcore-2.2
      - name: What's new in 2.1
        uid: aspnetcore-2.1
      - name: What's new in 2.0
        uid: aspnetcore-2.0
      - name: What's new in 1.1
        uid: aspnetcore-1.1
  - name: Tutorials
    displayName: tutorial
    items:
      - name: Web apps
        items:
          - name: Choose an ASP.NET Core UI
            uid: tutorials/choose-web-ui
          - name: Razor Pages
            displayName: tutorial
            items:
              - name: Overview
                uid: tutorials/razor-pages/index
              - name: Get started
                uid: tutorials/razor-pages/razor-pages-start
              - name: Add a model
                uid: tutorials/razor-pages/model
              - name: Scaffolding
                uid: tutorials/razor-pages/page
              - name: Work with a database
                uid: tutorials/razor-pages/sql
              - name: Update the pages
                uid: tutorials/razor-pages/da1
              - name: Add search
                uid: tutorials/razor-pages/search
              - name: Add a new field
                uid: tutorials/razor-pages/new-field
              - name: Add validation
                uid: tutorials/razor-pages/validation
          - name: MVC
            displayName: tutorial
            items:
              - name: Get started
                uid: tutorials/first-mvc-app/start-mvc
              - name: Add a controller
                uid: tutorials/first-mvc-app/adding-controller
              - name: Add a view
                uid: tutorials/first-mvc-app/adding-view
              - name: Add a model
                uid: tutorials/first-mvc-app/adding-model
              - name: Work with a database
                uid: tutorials/first-mvc-app/working-with-sql
              - name: Controller actions and views
                uid: tutorials/first-mvc-app/controller-methods-views
              - name: Add search
                uid: tutorials/first-mvc-app/search
              - name: Add a new field
                uid: tutorials/first-mvc-app/new-field
              - name: Add validation
                uid: tutorials/first-mvc-app/validation
              - name: Examine Details and Delete
                uid: tutorials/first-mvc-app/details
          - name: Blazor
            uid: blazor/tutorials/index
      - name: APIs
        items:
        - name: Minimal APIs
          items:
          - name: Create a minimal web API
            displayName: API tutorial
            uid: tutorials/min-web-api
        - name: Controller-based APIs
          items:
          - name: Create a controller-based web API
            displayName: API tutorial
            uid: tutorials/first-web-api
          - name: Web API with MongoDB
            displayName: API tutorial
            uid: tutorials/first-mongo-app
          - name: Web API with JavaScript
            displayName: tutorial
            uid: tutorials/web-api-javascript
          - name: Backend for mobile
            displayName: tutorial
            uid: mobile/native-mobile-backend
          - name: Publish to Azure API Management
            displayName: tutorial
            uid: tutorials/publish-to-azure-api-management-using-vs
      - name: Real-time web apps
        items:
          - name: SignalR with JavaScript
            displayName: tutorial
            uid: tutorials/signalr
          - name: SignalR with TypeScript
            displayName: tutorial
            uid: tutorials/signalr-typescript-webpack
          - name: SignalR with Blazor
            displayName: tutorial
            uid: blazor/tutorials/signalr-blazor
      - name: Remote Procedure Call apps
        items:
          - name: Get started with a gRPC service
            uid: tutorials/grpc/grpc-start
      - name: Data access
        items:
          - name: EF Core with Razor Pages
            displayName: tutorial
            items:
              - name: Get started
                uid: data/ef-rp/intro
              - name: Create, Read, Update, and Delete
                uid: data/ef-rp/crud
              - name: Sort, filter, page, and group
                uid: data/ef-rp/sort-filter-page
              - name: Migrations
                uid: data/ef-rp/migrations
              - name: Create a complex data model
                uid: data/ef-rp/complex-data-model
              - name: Read related data
                uid: data/ef-rp/read-related-data
              - name: Update related data
                uid: data/ef-rp/update-related-data
              - name: Handle concurrency conflicts
                uid: data/ef-rp/concurrency
          - name: EF Core with MVC
            displayName: tutorial
            items:
              - name: Overview
                uid: data/ef-mvc/index
              - name: Get started
                uid: data/ef-mvc/intro
              - name: Create, Read, Update, and Delete
                uid: data/ef-mvc/crud
              - name: Sort, filter, page, and group
                uid: data/ef-mvc/sort-filter-page
              - name: Migrations
                uid: data/ef-mvc/migrations
              - name: Create a complex data model
                uid: data/ef-mvc/complex-data-model
              - name: Read related data
                uid: data/ef-mvc/read-related-data
              - name: Update related data
                uid: data/ef-mvc/update-related-data
              - name: Handle concurrency conflicts
                uid: data/ef-mvc/concurrency
              - name: Inheritance
                uid: data/ef-mvc/inheritance
              - name: Advanced topics
                uid: data/ef-mvc/advanced
      - name: Learn modules
        items:
          - name: Web apps >>
            displayName: tutorial, razor, razor pages, ui
            href: /training/modules/create-razor-pages-aspnet-core/
          - name: Cloud-native microservices
            items:
              - name: Create and deploy >>
                displayName: tutorial, kubernetes, aks, acr, docker
                href: /training/modules/microservices-aspnet-core/
              - name: Implement resiliency >>
                displayName: tutorial, kubernetes, aks, acr, docker
                href: /training/modules/microservices-resiliency-aspnet-core/
              - name: Deploy with GitHub Actions >>
                displayName: tutorial, kubernetes, aks, acr, docker, devops
                href: /training/modules/microservices-devops-aspnet-core/
              - name: Log and monitor >>
                displayName: tutorial, kubernetes, aks, acr, docker, serilog
                href: /training/modules/microservices-logging-aspnet-core/
              - name: Implement feature flags >>
                displayName: tutorial, kubernetes, aks, acr, docker
                href: /training/modules/microservices-configuration-aspnet-core/
              - name: Use managed data stores >>
                displayName: tutorial, kubernetes, aks, acr, docker
                href: /training/modules/microservices-data-aspnet-core/
              - name: Implement API gateways >>
                displayName: tutorial, kubernetes, aks, acr, docker
                href: /training/modules/microservices-apigateway-aspnet-core/
          - name: Data access >>
            displayName: tutorial, ef, entity framework
            href: /training/modules/persist-data-ef-core/
  - name: Fundamentals
    items:
      - name: Overview
        uid: fundamentals/index
      - name: App start up
        uid: fundamentals/startup
      - name: Dependency injection (services)
        uid: fundamentals/dependency-injection
      - name: Native AOT
        items:
          - name: Overview
            displayName: native, aot
            uid: fundamentals/native-aot
          - name: Tutorial
            displayName: native, aot
            uid: fundamentals/native-aot-tutorial
          - name: Request Delegate Generator
            displayName: aot, RDG, Request Delegate Generator
            uid: fundamentals/aot/rdg
      - name: Middleware
        items:
          - name: Middleware overview
            uid: fundamentals/middleware/index
          - name: Rate limiting middleware
            uid: performance/rate-limit
          - name: Rate limiting samples
            uid: performance/rate-limit-sample
          - name: Middleware in Minimal API apps
            uid: fundamentals/minimal-apis/middleware
          - name: Test middleware
            uid: test/middleware
          - name: Response caching middleware
            uid: performance/caching/middleware
          - name: Write middleware
            uid: fundamentals/middleware/write
          - name: Request and response operations
            displayName: middleware
            uid: fundamentals/middleware/request-response
          - name: Request decompression
            displayName: request decompression middleware
            uid: fundamentals/middleware/request-decompression
          - name: Factory-based middleware
            uid: fundamentals/middleware/extensibility
          - name: Factory-based middleware with third-party container
            uid: fundamentals/middleware/extensibility-third-party-container
      - name: Host
        items:
          - name: WebApplication and WebApplicationBuilder
            uid: fundamentals/minimal-apis/webapplication
          - name: Generic Host
            uid: fundamentals/host/generic-host
          - name: Web Host
            uid: fundamentals/host/web-host
      - name: Configuration
        uid: fundamentals/configuration/index
      - name: Options
        uid: fundamentals/configuration/options
      - name: Environments (dev, stage, prod)
        uid: fundamentals/environments
      - name: Logging and monitoring
        items:
          - name: Logging
            uid: fundamentals/logging/index
          - name: HTTP logging
            uid: fundamentals/http-logging/index
          - name: Enrich HTTP request logs in ASP.NET Core
            uid: fundamentals/http-logging/http-log-enricher
          - name: W3C logger
            uid: fundamentals/w3c-logger/index
          - name: Health checks
            displayName: logging, monitoring
            uid: host-and-deploy/health-checks
          - name: Metrics overview
            displayName: logging, monitoring
            uid: log-mon/metrics/metrics
          - name: Built-in metrics
            uid: log-mon/metrics/built-in
      - name: HttpContext
        uid: fundamentals/use-httpcontext
      - name: Routing
        uid: fundamentals/routing
      - name: Handle errors
        uid: fundamentals/error-handling
      - name: Make HTTP requests
        displayName: httpclient, httpclientfactory
        uid: fundamentals/http-requests
      - name: Static files
        uid: fundamentals/static-files
      - name: dotnet-scaffold telemetry
        uid: fundamentals/dotnet-scaffold-telemetry
  - name: Web apps
    items:
      - name: Choose an ASP.NET Core UI
        uid: tutorials/choose-web-ui
      - name: Razor Pages
        items:
          - name: Architecture and concepts
            uid: razor-pages/index
          - name: Tutorial
            items:
              - name: Overview
                uid: tutorials/razor-pages/index
              - name: Get started
                uid: tutorials/razor-pages/razor-pages-start
              - name: Add a model
                uid: tutorials/razor-pages/model
              - name: Scaffolding
                uid: tutorials/razor-pages/page
              - name: Work with a database
                uid: tutorials/razor-pages/sql
              - name: Update the pages
                uid: tutorials/razor-pages/da1
              - name: Add search
                uid: tutorials/razor-pages/search
              - name: Add a new field
                uid: tutorials/razor-pages/new-field
              - name: Add validation
                uid: tutorials/razor-pages/validation
          - name: Filters
            uid: razor-pages/filter
          - name: Route and app conventions
            uid: razor-pages/razor-pages-conventions
          - name: Security and Identity
            items:
              - name: Authorization
                items:
                  - name: Simple authorization
                    uid: razor-pages/security/authorization/simple
                  - name: Authorization conventions
                    uid: razor-pages/security/authorization/conventions
                  - name: Role-based authorization
                    uid: razor-pages/security/authorization/roles
      - name: MVC
        items:
          - name: Overview
            uid: mvc/overview
          - name: Tutorial
            items:
              - name: Get started
                uid: tutorials/first-mvc-app/start-mvc
              - name: Add a controller
                uid: tutorials/first-mvc-app/adding-controller
              - name: Add a view
                uid: tutorials/first-mvc-app/adding-view
              - name: Add a model
                uid: tutorials/first-mvc-app/adding-model
              - name: Work with a database
                uid: tutorials/first-mvc-app/working-with-sql
              - name: Controller actions and views
                uid: tutorials/first-mvc-app/controller-methods-views
              - name: Add search
                uid: tutorials/first-mvc-app/search
              - name: Add a new field
                uid: tutorials/first-mvc-app/new-field
              - name: Add validation
                uid: tutorials/first-mvc-app/validation
              - name: Examine the Details and Delete methods
                uid: tutorials/first-mvc-app/details
          - name: Views
            uid: mvc/views/overview
          - name: Partial views
            uid: mvc/views/partial
          - name: Controllers
            uid: mvc/controllers/actions
          - name: Routing
            uid: mvc/controllers/routing
          - name: Dependency injection - controllers
            uid: mvc/controllers/dependency-injection
          - name: Dependency injection - views
            uid: mvc/views/dependency-injection
          - name: Unit test
            uid: mvc/controllers/testing
          - name: Security and Identity
            items:
              - name: Authorization
                items:
                  - name: Simple authorization
                    uid: mvc/security/authorization/simple
                  - name: Custom authorization with IAuthorizationRequirementData
                    uid: mvc/security/authorization/iard
                  - name: Role-based authorization
                    uid: mvc/security/authorization/roles
      - name: Blazor
        items:
          - name: Overview
            uid: blazor/index
          - name: Supported platforms
            uid: blazor/supported-platforms
          - name: Tooling
            uid: blazor/tooling
          - name: WebAssembly tooling and AOT
            uid: blazor/tooling/webassembly
          - name: Hosting models
            uid: blazor/hosting-models
          - name: Tutorials
            items:
              - name: Overview
                uid: blazor/tutorials/index
              - name: Build your first Blazor app
                href: https://dotnet.microsoft.com/learn/aspnet/blazor-tutorial/intro
              - name: Build a Blazor todo list app
                uid: blazor/tutorials/build-a-blazor-app
              - name: Build a Blazor movie database app
                items:
                  - name: Overview
                    uid: blazor/tutorials/movie-database-app/index
                  - name: Create a Blazor Web App
                    uid: blazor/tutorials/movie-database-app/part-1
                  - name: Add and scaffold a model
                    uid: blazor/tutorials/movie-database-app/part-2
                  - name: Learn about Razor components
                    uid: blazor/tutorials/movie-database-app/part-3
                  - name: Work with a database
                    uid: blazor/tutorials/movie-database-app/part-4
                  - name: Add validation
                    uid: blazor/tutorials/movie-database-app/part-5
                  - name: Add search
                    uid: blazor/tutorials/movie-database-app/part-6
                  - name: Add a new field
                    uid: blazor/tutorials/movie-database-app/part-7
                  - name: Add interactivity
                    uid: blazor/tutorials/movie-database-app/part-8
              - name: SignalR with Blazor
                uid: blazor/tutorials/signalr-blazor
              - name: Learn modules
                href: /training/paths/build-web-apps-with-blazor/
          - name: Blazor Hybrid
            items:
              - name: Overview
                uid: blazor/hybrid/index
              - name: Tutorials
                items:
                  - name: Overview
                    uid: blazor/hybrid/tutorials/index
                  - name: .NET MAUI
                    uid: blazor/hybrid/tutorials/maui
                  - name: .NET MAUI with Blazor Web App
                    uid: blazor/hybrid/tutorials/maui-blazor-web-app
                  - name: Windows Forms
                    uid: blazor/hybrid/tutorials/windows-forms
                  - name: WPF
                    uid: blazor/hybrid/tutorials/wpf
              - name: Routing and navigation
                uid: blazor/hybrid/routing
              - name: Static files
                uid: blazor/hybrid/static-files
              - name: Browser developer tools
                uid: blazor/hybrid/developer-tools
              - name: Reuse Razor components
                uid: blazor/hybrid/reuse-razor-components
              - name: Class libraries
                uid: blazor/hybrid/class-libraries
              - name: Class libraries best practices
                uid: blazor/hybrid/class-libraries-best-practices
              - name: Root component parameters
                uid: blazor/hybrid/root-component-parameters
              - name: Security and Identity
                items:
                  - name: Overview
                    uid: blazor/hybrid/security/index
                  - name: Security considerations
                    uid: blazor/hybrid/security/security-considerations
                  - name: .NET MAUI with Blazor Web App and Identity sample
                    uid: blazor/hybrid/security/maui-blazor-web-identity
              - name: Publish
                uid: blazor/hybrid/publish/index
              - name: Troubleshoot
                uid: blazor/hybrid/troubleshoot
          - name: Project structure
            uid: blazor/project-structure
          - name: Fundamentals
            items:
              - name: Overview
                uid: blazor/fundamentals/index
              - name: Routing
                uid: blazor/fundamentals/routing
              - name: Navigation
                uid: blazor/fundamentals/navigation
              - name: Configuration
                uid: blazor/fundamentals/configuration
              - name: Dependency injection
                uid: blazor/fundamentals/dependency-injection
              - name: Startup
                uid: blazor/fundamentals/startup
              - name: Environments
                uid: blazor/fundamentals/environments
              - name: Logging
                uid: blazor/fundamentals/logging
              - name: Handle errors
                uid: blazor/fundamentals/handle-errors
              - name: SignalR
                uid: blazor/fundamentals/signalr
              - name: Static files
                uid: blazor/fundamentals/static-files
          - name: Components
            items:
              - name: Overview
                uid: blazor/components/index
              - name: Render modes
                uid: blazor/components/render-modes
              - name: Prerender components
                uid: blazor/components/prerender
              - name: IHttpContextAccessor and HttpContext
                uid: blazor/components/httpcontext
              - name: Generic type support
                uid: blazor/components/generic-type-support
              - name: Synchronization context
                uid: blazor/components/sync-context
              - name: Preserve relationships with @key
                uid: blazor/components/key
              - name: Overwriting parameters
                uid: blazor/components/overwriting-parameters
              - name: Attribute splatting and arbitrary parameters
                uid: blazor/components/attribute-splatting
              - name: Layouts
                uid: blazor/components/layouts
              - name: Sections
                uid: blazor/components/sections
              - name: Control <head> content
                uid: blazor/components/control-head-content
              - name: Cascading values and parameters
                uid: blazor/components/cascading-values-and-parameters
              - name: Event handling
                uid: blazor/components/event-handling
              - name: Data binding
                uid: blazor/components/data-binding
              - name: Lifecycle
                uid: blazor/components/lifecycle
              - name: Component disposal
                uid: blazor/components/component-disposal
              - name: Virtualization
                uid: blazor/components/virtualization
              - name: Rendering
                uid: blazor/components/rendering
              - name: Templated components
                uid: blazor/components/templated-components
              - name: CSS isolation
                uid: blazor/components/css-isolation
              - name: Dynamically-rendered components
                uid: blazor/components/dynamiccomponent
              - name: QuickGrid component
                uid: blazor/components/quickgrid
              - name: Integrate with MVC/Razor Pages
                uid: blazor/components/integration
              - name: Integrate with MVC/Razor Pages (hosted WebAssembly)
                uid: blazor/components/integration-hosted-webassembly
              - name: Class libraries
                uid: blazor/components/class-libraries
              - name: Class libraries with static SSR
                uid: blazor/components/class-libraries-with-static-ssr
              - name: JavaScript apps and SPA frameworks
                uid: blazor/components/js-spa-frameworks
              - name: Components outside of ASP.NET Core
                uid: blazor/components/render-outside-of-aspnetcore
              - name: Built-in components
                uid: blazor/components/built-in-components
          - name: Globalization and localization
            uid: blazor/globalization-localization
          - name: Forms
            items:
              - name: Overview
                uid: blazor/forms/index
              - name: Input components
                uid: blazor/forms/input-components
              - name: Binding
                uid: blazor/forms/binding
              - name: Validation
                uid: blazor/forms/validation
              - name: Troubleshoot
                uid: blazor/forms/troubleshoot
          - name: File uploads
            uid: blazor/file-uploads
          - name: File downloads
            uid: blazor/file-downloads
          - name: JavaScript interop
            items:
              - name: Overview
                uid: blazor/js-interop/index
              - name: JavaScript location
                uid: blazor/js-interop/javascript-location
              - name: Call JS from .NET
                uid: blazor/js-interop/call-javascript-from-dotnet
              - name: Call .NET from JS
                uid: blazor/js-interop/call-dotnet-from-javascript
              - name: JSImport/JSExport interop
                uid: blazor/js-interop/import-export-interop
              - name: Static server rendering
                uid: blazor/js-interop/ssr
          - name: Call a web API
            uid: blazor/call-web-api
          - name: Images and documents
            uid: blazor/images-and-documents
          - name: Security and Identity
            items:
              - name: Overview
                uid: blazor/security/index
              - name: Authentication state
                uid: blazor/security/authentication-state
              - name: Blazor WebAssembly
                items:
                  - name: Overview
                    uid: blazor/security/webassembly/index
                  - name: Standalone with Identity
                    items:
                      - name: Overview
                        uid: blazor/security/webassembly/standalone-with-identity/index
                      - name: Account confirmation and password recovery
                        uid: blazor/security/webassembly/standalone-with-identity/account-confirmation-and-password-recovery
                      - name: QR codes with TOTP
                        uid: blazor/security/webassembly/standalone-with-identity/qrcodes-for-authenticator-apps
                  - name: Standalone with Authentication library
                    uid: blazor/security/webassembly/standalone-with-authentication-library
                  - name: Standalone with Microsoft Accounts
                    uid: blazor/security/webassembly/standalone-with-microsoft-accounts
                  - name: Standalone with ME-ID
                    uid: blazor/security/webassembly/standalone-with-microsoft-entra-id
                  - name: Standalone with AAD B2C
                    uid: blazor/security/webassembly/standalone-with-azure-active-directory-b2c
                  - name: Hosted with ME-ID
                    uid: blazor/security/webassembly/hosted-with-microsoft-entra-id
                  - name: Hosted with AAD B2C
                    uid: blazor/security/webassembly/hosted-with-azure-active-directory-b2c
                  - name: Hosted with Identity Server
                    uid: blazor/security/webassembly/hosted-with-identity-server
                  - name: Additional scenarios
                    uid: blazor/security/webassembly/additional-scenarios
                  - name: ME-ID groups and roles
                    uid: blazor/security/webassembly/meid-groups-roles
                  - name: ME-ID groups and roles
                    uid: blazor/security/webassembly/meid-groups-roles-net5to7
                  - name: Graph API
                    uid: blazor/security/webassembly/graph-api
              - name: Blazor Web App with Entra
                uid: blazor/security/blazor-web-app-entra
              - name: Blazor Web App with OIDC
                uid: blazor/security/blazor-web-app-oidc
              - name: Blazor Web App with Windows Auth
                uid: blazor/security/blazor-web-app-windows-authentication
              - name: Static server-side rendering threats
                uid: blazor/security/static-server-side-rendering
              - name: Interactive server-side rendering threats
                uid: blazor/security/interactive-server-side-rendering
              - name: Account confirmation and password recovery
                uid: blazor/security/account-confirmation-and-password-recovery
              - name: QR codes with TOTP
                uid: blazor/security/qrcodes-for-authenticator-apps
              - name: Content Security Policy
                uid: blazor/security/content-security-policy
              - name: EU General Data Protection Regulation (GDPR) support
                uid: blazor/security/gdpr
              - name: Server-side and Blazor Web App additional scenarios
                uid: blazor/security/additional-scenarios
          - name: State management
            items:
              - name: Overview
                uid: blazor/state-management/index
              - name: Prerendered state persistence
                uid: blazor/state-management/prerendered-state-persistence
              - name: Server
                uid: blazor/state-management/server
              - name: WebAssembly
                uid: blazor/state-management/webassembly
              - name: Protected browser storage
                uid: blazor/state-management/protected-browser-storage
          - name: Debug
            uid: blazor/debug
          - name: Lazy load assemblies with WebAssembly
            uid: blazor/webassembly-lazy-load-assemblies
          - name: WebAssembly native dependencies
            uid: blazor/webassembly-native-dependencies
          - name: Blazor with .NET on Web Workers
            uid: blazor/blazor-web-workers
          - name: Performance
            items:
              - name: Overview
                uid: blazor/performance/index
              - name: Rendering speed
                uid: blazor/performance/rendering
              - name: App download size
                uid: blazor/performance/app-download-size
              - name: JavaScript interop
                uid: blazor/performance/js-interop
              - name: WebAssembly runtime performance
                uid: blazor/performance/webassembly-runtime-performance
              - name: WebAssembly browser developer tools diagnostics
                uid: blazor/performance/webassembly-browser-developer-tools
              - name: WebAssembly Event Pipe diagnostics
                uid: blazor/performance/webassembly-event-pipe
          - name: Test components
            uid: blazor/test
          - name: Progressive Web Applications
            items:
              - name: Overview
                uid: blazor/progressive-web-app/index
              - name: Push notifications
                uid: blazor/progressive-web-app/push-notifications
          - name: Host and deploy
            items:
              - name: Overview
                uid: blazor/host-and-deploy/index
              - name: App base path
                uid: blazor/host-and-deploy/app-base-path
              - name: Server
                items:
                  - name: Overview
                    uid: blazor/host-and-deploy/server/index
                  - name: Memory management
                    uid: blazor/host-and-deploy/server/memory-management
              - name: Blazor WebAssembly
                items:
                  - name: Overview
                    uid: blazor/host-and-deploy/webassembly/index
                  - name: Deploy to IIS
                    uid: blazor/host-and-deploy/webassembly/iis
                  - name: Deploy to Azure Static Web Apps
                    uid: blazor/host-and-deploy/webassembly/azure-static-web-apps
                  - name: Deploy to Azure Storage
                    uid: blazor/host-and-deploy/webassembly/azure-storage
                  - name: Deploy to Nginx
                    uid: blazor/host-and-deploy/webassembly/nginx
                  - name: Deploy to Apache
                    uid: blazor/host-and-deploy/webassembly/apache
                  - name: Deploy to GitHub Pages
                    uid: blazor/host-and-deploy/webassembly/github-pages
                  - name: Bundle caching and integrity check failures
                    uid: blazor/host-and-deploy/webassembly/bundle-caching-and-integrity-check-failures
                  - name: HTTP caching issues
                    uid: blazor/host-and-deploy/webassembly/http-caching-issues
                  - name: Multiple hosted WebAssembly apps
                    uid: blazor/host-and-deploy/webassembly/multiple-hosted-webassembly
                  - name: Deployment layout
                    uid: blazor/host-and-deploy/webassembly/deployment-layout
              - name: Configure the Linker
                uid: blazor/host-and-deploy/configure-linker
              - name: Configure the Trimmer
                uid: blazor/host-and-deploy/configure-trimmer
          - name: Blazor with EF Core
            uid: blazor/blazor-ef-core
          - name: Advanced scenarios
            uid: blazor/advanced-scenarios
      - name: Client-side development
        items:
          - name: Single Page Apps
            items:
              - name: Angular with Visual Studio >>
                href: /visualstudio/javascript/tutorial-asp-net-core-with-angular
              - name: React with Visual Studio >>
                href: /visualstudio/javascript/tutorial-asp-net-core-with-react
              - name: Vue with Visual Studio >>
                href: /visualstudio/javascript/tutorial-asp-net-core-with-vue
              - name: JavaScript and TypeScript in Visual Studio >>
                href: /visualstudio/javascript/javascript-in-visual-studio
              - name: Overview of SPAs
                uid: spa/intro
              - name: Angular
                uid: spa/angular
              - name: React
                uid: spa/react
              - name: JavaScript Services
                uid: client-side/spa-services
          - name: LibMan
            items:
              - name: Overview
                uid: client-side/libman/index
              - name: CLI
                uid: client-side/libman/libman-cli
              - name: Visual Studio
                uid: client-side/libman/libman-vs
          - name: WebAssembly JS interop
            items:
              - name: Overview
                uid: client-side/dotnet-interop/index
              - name: JS interop (WebAssembly Browser App)
                uid: client-side/dotnet-interop/wasm-browser-app
          - name: .NET on Web Workers
            uid: client-side/dotnet-on-webworkers
          - name: Grunt
            uid: client-side/using-grunt
          - name: Bundle and minify
            uid: client-side/bundling-and-minification
          - name: Browser Link
            uid: client-side/using-browserlink
      - name: Session and state management
        uid: fundamentals/app-state
      - name: Layout
        uid: mvc/views/layout
      - name: Razor syntax
        uid: mvc/views/razor
      - name: Razor class libraries
        uid: razor-pages/ui-class
      - name: Tag Helpers
        uid: mvc/views/tag-helpers/builtin-th/Index
        items:
          - name: Overview
            uid: mvc/views/tag-helpers/intro
          - name: Create Tag Helpers
            uid: mvc/views/tag-helpers/authoring
          - name: Use Tag Helpers in forms
            uid: mvc/views/working-with-forms
          - name: Tag Helper Components
            uid: mvc/views/tag-helpers/th-components
          - name: Built-in Tag Helpers
            items:
              - name: Anchor
                uid: mvc/views/tag-helpers/builtin-th/anchor-tag-helper
              - name: Cache
                uid: mvc/views/tag-helpers/builtin-th/cache-tag-helper
              - name: Component
                uid: mvc/views/tag-helpers/builtin-th/component-tag-helper
              - name: Distributed Cache
                uid: mvc/views/tag-helpers/builtin-th/distributed-cache-tag-helper
              - name: Environment
                uid: mvc/views/tag-helpers/builtin-th/environment-tag-helper
              - name: Form
                href: mvc/views/working-with-forms.md#the-form-tag-helper
              - name: Form Action
                href: mvc/views/working-with-forms.md#the-form-action-tag-helper
              - name: Image
                uid: mvc/views/tag-helpers/builtin-th/image-tag-helper
              - name: Input
                href: mvc/views/working-with-forms.md#the-input-tag-helper
              - name: Label
                href: mvc/views/working-with-forms.md#the-label-tag-helper
              - name: Link
                uid: mvc/views/tag-helpers/builtin-th/link-tag-helper
              - name: Partial
                uid: mvc/views/tag-helpers/builtin-th/partial-tag-helper
              - name: Persist Component State
                uid: mvc/views/tag-helpers/builtin-th/persist-component-state-tag-helper
              - name: Script
                uid: mvc/views/tag-helpers/builtin-th/script-tag-helper
              - name: Select
                href: mvc/views/working-with-forms.md#the-select-tag-helper
              - name: Textarea
                href: mvc/views/working-with-forms.md#the-textarea-tag-helper
              - name: Validation Message
                href: mvc/views/working-with-forms.md#the-validation-message-tag-helper
              - name: Validation Summary
                href: mvc/views/working-with-forms.md#the-validation-summary-tag-helper
      - name: Advanced
        items:
          - name: Application parts
            uid: mvc/extensibility/app-parts
          - name: Application model
            uid: mvc/controllers/application-model
          - name: Areas
            uid: mvc/controllers/areas
          - name: Filters
            uid: mvc/controllers/filters
          - name: Razor SDK
            uid: razor-pages/sdk
          - name: Razor breaking changes since .NET 8
            href: ../_razor/docs/Compiler%20Breaking%20Changes%20-%20DotNet%208.md
          - name: Razor breaking changes since .NET 9
            href: ../_razor/docs/Compiler%20Breaking%20Changes%20-%20DotNet%209.md
          - name: View components
            uid: mvc/views/view-components
          - name: View compilation
            uid: mvc/views/view-compilation
          - name: Display and Editor Templates
            uid: mvc/views/display-templates
          - name: Upload files
            uid: mvc/models/file-uploads
          - name: Web SDK
            uid: razor-pages/web-sdk
          - name: Code generator tool (scaffolding)
            displayName: aspnet-codegenerator
            uid: fundamentals/tools/dotnet-aspnet-codegenerator
  - name: APIs
    items:
      - name: Overview
        uid: fundamentals/apis
      - name: "Tutorial: Create a Minimal API"
        uid: tutorials/min-web-api
      - name: Minimal APIs quick reference
        uid: fundamentals/minimal-apis
      - name: WebApplication and WebApplicationBuilder
        uid: fundamentals/minimal-apis/webapplication
      - name: Route Handlers
        uid: fundamentals/minimal-apis/route-handlers
      - name: Parameter binding
        uid: fundamentals/minimal-apis/parameter-binding
      - name: Create responses
        uid: fundamentals/minimal-apis/responses
      - name: Filters
        uid: fundamentals/minimal-apis/min-api-filters
      - name: Unit and integration tests
        uid: fundamentals/minimal-apis/test-min-api
      - name: Middleware
        uid: fundamentals/minimal-apis/middleware
      - name: Handle errors
        uid: fundamentals/error-handling-api
      - name: Authentication and authorization
        uid: fundamentals/minimal-apis/security
      - name: OpenAPI
        items:
          - name: Overview
            uid: fundamentals/openapi/overview
          - name: Generate OpenAPI documents
            uid: fundamentals/openapi/aspnetcore-openapi
          - name: Include OpenAPI metadata
            uid: fundamentals/openapi/include-metadata
          - name: XML doc comment support
            uid: fundamentals/openapi/aspnet-openapi-xml
          - name: Customize OpenAPI documents
            uid: fundamentals/openapi/customize-openapi
          - name: Use OpenAPI documents
            uid: fundamentals/openapi/using-openapi-documents
          - name: OpenAPI tools
            uid: fundamentals/openapi/openapi-tools
          - name: Swagger / NSwag
            items:
              - name: Overview
                uid: tutorials/web-api-help-pages-using-swagger
              - name: Get started with Swashbuckle
                uid: tutorials/get-started-with-swashbuckle
              - name: Get started with NSwag
                uid: tutorials/get-started-with-nswag
      - name: Controller-based APIs
        items:
        - name: Overview
          uid: web-api/index
        - name: Tutorials
          items:
            - name: Create a web API with controllers
              uid: tutorials/first-web-api
            - name: Web API with MongoDB
              uid: tutorials/first-mongo-app
        - name: Action return types
          uid: web-api/action-return-types
        - name: Handle JSON Patch requests
          uid: web-api/jsonpatch
        - name: Format response data
          uid: web-api/advanced/formatting
        - name: Custom formatters
          uid: web-api/advanced/custom-formatters
        - name: Analyzers
          uid: web-api/advanced/analyzers
        - name: Conventions
          uid: web-api/advanced/conventions
        - name: Test with HttpRepl
          items:
            - name: Overview
              uid: web-api/http-repl
            - name: Telemetry
              uid: web-api/http-repl/telemetry
  - name: Real-time apps
    displayName: signalr
    items:
      - name: Overview
        uid: signalr/introduction
      - name: Supported platforms
        uid: signalr/supported-platforms
        displayName: signalr
      - name: Tutorials
        items:
          - name: SignalR with JavaScript
            uid: tutorials/signalr
          - name: SignalR with TypeScript
            uid: tutorials/signalr-typescript-webpack
          - name: SignalR with Blazor
            uid: blazor/tutorials/signalr-blazor
      - name: Samples
        displayName: signalr
        items:
          - name: AI-powered group chat
            uid: tutorials/ai-powered-group-chat
            displayName: signalr
          - name: SignalR samples repository
            href: https://github.com/aspnet/SignalR-samples
            displayName: signalr
      - name: Server concepts
        displayName: signalr
        items:
          - name: Hubs
            uid: signalr/hubs
            displayName: signalr
          - name: Send from outside a hub
            uid: signalr/hubcontext
            displayName: signalr
          - name: Users and groups
            uid: signalr/groups
            displayName: signalr
          - name: API design considerations
            uid: signalr/api-design
            displayName: signalr
          - name: Hub filters
            uid: signalr/hub-filters
            displayName: signalr
      - name: Clients
        displayName: signalr
        items:
          - name: Overview
            uid: signalr/client-features
            displayName: signalr
          - name: .NET client
            uid: signalr/dotnet-client
            displayName: signalr
          - name: .NET API reference
            href: /dotnet/api/microsoft.aspnetcore.signalr.client
            displayName: signalr
          - name: Java client
            uid: signalr/java-client
            displayName: signalr
          - name: Java API reference
            href: /java/api/com.microsoft.signalr
            displayName: signalr
          - name: JavaScript client
            uid: signalr/javascript-client
            displayName: signalr
          - name: JavaScript API reference
            href: /javascript/api/@microsoft/signalr/
            displayName: signalr
          - name: Swift client
            uid: signalr/swift-client
            displayName: signalr
      - name: Host and scale
        displayName: signalr
        items:
          - name: Overview
            displayName: signalr
            uid: signalr/scale
          - name: Azure App Service
            uid: signalr/publish-to-azure-web-app
            displayName: signalr
          - name: Redis backplane
            displayName: signalr
            uid: signalr/redis-backplane
          - name: SignalR with background services
            uid: signalr/background-services
      - name: Configuration
        uid: signalr/configuration
        displayName: signalr
      - name: IHttpContextAccessor and HttpContext
        uid: signalr/httpcontext
        displayName: signalr
      - name: Authentication and authorization
        uid: signalr/authn-and-authz
        displayName: signalr
      - name: Security considerations
        uid: signalr/security
        displayName: signalr
      - name: MessagePack Hub Protocol
        uid: signalr/messagepackhubprotocol
        displayName: signalr
      - name: Streaming
        uid: signalr/streaming
        displayName: signalr
      - name: Compare SignalR and SignalR Core
        uid: signalr/version-differences
        displayName: signalr
      - name: WebSockets
        displayName: signalr
        uid: fundamentals/websockets
      - name: Logging and diagnostics
        displayName: signalr
        uid: signalr/diagnostics
      - name: Troubleshooting
        displayName: signalr
        uid: signalr/troubleshoot
      - name: Specifications
        displayName: signalr, specs
        items:
          - name: Hub protocol
            href: https://github.com/aspnet/AspNetCore/blob/main/src/SignalR/docs/specs/HubProtocol.md
          - name: Transport protocols
            href: https://github.com/aspnet/AspNetCore/blob/main/src/SignalR/docs/specs/TransportProtocols.md
  - name: Remote Procedure Call apps
    items:
      - name: Overview
        uid: grpc/index
      - name: Tutorials
        items:
          - name: Get started with a gRPC service
            uid: tutorials/grpc/grpc-start
      - name: gRPC services with C#
        items:
          - name: Overview
            uid: grpc/basics
          - name: Create services
            uid: grpc/services
          - name: Create Protobuf messages
            uid: grpc/protobuf
          - name: Version services
            uid: grpc/versioning
          - name: Test services
            uid: grpc/test-services
      - name: Call gRPC services with C#
        items:
          - name: Overview
            uid: grpc/client
          - name: Client factory integration
            uid: grpc/clientfactory
          - name: Deadlines and cancellation
            uid: grpc/deadlines-cancellation
          - name: Transient fault handling
            uid: grpc/retries
          - name: Client-side load balancing
            uid: grpc/loadbalancing
          - name: .NET Standard 2.0 support
            uid: grpc/netstandard
          - name: Mock client in tests
            uid: grpc/test-client
      - name: gRPC services with ASP.NET Core
        uid: grpc/aspnetcore
      - name: Supported platforms
        uid: grpc/supported-platforms
      - name: Use gRPC in browser apps
        items:
          - name: Overview
            uid: grpc/browser
          - name: gRPC-Web
            uid: grpc/grpcweb
          - name: gRPC JSON transcoding
            items:
              - name: Overview
                uid: grpc/json-transcoding
              - name: HTTP rules and JSON
                uid: grpc/json-transcoding-binding
              - name: Swagger / OpenAPI
                uid: grpc/json-transcoding-openapi
      - name: Configuration
        uid: grpc/configuration
      - name: Authentication and authorization
        uid: grpc/authn-and-authz
      - name: Error handling
        uid: grpc/error-handling
      - name: gRPC interceptors
        uid: grpc/interceptors
      - name: Logging and diagnostics
        uid: grpc/diagnostics
      - name: Security considerations
        uid: grpc/security
      - name: Performance best practices
        uid: grpc/performance
      - name: Native AOT
        uid: grpc/native-aot
      - name: Inter-process communication
        items:
          - name: Overview
            uid: grpc/interprocess
          - name: Unix domain sockets
            uid: grpc/interprocess-uds
          - name: Named pipes
            uid: grpc/interprocess-namedpipes
      - name: Code-first services and clients
        uid: grpc/code-first
      - name: gRPC health checks
        uid: grpc/health-checks
      - name: Manage Protobuf references with dotnet-grpc
        uid: grpc/dotnet-grpc
      - name: Test services with gRPCurl and gRPCui
        uid: grpc/test-tools
      - name: Migrate from C-core to gRPC for .NET
        uid: grpc/migration
      - name: Why migrate WCF to ASP.NET Core gRPC
        uid: grpc/wcf
      - name: Compare gRPC services with HTTP APIs
        uid: grpc/comparison
      - name: Samples
        href: https://github.com/grpc/grpc-dotnet/tree/master/examples
      - name: Troubleshoot
        uid: grpc/troubleshoot
  - name: Servers
    items:
      - name: Overview
        displayName: kestrel, iis, http.sys, httpsys, servers
        uid: fundamentals/servers/index
      - name: HTTP.sys
        displayName: deploy, publish, server, httpsys
        uid: fundamentals/servers/httpsys
      - name: Kestrel
        items:
          - name: Overview
            displayName: deploy, publish, server, kestrel
            uid: fundamentals/servers/kestrel
          - name: Endpoints
            displayName: deploy, publish, server, Kestrel
            uid: fundamentals/servers/kestrel/endpoints
          - name: Options
            displayName: deploy, publish, server, Kestrel
            uid: fundamentals/servers/kestrel/options
          - name: Diagnostics
            displayName: diagnostics
            uid: fundamentals/servers/kestrel/diagnostics
          - name: Memory management
            displayName: memory, pool, kestrel
            uid: fundamentals/servers/kestrel/memory-management
          - name: HTTP/2
            displayName: deploy, publish, server, Kestrel
            uid: fundamentals/servers/kestrel/http2
          - name: HTTP/3
            displayName: HTTP/3, kestrel
            uid: fundamentals/servers/kestrel/http3
          - name: Connection middleware
            displayName: connection, middleware, kestrel
            uid: fundamentals/servers/kestrel/connection-middleware
          - name: When to use a reverse proxy
            displayName: deploy, publish, server, Kestrel
            uid: fundamentals/servers/kestrel/when-to-use-a-reverse-proxy
          - name: Host filtering
            displayName: deploy, publish, server, Kestrel
            uid: fundamentals/servers/kestrel/host-filtering
          - name: Request draining
            displayName: deploy, publish, server, Kestrel
            uid: fundamentals/servers/kestrel/request-draining
      - name: IIS
        items:
          - name: Overview
            displayName: deploy, publish, server, iis
            uid: host-and-deploy/iis/index
          - name: ASP.NET Core Module
            displayName: deploy, publish, server, iis
            uid: host-and-deploy/aspnet-core-module
          - name: In-process hosting
            displayName: deploy, publish, server, iis
            uid: host-and-deploy/iis/in-process-hosting
          - name: Out-of-process hosting
            displayName: deploy, publish, server, iis
            uid: host-and-deploy/iis/out-of-process-hosting
          - name: Hosting Bundle
            displayName: deploy, publish, server, iis
            uid: host-and-deploy/iis/hosting-bundle
          - name: web.config file
            displayName: deploy, publish, server, iis
            uid: host-and-deploy/iis/web-config
          - name: IIS support in Visual Studio
            displayName: deploy, publish, server, iis
            uid: host-and-deploy/iis/development-time-iis-support
          - name: IIS Modules
            displayName: deploy, publish, server, iis
            uid: host-and-deploy/iis/modules
          - name: Logging and diagnostics
            displayName: deploy, publish, server, iis
            uid: host-and-deploy/iis/logging-and-diagnostics
          - name: Troubleshoot
            displayName: deploy, publish, server, iis
            uid: test/troubleshoot-azure-iis
          - name: Errors reference
            displayName: deploy, publish, server, iis
            uid: host-and-deploy/azure-iis-errors-reference
          - name: Advanced configuration
            displayName: deploy, publish, server, iis, ancm, aspnetcoremodule
            uid: host-and-deploy/iis/advanced
          - name: Transform web.config
            displayName: deploy, publish, server, iis
            uid: host-and-deploy/iis/transform-webconfig
          - name: HTTP/2
            displayName: deploy, publish, server, iis
            uid: host-and-deploy/iis/protocols
          - name: HTTP/3
            displayName: deploy, publish, server, iis
            uid: host-and-deploy/iis/http3
      - name: YARP
        items:
          - name: YARP Overview
            uid: fundamentals/servers/yarp/overview
          - name: Get started with YARP
            uid: fundamentals/servers/yarp/getting-started
          - name: Configuration
            items:
            - name: Configuration Files
              displayName: yarp
              uid: fundamentals/servers/yarp/config-files
            - name: Configuration Providers
              displayName: yarp
              uid: fundamentals/servers/yarp/config-providers
            - name: Configuration Filters
              displayName: yarp
              uid: fundamentals/servers/yarp/config-filters
            - name: HTTP client configuration
              displayName: yarp
              uid: fundamentals/servers/yarp/http-client-config
          - name: Proxy Features
            items:
              - name: Header Routing
                displayName: yarp
                uid: fundamentals/servers/yarp/header-routing
              - name: Query Parameter Routing
                displayName: yarp
                uid: fundamentals/servers/yarp/queryparameter-routing
              - name: Transforms
                items:
                  - name: Transforms Overview
                    displayName: yarp
                    uid: fundamentals/servers/yarp/transforms
                  - name: Request Transforms
                    displayName: yarp
                    uid: fundamentals/servers/yarp/transforms-request
                  - name: Response Transforms
                    displayName: yarp
                    uid: fundamentals/servers/yarp/transforms-response
              - name: Load Balancing
                displayName: yarp
                uid: fundamentals/servers/yarp/load-balancing
              - name: Session Affinity
                displayName: yarp
                uid: fundamentals/servers/yarp/session-affinity
              - name: Destinations Health Checks
                displayName: yarp
                uid: fundamentals/servers/yarp/dests-health-checks
              - name: Rate Limiting
                displayName: yarp
                uid: fundamentals/servers/yarp/rate-limiting
              - name: Timeouts
                displayName: yarp
                uid: fundamentals/servers/yarp/timeouts
              - name: Authentication and Authorization
                displayName: yarp
                uid: fundamentals/servers/yarp/authn-authz
              - name: Output Caching
                displayName: yarp
                uid: fundamentals/servers/yarp/output-caching
              - name: Distributed Tracing
                displayName: yarp
                uid: fundamentals/servers/yarp/distributed-tracing
              - name: A/B Testing
                displayName: yarp
                uid: fundamentals/servers/yarp/ab-testing
          - name: Protocols and Guidance
            items:
              - name: Header Guidelines
                displayName: yarp
                uid: fundamentals/servers/yarp/header-guidelines
              - name: HTTPS & TLS
                displayName: yarp
                uid: fundamentals/servers/yarp/https-tls
              - name: Proxying gRPC
                displayName: yarp
                uid: fundamentals/servers/yarp/grpc
              - name: HTTP/3
                displayName: yarp
                uid: fundamentals/servers/yarp/http3
              - name: Cross-Origin Requests (CORS)
                displayName: yarp
                uid: fundamentals/servers/yarp/cors
              - name: Let's Encrypt
                displayName: yarp
                uid: fundamentals/servers/yarp/lets-encrypt
              - name: WebSockets and SPDY
                displayName: yarp
                uid: fundamentals/servers/yarp/websockets
          - name: Extensibility
            items:
            - name: Overview
              displayName: yarp
              uid: fundamentals/servers/yarp/extensibility
            - name: Middleware
              displayName: yarp
              uid: fundamentals/servers/yarp/middleware
            - name: Direct Forwarding
              displayName: yarp
              uid: fundamentals/servers/yarp/direct-forwarding
            - name: Destination Resolvers
              displayName: yarp
              uid: fundamentals/servers/yarp/destination-resolvers
            - name: Request and Response Transform Extensibility
              displayName: yarp
              uid: fundamentals/servers/yarp/transform-extensibility
          - name: Deployment options
            items:
            - name: HTTP.sys Delegation
              displayName: yarp
              uid: fundamentals/servers/yarp/httpsys-delegation
            - name: Service Fabric Integration
              displayName: yarp
              uid: fundamentals/servers/yarp/service-fabric-int
            - name: YARP Kubernetes Ingress Controller
              displayName: yarp
              uid: fundamentals/servers/yarp/kubernetes-ingress
          - name: Troubleshooting
            items:
            - name: Diagnosing proxy issues
              displayName: yarp
              uid: fundamentals/servers/yarp/diagnosing-yarp-issues
  - name: Test
    items:
      - name: .NET Hot Reload
        displayName: test
        uid: test/hot-reload
      - name: Visual Studio dev tunnels
        displayName: test, tunnels
        uid: test/tunnels
      - name: Visual Studio .http files
        displayName: test, .rest, REST, HTTP
        uid: test/http-files
      - name: HttpRepl
        items:
          - name: Overview
            displayName: test, httprepl
            uid: web-api/http-repl
          - name: Telemetry
            displayName: test, httprepl
            uid: web-api/http-repl/telemetry
      - name: Test Minimal API
        uid: fundamentals/minimal-apis/test-min-api
      - name: Blazor tests
        uid: blazor/test
      - name: Razor Pages unit tests
        uid: test/razor-pages-tests
      - name: MVC controllers unit tests
        uid: mvc/controllers/testing
      - name: Integration tests
        uid: test/integration-tests
      - name: Load and stress testing
        uid: test/loadtests
      - name: Test middleware
        uid: test/middleware
      - name: .localhost top-level domain
        uid: test/localhost-tld
  - name: Debug
    items:
      - name: Debug with Visual Studio
        uid: test/debug-aspnetcore-source
      - name: Remote debugging
        href: /visualstudio/debugger/remote-debugging-azure
      - name: Snapshot debugging in Azure
        href: /azure/azure-monitor/app/snapshot-debugger?toc=/aspnet/core/toc.json&bc=/aspnet/core/breadcrumb/toc.json
      - name: Snapshot debugging in Visual Studio
        href: /visualstudio/debugger/debug-live-azure-applications
      - name: Visual Studio Dev Tunnels with Power Platform
        href: /connectors/custom-connectors/port-tunneling
  - name: Troubleshoot
    items:
      - name: Troubleshoot and debug
        uid: test/troubleshoot
      - name: Troubleshoot Azure and IIS
        uid: test/troubleshoot-azure-iis
      - name: Azure and IIS errors reference
        uid: host-and-deploy/azure-iis-errors-reference
  - name: Code analysis
    items:
      - name: Overview
        displayName: code analysis
        uid: diagnostics/code-analysis
      - name: ASP0000
        uid: diagnostics/asp0000
      - name: ASP0001
        uid: diagnostics/asp0001
      - name: ASP0003
        uid: diagnostics/asp0003
      - name: ASP0004
        uid: diagnostics/asp0004
      - name: ASP0005
        uid: diagnostics/asp0005
      - name: ASP0006
        uid: diagnostics/asp0006
      - name: ASP0007
        uid: diagnostics/asp0007
      - name: ASP0008
        uid: diagnostics/asp0008
      - name: ASP0009
        uid: diagnostics/asp0009
      - name: ASP0010
        uid: diagnostics/asp0010
      - name: ASP0011
        uid: diagnostics/asp0011
      - name: ASP0012
        uid: diagnostics/asp0012
      - name: ASP0013
        uid: diagnostics/asp0013
      - name: ASP0014
        uid: diagnostics/asp0014
      - name: ASP0015
        uid: diagnostics/asp0015
      - name: ASP0016
        uid: diagnostics/asp0016
      - name: ASP0017
        uid: diagnostics/asp0017
      - name: ASP0018
        uid: diagnostics/asp0018
      - name: ASP0019
        uid: diagnostics/asp0019
      - name: ASP0020
        uid: diagnostics/asp0020
      - name: ASP0021
        uid: diagnostics/asp0021
      - name: ASP0022
        uid: diagnostics/asp0022
      - name: ASP0023
        uid: diagnostics/asp0023
      - name: ASP0024
        uid: diagnostics/asp0024
      - name: ASP0025
        uid: diagnostics/asp0025
      - name: ASP0026
        uid: diagnostics/asp0026
      - name: ASP0027
        uid: diagnostics/asp0027
      - name: ASP0028
        uid: diagnostics/asp0028
      - name: BL0001
        uid: diagnostics/bl0001
      - name: BL0002
        uid: diagnostics/bl0002
      - name: BL0003
        uid: diagnostics/bl0003
      - name: BL0004
        uid: diagnostics/bl0004
      - name: BL0005
        uid: diagnostics/bl0005
      - name: BL0006
        uid: diagnostics/bl0006
      - name: BL0007
        uid: diagnostics/bl0007
      - name: BL0008
        uid: diagnostics/bl0008
      - name: MVC1000
        uid: diagnostics/mvc1000
      - name: MVC1001
        uid: diagnostics/mvc1001
      - name: MVC1002
        uid: diagnostics/mvc1002
      - name: MVC1003
        uid: diagnostics/mvc1003
      - name: MVC1004
        uid: diagnostics/mvc1004
      - name: MVC1005
        uid: diagnostics/mvc1005
      - name: MVC1006
        uid: diagnostics/mvc1006
  - name: RDG diagnostics
    items:
      - name: Overview
        displayName: aot, rdg diagnostics
        uid: fundamentals/aot/request-delegate-generator/rdg-ids
      - name: RDG002
        uid: fundamentals/aot/request-delegate-generator/diagnostics/rdg002
      - name: RDG004
        uid: fundamentals/aot/request-delegate-generator/diagnostics/rdg004
      - name: RDG005
        uid: fundamentals/aot/request-delegate-generator/diagnostics/rdg005
      - name: RDG006
        uid: fundamentals/aot/request-delegate-generator/diagnostics/rdg006
      - name: RDG007
        uid: fundamentals/aot/request-delegate-generator/diagnostics/rdg007
      - name: RDG008
        uid: fundamentals/aot/request-delegate-generator/diagnostics/rdg008
      - name: RDG009
        uid: fundamentals/aot/request-delegate-generator/diagnostics/rdg009
      - name: RDG010
        uid: fundamentals/aot/request-delegate-generator/diagnostics/rdg010
      - name: RDG011
        uid: fundamentals/aot/request-delegate-generator/diagnostics/rdg011
      - name: RDG012
        uid: fundamentals/aot/request-delegate-generator/diagnostics/rdg012
      - name: RDG013
        uid: fundamentals/aot/request-delegate-generator/diagnostics/rdg013
  - name: ASPDEPR diagnostics
    items:
      - name: Overview
        displayName: aspdepr diagnostics
        uid: diagnostics/aspdepr-ids
      - name: ASPDEPR002
        uid: diagnostics/aspdepr002
  - name: Data access
    items:
      - name: Tutorials
        items:
          - name: EF Core with Razor Pages
            items:
              - name: Get started
                uid: data/ef-rp/intro
              - name: Create, Read, Update, and Delete
                uid: data/ef-rp/crud
              - name: Sort, filter, page, and group
                uid: data/ef-rp/sort-filter-page
              - name: Migrations
                uid: data/ef-rp/migrations
              - name: Create a complex data model
                uid: data/ef-rp/complex-data-model
              - name: Read related data
                uid: data/ef-rp/read-related-data
              - name: Update related data
                uid: data/ef-rp/update-related-data
              - name: Handle concurrency conflicts
                uid: data/ef-rp/concurrency
          - name: EF Core with MVC
            items:
              - name: Overview
                uid: data/ef-mvc/index
              - name: Get started
                uid: data/ef-mvc/intro
              - name: Create, Read, Update, and Delete
                uid: data/ef-mvc/crud
              - name: Sort, filter, page, and group
                uid: data/ef-mvc/sort-filter-page
              - name: Migrations
                uid: data/ef-mvc/migrations
              - name: Create a complex data model
                uid: data/ef-mvc/complex-data-model
              - name: Read related data
                uid: data/ef-mvc/read-related-data
              - name: Update related data
                uid: data/ef-mvc/update-related-data
              - name: Handle concurrency conflicts
                uid: data/ef-mvc/concurrency
              - name: Inheritance
                uid: data/ef-mvc/inheritance
              - name: Advanced topics
                uid: data/ef-mvc/advanced
      - name: Scaffold a data model with dotnet scaffold in RP
        uid: data/dotnet-scaffold-rp
      - name: EF 6 with ASP.NET Core
        uid: data/entity-framework-6
      - name: Azure SQL Database with Azure App Service
        href: /azure/app-service/tutorial-connect-msi-sql-database?tabs=efcore%2Cdotnetcore
      - name: Azure Storage with Visual Studio
        items:
          - name: Connected Services
            href: /visualstudio/azure/vs-azure-tools-connected-services-storage
          - name: Blob storage
            href: /azure/visual-studio/vs-storage-aspnet5-getting-started-blobs?toc=/aspnet/core/toc.json&bc=/aspnet/core/breadcrumb/toc.json
          - name: Queue storage
            href: /azure/visual-studio/vs-storage-aspnet5-getting-started-queues?toc=/aspnet/core/toc.json&bc=/aspnet/core/breadcrumb/toc.json
          - name: Table storage
            href: /azure/visual-studio/vs-storage-aspnet5-getting-started-tables?toc=/aspnet/core/toc.json&bc=/aspnet/core/breadcrumb/toc.json
  - name: Host and deploy
    displayName: publish
    items:
      - name: Overview
        displayName: azure, deploy, publish
        uid: host-and-deploy/index
      - name: Azure App Service
        displayName: deploy, publish
        items:
          - name: Overview
            displayName: azure, deploy, publish
            uid: host-and-deploy/azure-apps/index
          - name: Publish with Visual Studio
            displayName: azure, deploy, publish
            uid: tutorials/publish-to-azure-webapp-using-vs
          - name: Publish with Visual Studio for Mac
            displayName: azure, deploy, publish
            href: /visualstudio/mac/publish-app-svc?toc=/aspnet/core/toc.json&bc=/aspnet/core/breadcrumb/toc.json
          - name: Publish with the CLI
            displayName: azure, deploy, publish
            href: /azure/app-service/tutorial-dotnetcore-sqldb-app?toc=/aspnet/core/toc.json&bc=/aspnet/core/breadcrumb/toc.json
          - name: Continuous deployment with Azure Pipelines
            displayName: azure, deploy, publish
            href: /azure/devops/pipelines/get-started-yaml
          - name: ASP.NET Core Module (ANCM) for IIS
            displayName: azure, deploy, publish
            uid: host-and-deploy/aspnet-core-module
          - name: Troubleshoot
            displayName: azure, deploy, publish
            uid: test/troubleshoot-azure-iis
          - name: Errors reference
            displayName: azure, deploy, publish
            uid: host-and-deploy/azure-iis-errors-reference
      - name: DevOps
        items:
          - name: Overview
            displayName: azure, deploy, publish
            href: /dotnet/architecture/devops-for-aspnet-developers
          - name: Tools and downloads
            displayName: azure, deploy, publish
            href: /dotnet/architecture/devops-for-aspnet-developers/tools-and-downloads
          - name: Deploy to App Service
            displayName: azure, deploy, publish
            href: /dotnet/architecture/devops-for-aspnet-developers/deploying-to-app-service
          - name: Continuous integration and deployment
            displayName: azure, deploy, publish
            href: /dotnet/architecture/devops-for-aspnet-developers/cicd
          - name: Monitor and troubleshoot
            displayName: azure, deploy, publish
            href: /dotnet/architecture/devops-for-aspnet-developers/monitoring
          - name: Next steps
            displayName: azure, deploy, publish
            href: /dotnet/architecture/devops-for-aspnet-developers/next-steps
      - name: Publish to IIS tutorial
        displayName: deploy
        uid: tutorials/publish-to-iis
      - name: Windows service
        displayName: deploy, publish
        uid: host-and-deploy/windows-service
      - name: Linux with Nginx
        displayName: deploy, publish
        uid: host-and-deploy/linux-nginx
      - name: Docker
        displayName: deploy, publish
        items:
          - name: Overview
            displayName: deploy, publish, docker
            uid: host-and-deploy/docker/index
          - name: Build Docker images
            displayName: deploy, publish, docker
            uid: host-and-deploy/docker/building-net-docker-images
          - name: Visual Studio Tools
            displayName: deploy, publish, docker
            uid: host-and-deploy/docker/visual-studio-tools-for-docker
          - name: Publish to a Docker image
            displayName: deploy, publish, docker
            href: /visualstudio/containers/vs-azure-tools-docker-hosting-web-apps-in-docker
          - name: Sample Docker images
            displayName: deploy, publish, docker
            href: https://github.com/dotnet/dotnet-docker/blob/main/samples/aspnetapp/README.md
      - name: Proxy and load balancer configuration
        displayName: deploy, publish
        uid: host-and-deploy/proxy-load-balancer
      - name: Scaling apps on Azure
        displayName: azure, deploy, publish, scale
        uid: host-and-deploy/scaling-aspnet-apps/scaling-aspnet-apps
      - name: Web farm
        displayName: deploy, publish
        uid: host-and-deploy/web-farm
      - name: Visual Studio publish profiles
        displayName: deploy, publish
        uid: host-and-deploy/visual-studio-publish-profiles
      - name: Visual Studio for Mac publish to folder
        displayName: deploy, publish
        href: /visualstudio/mac/publish-folder?toc=/aspnet/core/toc.json&bc=/aspnet/core/breadcrumb/toc.json
      - name: Directory structure
        displayName: deploy, publish
        uid: host-and-deploy/directory-structure
  - name: Security and Identity
    displayName: authentication, authorization
    items:
      - name: Overview
        uid: security/index
      - name: Authentication
        items:
          - name: Overview
            uid: security/authentication/index
          - name: Choose an identity solution
            uid: security/how-to-choose-identity
          - name: ASP.NET Core Identity
            items:
              - name: Overview
                uid: security/authentication/identity
              - name: Identity with SPA
                uid: security/authentication/identity/spa
              - name: Scaffold Identity
                uid: security/authentication/scaffold-identity
              - name: Add custom user data to Identity
                uid: security/authentication/add-user-data
              - name: Customize Identity
                uid: security/authentication/customize_identity_model
              - name: Configure Identity
                uid: security/authentication/identity-configuration
              - name: Custom storage providers for Identity
                uid: security/authentication/identity-custom-storage-providers
              - name: Account confirmation and password recovery
                uid: security/authentication/accconfirm
              - name: Enable QR code generation in Identity
                uid: security/authentication/identity-enable-qrcodes
              - name: Two-factor authentication with SMS
                uid: security/authentication/2fa
              - name: Passkeys (WebAuthn)
                items:
                  - name: Overview
                    uid: security/authentication/passkeys/index
                  - name: Blazor
                    uid: security/authentication/passkeys/blazor
              - name: External authentication providers
                items:
                  - name: Overview
                    uid: security/authentication/social/index
                  - name: Google authentication
                    uid: security/authentication/google-logins
                  - name: Facebook authentication
                    uid: security/authentication/facebook-logins
                  - name: Microsoft authentication
                    uid: security/authentication/microsoft-logins
                  - name: Twitter authentication
                    uid: security/authentication/twitter-logins
                  - name: Other providers
                    uid: security/authentication/otherlogins
                  - name: Additional claims
                    uid: security/authentication/social/additional-claims
              - name: Individual user accounts
                uid: security/authentication/individual
          - name: Azure
            items:
              - name: Overview
                uid: security/authentication/azure-active-directory/index
              - name: Secure ASP.NET Core apps with Microsoft identity web
                href: https://github.com/AzureAD/microsoft-identity-web/wiki
              - name: Secure ASP.NET Core apps with Microsoft identity platform
                href: /azure/active-directory/develop/
              - name: Secure ASP.NET Core apps with Azure App Service authentication (Easy Auth)
                href: /azure/app-service/overview-authentication-authorization?toc=/aspnet/core/toc.json&bc=/aspnet/core/breadcrumb/toc.json
              - name: Scenarios
                items:
                  - name: Web app that signs in users
                    href: /azure/active-directory/develop/scenario-web-app-sign-user-overview?tabs=aspnetcore
                  - name: Web app that calls web APIs
                    href: /azure/active-directory/develop/scenario-web-app-call-api-overview
                  - name: Protected web API
                    href: /azure/active-directory/develop/scenario-protected-web-api-overview
                  - name: Web API that calls other web APIs
                    href: /azure/active-directory/develop/scenario-web-api-call-api-overview
                  - name: Integrate Azure AD B2C into a web app
                    uid: security/authentication/azure-ad-b2c
              - name: Samples
                items:
                  - name: Enable your Web Apps to sign-in users and call APIs with the Microsoft identity platform for developers
                    href: https://github.com/Azure-Samples/active-directory-aspnetcore-webapp-openidconnect-v2/
                  - name: Calling an ASP.NET Core 2.0 Web API from a WPF application using Azure AD V2
                    href: https://github.com/Azure-Samples/active-directory-dotnet-native-aspnetcore-v2/tree/master/1.%20Desktop%20app%20calls%20Web%20API
                  - name: Web API with Azure AD B2C
                    href: /azure/active-directory-b2c/enable-authentication-web-api
          - name: Configure cookie authentication
            uid: security/authentication/cookie
          - name: API endpoint authentication behavior
            uid: security/authentication/api-endpoint-auth
          - name: Configure OIDC web authentication
            uid: security/authentication/configure-oidc-web-authentication
          - name: Configure JWT bearer authentication
            uid: security/authentication/configure-jwt-bearer-authentication
          - name: Configure certificate authentication
            uid: security/authentication/certauth
          - name: Configure Windows authentication
            uid: security/authentication/windowsauth
          - name: Configure WS-Federation authentication
            uid: security/authentication/ws-federation
          - name: Configure social authentication
            uid: security/authentication/social/social-without-identity
          - name: Policy schemes
            uid: security/authentication/policyschemes
          - name: Manage JWTs in development
            displayName: jwt, JSON WEB Token
            uid: security/authentication/jwt
          - name: Map, customize, and transform claims
            uid: security/authentication/claims
          - name: Community OSS authentication options
            uid: security/authentication/community
          - name: Identity management solutions
            uid: security/identity-management-solutions
          - name: Multi-factor authentication
            uid: security/authentication/mfa
      - name: Authorization
        items:
          - name: Overview
            uid: security/authorization/introduction
          - name: Create a web app with authorization
            uid: security/authorization/secure-data
          - name: Simple authorization
            uid: security/authorization/simple
          - name: Custom authorization with IAuthorizationRequirementData
            uid: security/authorization/iard
          - name: Role-based authorization
            uid: security/authorization/roles
          - name: Claims-based authorization
            uid: security/authorization/claims
          - name: Policy-based authorization
            uid: security/authorization/policies
          - name: Authorization policy providers
            uid: security/authorization/iauthorizationpolicyprovider
          - name: Customize the behavior of AuthorizationMiddleware
            uid: security/authorization/authorizationmiddlewareresulthandler
          - name: Dependency injection in requirement handlers
            uid: security/authorization/dependencyinjection
          - name: Resource-based authorization
            uid: security/authorization/resourcebased
          - name: View-based authorization
            uid: security/authorization/views
          - name: Limit identity by scheme
            uid: security/authorization/limitingidentitybyscheme
      - name: Data protection
        displayName: encryption
        items:
          - name: Overview
            uid: security/data-protection/introduction
          - name: Data protection APIs
            uid: security/data-protection/using-data-protection
          - name: Consumer APIs
            items:
              - name: Overview
                uid: security/data-protection/consumer-apis/overview
              - name: Purpose strings
                uid: security/data-protection/consumer-apis/purpose-strings
              - name: Purpose hierarchy and multi-tenancy
                uid: security/data-protection/consumer-apis/purpose-strings-multitenancy
              - name: Hash passwords
                uid: security/data-protection/consumer-apis/password-hashing
              - name: Limit the lifetime of protected payloads
                uid: security/data-protection/consumer-apis/limited-lifetime-payloads
              - name: Unprotect payloads whose keys have been revoked
                uid: security/data-protection/consumer-apis/dangerous-unprotect
          - name: Configuration
            items:
              - name: Overview
                uid: security/data-protection/configuration/index
              - name: Configure data protection
                uid: security/data-protection/configuration/overview
              - name: Default settings
                uid: security/data-protection/configuration/default-settings
              - name: Machine-wide policy
                uid: security/data-protection/configuration/machine-wide-policy
              - name: Non-DI aware scenarios
                uid: security/data-protection/configuration/non-di-scenarios
          - name: Extensibility APIs
            items:
              - name: Overview
                uid: security/data-protection/extensibility/index
              - name: Core cryptography extensibility
                uid: security/data-protection/extensibility/core-crypto
              - name: Key management extensibility
                uid: security/data-protection/extensibility/key-management
              - name: Miscellaneous APIs
                uid: security/data-protection/extensibility/misc-apis
          - name: Implementation
            items:
              - name: Overview
                uid: security/data-protection/implementation/index
              - name: Authenticated encryption details
                uid: security/data-protection/implementation/authenticated-encryption-details
              - name: Subkey derivation and authenticated encryption
                uid: security/data-protection/implementation/subkeyderivation
              - name: Context headers
                uid: security/data-protection/implementation/context-headers
              - name: Key management
                uid: security/data-protection/implementation/key-management
              - name: Key storage providers
                uid: security/data-protection/implementation/key-storage-providers
              - name: Key encryption at rest
                uid: security/data-protection/implementation/key-encryption-at-rest
              - name: Key immutability and settings
                uid: security/data-protection/implementation/key-immutability
              - name: Key storage format
                uid: security/data-protection/implementation/key-storage-format
              - name: Ephemeral data protection providers
                uid: security/data-protection/implementation/key-storage-ephemeral
          - name: Compatibility
            items:
              - name: Overview
                uid: security/data-protection/compatibility/index
              - name: Replace machineKey in ASP.NET
                uid: security/data-protection/compatibility/replacing-machinekey
      - name: Secrets management
        items:
          - name: Protect secrets in development
            displayName: password, connection string, API key
            uid: security/app-secrets
          - name: Manage JWTs in development
            displayName: jwt, JSON WEB Token
            uid: security/authentication/jwt
          - name: Azure Key Vault Configuration Provider
            displayName: password, connection string, API key, secrets
            uid: security/key-vault-configuration
      - name: Enforce HTTPS
        uid: security/enforcing-ssl
      - name: Host Docker with HTTPS
        uid: security/docker-https
      - name: Docker Compose with HTTPS
        uid: security/docker-compose-https
      - name: EU General Data Protection Regulation (GDPR) support
        uid: security/gdpr
      - name: Prevent Cross-Site Request Forgery (XSRF/CSRF) attacks
        uid: security/anti-request-forgery
      - name: Prevent open redirect attacks
        uid: security/preventing-open-redirects
      - name: Prevent Cross-Site Scripting (XSS)
        uid: security/cross-site-scripting
      - name: Enable Cross-Origin Requests (CORS)
        uid: security/cors
      - name: Share cookies among apps
        uid: security/cookie-sharing
      - name: SameSite cookies
        uid: security/samesite
      - name: SameSite samples
        items:
          - name: Razor Pages 2.1 SameSite cookie sample
            uid: security/samesite/rp21
          - name: Razor Pages 3.1 SameSite cookie sample
            uid: security/samesite/rp31
          - name: MVC SameSite cookie sample
            uid: security/samesite/mvc21
      - name: IP safelist
        uid: security/ip-safelist
      - name: Application security - OWASP
        href: https://cheatsheetseries.owasp.org/cheatsheets/DotNet_Security_Cheat_Sheet.html
  - name: Performance
    items:
      - name: Overview
        uid: performance/overview
      - name: Best practices
        displayName: performance
        uid: fundamentals/best-practices
      - name: Caching
        items:
          - name: Overview
            displayName: cache, caching
            uid: performance/caching/overview
          - name: In-memory cache
            displayName: caching
            uid: performance/caching/memory
          - name: Distributed caching
            displayName: cache
            uid: performance/caching/distributed
          - name: Hybrid cache
            displayName: caching
            uid: performance/caching/hybrid
          - name: Output caching
            displayName: cache
            uid: performance/caching/output
          - name: Response caching
            displayName: cache
            uid: performance/caching/response
          - name: Response caching middleware
            displayName: cache
            uid: performance/caching/middleware
      - name: Rate limiting middleware
        uid: performance/rate-limit
      - name: Timeouts middleware
        uid: performance/timeouts
      - name: Memory and GC
        uid: performance/memory
      - name: Scaling apps on Azure
        displayName: azure, deploy, publish, scale
        uid: host-and-deploy/scaling-aspnet-apps/scaling-aspnet-apps
      - name: Object reuse with ObjectPool
        uid: performance/ObjectPool
      - name: Response compression
        uid: performance/response-compression
      - name: Diagnostic tools
        uid: performance/diagnostic-tools
      - name: Load and stress testing
        uid: test/loadtests
      - name: Event counters
        href: /dotnet/core/diagnostics/event-counter-perf
  - name: Globalization and localization
    items:
      - name: Overview
        displayName: globalization, localization
        uid: fundamentals/localization
      - name: Make an app's content localizable
        displayName: globalization, localization
        uid: fundamentals/localization/make-content-localizable
      - name: Provide resources
        displayName: globalization, localization
        uid: fundamentals/localization/provide-resources
      - name: Select language/culture
        displayName: globalization, localization
        uid: fundamentals/localization/select-language-culture
      - name: Portable Object localization
        uid: fundamentals/portable-object-localization
      - name: Extensibility
        uid: fundamentals/localization-extensibility
      - name: Troubleshoot
        uid: fundamentals/troubleshoot-aspnet-core-localization
  - name: Advanced
    items:
      - name: Model binding
        uid: mvc/models/model-binding
      - name: Custom model binding
        uid: mvc/advanced/custom-model-binding
      - name: Model validation
        uid: mvc/models/validation
      - name: Compatibility version
        uid: mvc/compatibility-version
      - name: Write middleware
        uid: fundamentals/middleware/write
      - name: Request and response operations
        displayName: middleware
        uid: fundamentals/middleware/request-response
      - name: Request decompression
        displayName: request decompression middleware
        uid: fundamentals/middleware/request-decompression
      - name: URL rewriting
        uid: fundamentals/url-rewriting
      - name: File providers
        uid: fundamentals/file-providers
      - name: Request-feature interfaces
        uid: fundamentals/request-features
      - name: Access HttpContext
        uid: fundamentals/httpcontext
      - name: Change tokens
        uid: fundamentals/change-tokens
      - name: Open Web Interface for .NET (OWIN)
        uid: fundamentals/owin
      - name: Background tasks with hosted services
        uid: fundamentals/host/hosted-services
      - name: Hosting startup assemblies
        uid: fundamentals/configuration/platform-specific-configuration
      - name: ASP.NET Core in class libraries
        displayName: shared framework
        uid: fundamentals/target-aspnetcore
      - name: Microsoft.AspNetCore.App metapackage
        uid: fundamentals/metapackage-app
      - name: Microsoft.AspNetCore.All metapackage
        uid: fundamentals/metapackage
      - name: High performance logging
        displayName: loggermessage
        href: /dotnet/core/extensions/high-performance-logging?toc=/aspnet/core/toc.json&bc=/aspnet/core/breadcrumb/toc.json
      - name: Use a file watcher
        uid: tutorials/dotnet-watch
      - name: Factory-based middleware
        uid: fundamentals/middleware/extensibility
      - name: Factory-based middleware with third-party container
        uid: fundamentals/middleware/extensibility-third-party-container
  - name: Migration and updates
    items:
      - name: Overview
        displayName: migrate, migration
        uid: migration/index
      - name: Version updates
        items:
          - name: 9 to 10
            displayName: migrate, migration
            uid: migration/90-to-100
          - name: 8 to 9
            displayName: migrate, migration
            uid: migration/80-to-90
          - name: 7 to 8
            displayName: migrate, migration
            uid: migration/70-to-80
          - name: 6 to 7
            displayName: migrate, migration
            uid: migration/60-to-70
          - name: 5 to 6
            displayName: migrate, migration
            uid: migration/50-to-60
          - name: 3.1/5.0 Code to 6
            displayName: migrate, migration
            uid: migration/50-to-60-samples
          - name: 3.1 to 6 LTS
            displayName: migrate, migration, LTS
            uid: migration/31-to-60
          - name: Older versions
            items:
              - name: 3.1 to 5.0
                displayName: migrate, migration
                uid: migration/31-to-50
              - name: 3.0 to 3.1
                displayName: migrate, migration
                uid: migration/30-to-31
              - name: 2.2 to 3.0
                displayName: migrate, migration
                uid: migration/22-to-30
              - name: 2.1 to 2.2
                displayName: migrate, migration
                uid: migration/21-to-22
              - name: Logging 2.1 to 2.2 or 3.0
                displayName: migrate, migration
                uid: migration/logging-nonaspnetcore
              - name: 2.0 to 2.1
                displayName: migrate, migration
                uid: migration/20-to-21
              - name: 1.x to 2.0
                displayName: migrate, migration
                items:
                  - name: Overview
                    uid: migration/1x-to-2x/index
                  - name: Authentication and Identity
                    uid: migration/1x-to-2x/identity-2x
      - name: ASP.NET to ASP.NET Core
        displayName: migrate, migration
        items:
          - name: Overview
            uid: migration/fx-to-core/index
          - name: Get started
            uid: migration/fx-to-core/start
          - name: Tooling
            uid: migration/fx-to-core/tooling
          - name: Incremental migration
            displayName: migrate, migration
            items:
            - name: System.Web adapters
              uid: migration/fx-to-core/systemweb-adapters
            - name: Remote app setup
              uid: migration/fx-to-core/inc/remote-app-setup
            - name: A/B Testing endpoints
              uid: migration/fx-to-core/inc/ab-testing
            - name: Blazor support with YARP
              uid: migration/fx-to-core/inc/blazor
          - name: Technology Areas
            items:
            - name: Overview
              uid: migration/fx-to-core/areas
            - name: HttpApplicationHost
              uid: migration/fx-to-core/areas/hosting
            - name: HttpContext
              uid: migration/fx-to-core/areas/http-context
            - name: HTTP Modules
              uid: migration/fx-to-core/areas/http-modules
            - name: HTTP Handlers
              uid: migration/fx-to-core/areas/http-handlers
            - name: Machine Key
              uid: migration/fx-to-core/areas/machine-key
            - name: Session
              uid: migration/fx-to-core/areas/session
            - name: Authentication
              uid: migration/fx-to-core/areas/authentication
            - name: Membership
              uid: migration/fx-to-core/areas/membership
            - name: OWIN
              uid: migration/fx-to-core/areas/owin
            - name: Web API
              uid: migration/fx-to-core/areas/webapi
            - name: ClaimsPrincipal.Current
              uid: migration/fx-to-core/areas/claimsprincipal-current
            - name: Miscellaneous
              uid: migration/fx-to-core/areas/misc
          - name: Example Migration
            items:
            - name: Overview
              uid: migration/fx-to-core/examples/overview
            - name: Configuration
              uid: migration/fx-to-core/examples/configuration
            - name: Identity
              uid: migration/fx-to-core/examples/identity
  - name: API reference
    href: /dotnet/api/
  - name: Contribute
    href: https://github.com/dotnet/AspNetCore.Docs/blob/main/CONTRIBUTING.md