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
| API | secrets.etorm.com/v1alpha1 |
| Resource | secretbindings (cluster-scoped inside its cluster) |
| Short names | none |
| Available in | the platform and project clusters |
| Status | written 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
| Field | Type | Required | Default | Allowed | Description |
secretRef | object | yes | | | The secret. The writer needs the use right on it. |
secretRef.name | string | yes | | length 1 to 63 | Name of the Secret in this project. |
subject | object | yes | | | Who receives it. |
subject.principal | string | yes | | length 1 to 253 | The authenticated name of the principal, for example system:operator:cloud or serviceaccount:<project>:deployer. |
purpose | string | yes | | length 1 to 200 | Why it is delivered; shown in audit records. Never a value. |
keys | list of string | | | up to 32 items | Restrict delivery to these keys. Empty means all keys. |
expiresAt | string | | | up to 40 characters | When the binding ends (RFC 3339). Empty means it does not end. |
Status
| Field | Type | Required | Default | Allowed | Description |
phase | string (one of) | | | Active, Expired | Active until expiresAt. |
conditions | list of object | | | | Detailed state. |
conditions[].type | string | | | | Aspect. |
conditions[].status | string | | | | True or False. |
conditions[].reason | string | | | | Machine-readable reason. |
conditions[].message | string | | | | Human-readable detail. |
Columns in listings
| Column | From |
|---|
| Secret | .spec.secretRef.name |
| Principal | .spec.subject.principal |
| Phase | .status.phase |
All resources