Resources / SecretBinding

SecretBinding

Names a principal (an operator, a node agent, a runner's service account) that may receive a secret through the reveal path. It grants nothing by itself, because the principal also needs the reveal right of the secret-revealer role. Two locks, both required.

Overview

APIsecrets.etorm.com/v1alpha1
Resourcesecretbindings (cluster-scoped inside its cluster)
Short namesnone
Available inthe platform and project clusters
Statuswritten by a controller through /status

Minimal example

apiVersion: secrets.etorm.com/v1alpha1
kind: SecretBinding
metadata:
  name: example
spec:
  secretRef:
    name: "<name>"
  subject:
    principal: "<principal>"
  purpose: "<purpose>"

Spec

FieldTypeRequiredDefaultAllowedDescription
secretRefobjectyesThe secret. The writer needs the use right on it.
secretRef.namestringyeslength 1 to 63Name of the Secret in this project.
subjectobjectyesWho receives it.
subject.principalstringyeslength 1 to 253The authenticated name of the principal, for example system:operator:cloud or serviceaccount:<project>:deployer.
purposestringyeslength 1 to 200Why it is delivered; shown in audit records. Never a value.
keyslist of stringup to 32 itemsRestrict delivery to these keys. Empty means all keys.
expiresAtstringup to 40 charactersWhen the binding ends (RFC 3339). Empty means it does not end.

Status

FieldTypeRequiredDefaultAllowedDescription
phasestring (one of)Active, ExpiredActive until expiresAt.
conditionslist of objectDetailed state.
conditions[].typestringAspect.
conditions[].statusstringTrue or False.
conditions[].reasonstringMachine-readable reason.
conditions[].messagestringHuman-readable detail.

Columns in listings

ColumnFrom
Secret.spec.secretRef.name
Principal.spec.subject.principal
Phase.status.phase

All resources