Docs
Reference

OpenBao

Move secrets to and from one OpenBao KV v2 path.

Move secrets to and from one OpenBao KV v2 path.

The connection

WhatThis provider
VendorOpenBao
Keyopenbao-kv
Availabilityavailable. You can connect it today.
Credential penv holdsopenbao-token
Values read backyes
Activationimmediate

What it moves

DirectionWhat it does
importReads names and values out of the store into penv.
exportWrites names and values from penv into the store.

When a written value goes live

immediate. The running app sees a new value at once.

What happens to a name that exists

DirectionPolicies you can pick
importskip_existing, new_version, fail
exportcreate_only, overwrite, overwrite_and_prune

How syncs work says what each one does.

How you connect

You paste a credential you already hold. penv seals it and never shows it again.

FieldLabelKindRequiredWhat it is
tokenOpenBao tokensecret, masked here and sealedyesOpenBao tokens expire, exactly as Vault's do. Use one with a lease long enough for your sync schedule, and renew it.

What the connection asks for

Fixed when you connect, and shared by every mapping on it.

FieldLabelKindRequiredAdvancedWhat it is
addressVault addresstextyesnoMust be reachable from the public internet over HTTPS.
namespaceNamespacetextnoyesEnterprise and HCP only. Leave empty for open-source Vault.

What a mapping asks for

Answered once per environment you map.

FieldLabelKindRequiredAdvancedWhat it is
mountKV mounttextyesnoMust be a KV version 2 mount.
pathPathtextyesnoOne path per sync. Every key stored there is one secret here.

Permissions it needs

penv probes for these when it verifies the connection.

PermissionDirectionsBlockingWithout it
readimportyesImport cannot read the path.
createexportyesExport cannot write a path that does not exist yet.
patchexportyesExport cannot change a path without replacing everything else stored there.