Skip to content

[v1.17] docs: Sentry Ed25519 workload identity keys#5187

Open
nelson-parente wants to merge 2 commits into
v1.17from
docs/sentry-ed25519-v1.17
Open

[v1.17] docs: Sentry Ed25519 workload identity keys#5187
nelson-parente wants to merge 2 commits into
v1.17from
docs/sentry-ed25519-v1.17

Conversation

@nelson-parente
Copy link
Copy Markdown
Contributor

Backport of #5181 to the v1.17 docs branch.

Even though Ed25519 workload keys are a Dapr 1.18 change, the docs are duplicated on v1.17 so users reading the v1.17 site see the same upgrade/downgrade guidance — specifically the 1.17.7 floor needed to read Ed25519 trust bundles after a 1.18 rollout/rollback.

Files touched

File Change
daprdocs/content/en/concepts/security-concept.md New "Workload identity key algorithm" subsection (algorithm comparison, FIPS callout, downgrade floor 1.17.7).
daprdocs/content/en/operations/security/mtls.md New top-of-page section pointing to the concept page; BYO-CA note.

Cherry-picked cleanly from bfc7a27 (the v1.18 squash-merge of #5181) — same 2 files, +43/-2.

Test plan

  • Hugo renders alerts and table without errors.
  • {{% ref "security-concept.md#workload-identity-key-algorithm" %}} resolves on v1.17.
  • {{% ref "mtls#bringing-your-own-certificates" %}} resolves.
  • No broken links.

Related

* sentry: document Ed25519 default workload identity keys

Sentry switched workload X.509 certificate key generation from ECDSA
P-256 to Ed25519 in Dapr 1.18 (dapr/dapr#9598).

Changes:
- concepts/security-concept.md: add 'Workload identity key algorithm'
  subsection under 'Secure Dapr to Dapr communication'. Covers what
  changed (default: Ed25519 for workload/CA certs, RSA for injector/
  operator webhook serving certs, RSA-2048 for JWT/OIDC unchanged),
  why (smaller keys/sigs, faster ops, cleaner curve design), mixed-
  version rolling-upgrade compatibility, FIPS callout (Ed25519 is not
  FIPS-140 approved; BYO-CA path is the workaround), and downgrade
  floor alert (1.17.7). Also updates stale 'ECDSA private key'
  sentence in the same section.
- operations/security/mtls.md: add 'Workload identity key algorithm'
  section at the top pointing to the concept page. Adds BYO-CA note
  explaining that supplied issuer key algorithm is what Sentry uses.
  Updates stale 'ECDSA PEM encoded' in self-hosted BYO-certs prose.
  Adds inline note on the Kubernetes openssl example clarifying that
  RSA keys are also accepted (relevant for FIPS environments).

Related: dapr/dapr#9873 (injector/operator RSA webhook certs —
tracked separately as gap R5).
Targets v1.18.

Signed-off-by: Nelson Parente <nelson_parente@live.com.pt>

* sentry: tighten Ed25519 workload identity docs (review pass)

Signed-off-by: Nelson Parente <nelson_parente@live.com.pt>

---------

Signed-off-by: Nelson Parente <nelson_parente@live.com.pt>
Co-authored-by: Mark Fussell <markfussell@gmail.com>
@github-actions
Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://ashy-coast-091fbe31e-5187.westus2.7.azurestaticapps.net

Copy link
Copy Markdown
Member

@msfussell msfussell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants