Skip to main content
Version: 2.0.x (Latest)

Secret Provider Integrations

Provider selection​

Provider IDDeployment sectionRequired integration inputs
localvaultSecrets:Providers:LocalVaultEnabled local provider and persistent protected key ring.
hashicorpvaultSecrets:Providers:HashiCorpVaultEndpoint, mount, bootstrap token.
azurekeyvaultSecrets:Providers:AzureKeyVaultEndpoint and supported workload/client identity settings.
awssecretsSecrets:Providers:AwsSecretsRegion and supported web-identity/access-key settings.

Do not confuse provider IDs used in secret references with deployment-section casing.

Versioned references​

{"providerId":"azurekeyvault","secretPath":"inventory-api-token","version":"PROVIDER_VERSION","field":"value"}

The version must identify the intended provider material. Confirm the provider-specific interpretation before rotating production credentials.

Azure settings include Identity, ClientId, TenantId, and ClientSecret. AWS settings include Identity, AccessKey, SecretKey, and SessionToken. HashiCorp includes Mount and Token. Supply secret values through bootstrap configuration rather than embedding them in docs.

Dependency planning​

A provider may require bootstrap credentials before it can resolve later secrets. Declare supported tier dependencies and validate the plan. Cycles, duplicate destinations, invalid tiers, and unsupported providers are rejected.

The no-secrets mode and provider-enablement paths have specific validation behavior. Confirm the selected deployment plan rather than assuming LocalVault enablement alone satisfies every remote-provider configuration rule.

Test and rotate​

Resolve a non-production secret, create a scoped binding, and exercise an HTTPS target. Test expiry, revocation, and provider outage. Rotate through the supported binding rotation API with expected version.

A provider outage does not authorize indefinite cache use. Cache TTL, secret expiry, revocation, and outage policy remain relevant.

Was this helpful?