Document ClaimActions configuration for dashboard OpenID Connect authentication

[Copilot]

Description

This PR documents the new ClaimActions configuration feature for the Aspire dashboard's OpenID Connect authentication, introduced in dotnet/aspire#8396.

The ClaimActions configuration allows users to map custom claims from their OpenID Connect identity provider's user info endpoint to the dashboard user's claims identity. This is particularly useful for scenarios requiring role-based authentication or mapping custom claims that aren't included by default.

Changes

• Added Dashboard:Frontend:OpenIdConnect:ClaimActions configuration option to the Frontend authentication table
• Created a new "Claim actions" subsection with detailed documentation including:
  • Property reference table for all ClaimAction properties (ClaimType, JsonKey, SubKey, IsUnique, ValueType)
  • Complete JSON configuration example demonstrating role-based authentication
  • Environment variable configuration example
  • Advanced example showing nested JSON property mapping using SubKey
• Updated ms.date to reflect the documentation update

Example Usage

JSON Configuration

{
  "Dashboard": {
    "Frontend": {
      "OpenIdConnect": {
        "ClaimActions": [
          {
            "ClaimType": "role",
            "JsonKey": "role"
          }
        ]
      }
    }
  }
}

Environment Variables

export Dashboard__Frontend__OpenIdConnect__ClaimActions__0__ClaimType="role"
export Dashboard__Frontend__OpenIdConnect__ClaimActions__0__JsonKey="role"

Fixes the documentation request from dotnet/aspire#8396.

Original prompt

Document configuring claims actions on the dashboard configuration page. See @dotnet/aspire/pull/8396 for details

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

---

Internal previews

📄 File	🔗 Preview link
docs/fundamentals/dashboard/configuration.md	docs/fundamentals/dashboard/configuration

[Copilot]

Pull Request Overview

This PR documents the new ClaimActions configuration feature for the Aspire dashboard's OpenID Connect authentication. The documentation explains how users can map custom claims from their OpenID Connect identity provider's user info endpoint to the dashboard user's claims identity, which is particularly useful for role-based authentication scenarios.

Key changes include:

• Added comprehensive documentation for the ClaimActions configuration option
• Created a detailed "Claim actions" subsection with property reference and examples
• Updated the documentation date to reflect the current changes

[JamesNK]

@IEvangelist Documentation for a vNext feature. Can you review and merge into the next major release branch.