TOC.yml

- name: Microsoft Authentication Libraries for .NET
  items:
  - name: Choosing the right library
    href: getting-started/choosing-msal-dotnet.md
  - name: Microsoft Authentication Library for .NET
    href: index.md
    items:
    - name: Getting started
      items:
      - name: Scenarios
        href: getting-started/scenarios.md
      - name: Initializing client applications
        href: getting-started/initializing-client-applications.md
      - name: Instantiate public client apps
        href: getting-started/instantiate-public-client-config-options.md
      - name: Instantiate confidential client apps
        href: getting-started/instantiate-confidential-client-config-options.md        
      - name: Best practices
        href: getting-started/best-practices.md
    - name: Acquiring tokens
      items:
      - name: Overview
        href: acquiring-tokens/overview.md
      - name: Desktop and mobile applications
        items:
        - name: Acquiring tokens interactively
          href: acquiring-tokens/desktop-mobile/acquiring-tokens-interactively.md
        - name: Using MSAL.NET with broker on Windows (Web Account Manager / WAM)
          href: ./acquiring-tokens/desktop-mobile/wam.md
        - name: Using MSAL.NET with broker on MacOS
          href: ./acquiring-tokens/desktop-mobile/macos-broker-dotnet-sdk.md
        - name: Using MSAL.Net with broker on Linux distributions
          href: ./acquiring-tokens/desktop-mobile/linux-dotnet-sdk.md
        - name: Using MSAL.Net with WSL
          href: ./acquiring-tokens/desktop-mobile/linux-dotnet-sdk-wsl.md
        - name: Xamarin
          href: acquiring-tokens/desktop-mobile/mobile-applications.md
        - name: Sign-in users with social identities
          href: acquiring-tokens/desktop-mobile/social-identities.md
        - name: Integrated Windows Authentication for domain or Microsoft Entra joined machines
          href: acquiring-tokens/desktop-mobile/integrated-windows-authentication.md
        - name: Username/password authentication
          href: acquiring-tokens/desktop-mobile/username-password-authentication.md
        - name: Device Code Flow for devices without a Web browser
          href: acquiring-tokens/desktop-mobile/device-code-flow.md
        - name: ADFS support
          href: acquiring-tokens/desktop-mobile/adfs-support.md
      - name: Web apps/web APIs/daemon apps
        items:
        - name: Client credential flows
          href: acquiring-tokens/web-apps-apis/client-credential-flows.md
        - name: Acquiring a token on behalf of a user (service to service calls)
          href: acquiring-tokens/web-apps-apis/on-behalf-of-flow.md
        - name: Acquiring a token by authorization code in web apps
          href: acquiring-tokens/web-apps-apis/authorization-codes.md
        - name: Acquiring a token with federated workload identity
          href: acquiring-tokens/web-apps-apis/workload-identity-federation.md
        - name: Confidential client assertions
          href: acquiring-tokens/web-apps-apis/confidential-client-assertions.md
      - name: AcquireTokenSilentAsync API
        href: acquiring-tokens/acquiretokensilentasync-api.md
      - name: Acquire a token from the cache 
        href: acquiring-tokens/acquire-token-silently.md
      - name: Clear the token cache
        href: acquiring-tokens/clear-token-cache.md
      - name: Get consent for several resources
        href: acquiring-tokens/user-gets-consent-for-multiple-resources.md
      - name: Using web browsers for interactive authentication
        href: acquiring-tokens/using-web-browsers.md
    - name: Advanced topics
      items:
      - name: High availability
        href: advanced/high-availability.md
      - name: Handling exceptions and errors
        items:
        - name: Overview
          href: advanced/exceptions/index.md
        - name: Handle errors and exceptions in MSAL.NET
          href: advanced/exceptions/msal-error-handling.md
        - name: Logging
          href: advanced/exceptions/msal-logging.md
        - name: Retry policy
          href: advanced/exceptions/retry-policy.md
        - name: Understanding MsalUiRequiredException
          href: advanced/exceptions/understanding-msaluirequiredexception.md
        - name: State mismatch error
          href: advanced/exceptions/understanding-statemismatcherror.md
        - name: Device authentication errors
          href: advanced/exceptions/device-authentication-errors.md
        - name: TLS issues
          href: advanced/exceptions/tls-issues.md
        - name: Handling Unity issues with MSAL.NET
          href: advanced/exceptions/unity.md
        - name: Troubleshooting the broker
          href: advanced/exceptions/broker.md
        - name: Errors associated with Web Account Manager (WAM)
          href: advanced/exceptions/wam-errors.md
      - name: Providing your own HttpClient and proxy
        href: advanced/httpclient.md
      - name: Extensibility points
        href: advanced/extensibility-points.md
      - name: Clearing the token cache
        href: advanced/clearing-token-cache.md
      - name: Client credential multi-tenant guidance
        href: advanced/client-credential-multi-tenant.md
      - name: Performance testing
        href: advanced/performance-testing.md
      - name: Using MSAL.NET from PowerShell
        href: advanced/powerShell-support.md
      - name: Testing apps using MSAL
        href: advanced/testing-apps-using-msal.md
      - name: Experimental features
        href: advanced/experimental-features.md
      - name: Proof-of-Possession (PoP) tokens
        href: advanced/proof-of-possession-tokens.md
      - name: Using in Azure functions
        href: advanced/using-in-azure-functions.md
      - name: Extracting info from WWW-Authenticate headers
        href: advanced/extract-authentication-parameters.md
      - name: SPA authorization code
        href: advanced/spa-authorization-code.md
      - name: Android and iOS emulators with MSAL
        href: advanced/android-ios-emulator.md
      - name: Monitoring
        href: advanced/monitoring.md
      - name: Multi-cloud support/instance awareness
        href: advanced/multicloud-support-instance-awareness.md
      - name: Managed identity
        href: advanced/managed-identity.md
      - name: Custom authority aliases
        href: advanced/custom-authority-aliases.md
      - name: SSH certificates
        href: advanced/ssh-certificates.md
      - name: Backup authentication system
        href: advanced/backup-authentication-system.md
      - name: Client and server throttling
        href: advanced/client-and-server-throttling.md
      - name: WebView2
        href: advanced/webview2.md
    - name: How-to
      items:
      - name: Migrate to MSAL.NET
        items:
        - name: Migrate from ADAL.NET to MSAL.NET
          href: how-to/msal-net-migration.md
        - name: Migrate confidential client apps to MSAL.NET
          href: how-to/migrate-confidential-client.md
        - name: Migrate public client apps to MSAL.NET
          href: how-to/migrate-public-client.md
        - name: Differences between ADAL.NET and MSAL.NET
          href: how-to/differences-adal-msal-net.md
        - name: Migrate broker-enabled Xamarin Android app MSAL.NET
          href: how-to/migrate-android-broker.md
        - name: Migrate broker-enabled Xamarin iOS app MSAL.NET
          href: how-to/migrate-ios-broker.md
      - name: Install NuGet package from other sources
        href: how-to/install-nuget-custom-source.md
      - name: Synchronous programming
        href: how-to/synchronous-programming.md
      - name: Override the target framework
        href: how-to/override-target-framework.md
      - name: Setting the default reply URI
        href: how-to/default-reply-uri.md
      - name: Protect resources in iOS and Android apps using InTune MAM and MSAL.NET
        href: how-to/protect-ios-android-mam-intune.md
      - name: Setting cache options
        href: how-to/cache-options.md
      - name: Custom token cache for a public client application
        href: how-to/custom-token-cache-in-public-client-applications.md
      - name: Serialize the token cache
        href: how-to/token-cache-serialization.md
      - name: Building applications on Ubuntu Linux
        href: how-to/build-apps-on-linux-ubuntu.md
      - name: Overriding authority
        href: how-to/overriding-authority.md
      - name: Creating a configuration for MAM (conditional access)
        href: how-to/create-config-for-mam-conditional-access.md
      - name: Getting tenant profiles
        href: how-to/get-tenant-profiles.md
    - name: Additional resources
      items:
      - name: Semantic versioning and API change management
        href: resources/semantic-versioning-api-change-management.md
      - name: Troubleshooting
        href: resources/troubleshooting.md
      - name: Region discovery troubleshooting
        href: resources/region-discovery-troubleshooting.md
      - name: Telemetry overview
        href: resources/telemetry-overview.md
      - name: Handling of personally identifiable information
        href: resources/handling-pii.md
      - name: Releases
        href: https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/releases
      - name: MSAL.NET reference documentation
        href: /active-directory/adal/microsoft.identity.client
      - name: Azure AD v2.0 developer guide
        href: /azure/active-directory/develop/
      - name: Code samples
        href: /azure/active-directory/develop/sample-v2-code
      - name: Known issues
        href: resources/known-issues.md
  - name: Microsoft Identity Web
    href: microsoft-identity-web/index.md
    items:
    - name: Getting started
      items:
      - name: Scenarios
        href: microsoft-identity-web/getting-started/scenarios.md