Skip to content

[docs] Clarify OTLP API key values must not be empty - #1720

Closed
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.6from
docs/pr-20363-35827904905-1-2efbba950d9cfa23
Closed

aspire-repo-bot[bot] wants to merge 1 commit into
release/13.6from
docs/pr-20363-35827904905-1-2efbba950d9cfa23

Conversation

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#20363

@JamesNK

Target branch

Targeting release/13.6 based on the source PR milestone 13.6.

Why this docs update is needed

microsoft/aspire#20363 changes OTLP API key authentication behavior in the Aspire dashboard:

  • The OTLP authentication handler now rejects an incoming request whose x-otlp-api-key header is empty, before performing the fixed-time key comparison against the primary/secondary key.
  • Dashboard options validation now requires that a configured Dashboard:Otlp:SecondaryApiKey not be an empty string when OTLP auth mode is ApiKey (it can still be left unset entirely).

This is a user-visible behavior change to an already-documented feature (Dashboard:Otlp:PrimaryApiKey / Dashboard:Otlp:SecondaryApiKey in the OTLP configuration table), so no automatic docs signal fired, but the docs needed updating to describe the new validation.

What changed

Updated src/frontend/src/content/docs/dashboard/configuration.mdx:

  • OTLP section intro paragraph now notes that an empty x-otlp-api-key header is always rejected, and that configuring an empty primary/secondary API key is invalid.
  • Dashboard:Otlp:PrimaryApiKey row: notes the value must not be an empty string.
  • Dashboard:Otlp:SecondaryApiKey row: notes that if configured, it must not be an empty string.

Files modified

  • src/frontend/src/content/docs/dashboard/configuration.mdx (updated)

Generated by PR Documentation Check for #20363 · copilot · auto · 38.9 AIC · ⌖ 17.1 AIC · ⊞ 18.7K · ◷

Documents PR microsoft/aspire#20363, which rejects empty OTLP primary/secondary API keys and empty incoming x-otlp-api-key headers.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@aspire-repo-bot aspire-repo-bot Bot added the docs-from-code Copilot initiated issue from dotnet/aspire repo label Sep 23, 2026
@aspire-repo-bot

Copy link
Copy Markdown
Contributor Author

Frontend HTML artifact ready

The latest frontend build uploaded the frontend-dist artifact for PR #1720. Use the VS Code button below to open this PR with GitHub Artifacts Explorer and browse the built HTML locally.

VS Code: Open PR #1720 artifacts

This comment updates automatically when a new frontend build artifact is uploaded.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-from-code Copilot initiated issue from dotnet/aspire repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants