Resources / SecretKey
SecretKey
The data key of one project, wrapped under the platform key. Made by the platform with the project's first secret; clients cannot create or change it. Deleting it destroys every secret of the project for good (crypto-erase), so it is refused while secrets exist.
Overview
| API | secrets.etorm.com/v1alpha1 |
| Resource | secretkeys (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: SecretKey
metadata:
name: example
spec: {}
Spec
| Field | Type | Required | Default | Allowed | Description |
rewrapRequestedAt | string | | | up to 64 characters | Change this string to wrap the data key again under the current platform key. The key operator does this after a platform key rotation. |
wrapped | object (free-form) | | | | Server-managed wrapped data keys. Never settable and never returned. |
Status
| Field | Type | Required | Default | Allowed | Description |
phase | string (one of) | | | Ready, Failed | Ready when the data key opens under the platform key. |
conditions | list of object | | | | Detailed state: Sealed, and KeyOperator (is the operator that rewraps the key after a platform key rotation registered and running). |
conditions[].type | string | | | | Aspect. |
conditions[].status | string | | | | True or False. |
conditions[].reason | string | | | | Machine-readable reason. |
conditions[].message | string | | | | Human-readable detail. |
conditions[].lastTransitionTime | string | | | | When the status last changed (RFC 3339). |
keyVersion | integer | | | | Version of the platform key the current wrapping uses. |
dataKeys | integer | | | | Number of data keys held (ids stay readable until no sealed version uses them). |
createdAt | string | | | | When the key was made (RFC 3339). |
rewrappedAt | string | | | | When it was last wrapped again (RFC 3339). |
secrets | integer | | | | Number of secrets in the project |
Columns in listings
| Column | From |
|---|
| KeyVersion | .status.keyVersion |
| DataKeys | .status.dataKeys |
| Phase | .status.phase |
All resources