Skip to content

docs: document native Kubernetes auth for HashiCorp Vault secret store - #5243

Merged
marcduiker merged 7 commits into
dapr:v1.19from
icmp0x8:feat/vault-kubernetes-auth-docs
Oct 15, 2026
Merged

marcduiker merged 7 commits into
dapr:v1.19from
icmp0x8:feat/vault-kubernetes-auth-docs

Conversation

@icmp0x8

@icmp0x8 icmp0x8 commented Jul 12, 2026

Copy link
Copy Markdown
Contributor

Please follow this checklist before submitting:

  • Commits are signed with Developer Certificate of Origin (DCO - learn more)
  • Read the contribution guide
  • Commands include options for Linux, MacOS, and Windows within tabpane
  • New file and folder names are globally unique
  • Page references use shortcodes instead of markdown or URL links
  • Images use HTML style and have alternative text
  • Places where multiple code/command options are given have tabpane

Description

Add a "Kubernetes authentication" section covering the new vaultAuthMethod: kubernetes option (native login via the pod's service account token, no Vault Agent Injector sidecar required), including the one-time Vault-side setup (enable the auth method, configure it, create a policy and role). Also documents the new vaultKubernetesRole, vaultKubernetesMountPath, and vaultServiceAccountTokenPath fields, and corrects vaultToken/vaultTokenMountPath from required to optional in the metadata table, since neither is required under kubernetes auth.

Relates to dapr/components-contrib#4104

Add a "Kubernetes authentication" section covering the new
vaultAuthMethod: kubernetes option (native login via the pod's service
account token, no Vault Agent Injector sidecar required), including
the one-time Vault-side setup (enable the auth method, configure it,
create a policy and role). Also documents the new vaultKubernetesRole,
vaultKubernetesMountPath, and vaultServiceAccountTokenPath fields, and
corrects vaultToken/vaultTokenMountPath from required to optional in
the metadata table, since neither is required under kubernetes auth.

Signed-off-by: Oleg Kuznetsov <71344093+icmp0x8@users.noreply.github.com>

@marcduiker marcduiker left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM

@marcduiker

Copy link
Copy Markdown
Contributor

Related PR in contrib: dapr/components-contrib#4448

@marcduiker marcduiker added the waiting-on-code-pr The code PR needs to be merged before the docs are updated label Jul 19, 2026
@JoshVanL JoshVanL added area/components and removed waiting-on-code-pr The code PR needs to be merged before the docs are updated labels Oct 7, 2026
@JoshVanL JoshVanL added this to the v1.19 milestone Oct 7, 2026
Explain that the Vault server, not the CLI host, determines how token review works, mention token rotation and the automount requirement, document that caPath loads every file in the folder, and fix the vaultToken placeholder.

Signed-off-by: Oleg Kuznetsov <71344093+icmp0x8@users.noreply.github.com>
@CasperGN CasperGN assigned CasperGN and unassigned CasperGN Oct 12, 2026
@CasperGN CasperGN self-assigned this Oct 15, 2026
@marcduiker
marcduiker merged commit 8aae248 into dapr:v1.19 Oct 15, 2026
5 checks passed
@marcduiker

Copy link
Copy Markdown
Contributor

@holopin-bot @icmp0x8 docs-badge Thank you! Here's a digital badge as a small token of appreciation.

@holopin-bot

holopin-bot Bot commented Oct 16, 2026

Copy link
Copy Markdown

Congratulations @icmp0x8, the maintainer of this repository has issued you a badge! Here it is: https://holopin.io/claim/cmvao58jh0003lf04tq0wyv5q

This badge can only be claimed by you, so make sure that your GitHub account is linked to your Holopin account. You can manage those preferences here: https://holopin.io/account.
Or if you're new to Holopin, you can simply sign up with GitHub, which will do the trick!

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants