Secrets engine resources · Kind catalogue · Examples
PKIIssuer¶
API version: secrets.openbaoconfig.io/v1alpha1
Scope: Namespaced
Resource: pkiissuers.secrets.openbaoconfig.io
Categories: openbao
Example:
spec:
connectionRef:
name: openbao
mountPath: pki-int
name: int-2026
type: intermediate
certificate:
commonName: Example Intermediate CA 2026
ttl: 43800h
signer:
issuerRef: {name: root-2026}Example¶
# Generates an EC P-384 root CA issuer inside OpenBao on the obco-pki-root mount.
apiVersion: secrets.openbaoconfig.io/v1alpha1
kind: PKIIssuer
metadata:
name: obco-root-2026
namespace: openbao-config
spec:
connectionRef:
kind: OpenBaoConnection
name: openbao
creationPolicy: CreateOrAdopt
deletionPolicy: Orphan
driftDetection: Enabled
mountPath: obco-pki-root
name: obco-root-2026
type: root
key:
source: internal
name: obco-root-2026-key
type: ec
bits: 384
certificate:
commonName: OBCO Sandbox Root CA 2026
altNames:
- root-ca.openbao-config.example.com
- pki@openbao-config.example.com
ipSANs:
- 192.0.2.10
uriSANs:
- spiffe://openbao-config.example.com/ca/root
otherSANs:
- 1.3.6.1.4.1.311.20.2.3;UTF8:root-ca@openbao-config.example.com
excludeCNFromSANs: true
ou:
- Platform
organization:
- OBCO Sandbox
country:
- DE
locality:
- Berlin
province:
- Berlin
streetAddress:
- Example Street 1
postalCode:
- "10115"
serialNumber: obco-root-2026
ttl: 87600h
notBeforeDuration: 30s
maxPathLength: 1
permittedDNSDomains:
- openbao-config.example.com
signatureBits: 384
usePSS: false
leafNotAfterBehavior: err
usage:
- issuing-certificates
- crl-signing
- ocsp-signing
manualChain:
- obco-root-2026
revocationSignatureAlgorithm: ECDSAWithSHA384
issuingCertificates:
- https://openbao.openbao-config.example.com/v1/openbao-config/obco-pki-root/issuer/obco-root-2026/der
crlDistributionPoints:
- https://openbao.openbao-config.example.com/v1/openbao-config/obco-pki-root/issuer/obco-root-2026/crl/der
ocspServers:
- https://openbao.openbao-config.example.com/v1/openbao-config/obco-pki-root/ocsp
enableAIAURLTemplating: false
---
apiVersion: secrets.openbaoconfig.io/v1alpha1
kind: PKIIssuer
metadata:
name: obco-int-2026
namespace: openbao-config
spec:
connectionRef:
name: openbao
deletionPolicy: Orphan
mountPath: obco-pki-int
type: intermediate
key:
source: exported
name: obco-int-2026-key
type: ec
bits: 256
privateKeyFormat: pkcs8
certificate:
commonName: OBCO Sandbox Intermediate CA 2026
organization:
- OBCO Sandbox
notAfter: "2031-01-01T00:00:00Z"
maxPathLength: 0
permittedDNSDomains:
- openbao-config.example.com
addBasicConstraints: false
signer:
issuerRef:
name: obco-root-2026
writeSecretRef:
name: obco-int-2026-private-key
leafNotAfterBehavior: truncate
usage:
- issuing-certificates
- crl-signing
enableAIAURLTemplating: true
issuingCertificates:
- "{{cluster_aia_path}}/issuer/{{issuer_id}}/der"
crlDistributionPoints:
- "{{cluster_aia_path}}/issuer/{{issuer_id}}/crl/der"
---
apiVersion: secrets.openbaoconfig.io/v1alpha1
kind: PKIIssuer
metadata:
name: obco-int-2026b
namespace: openbao-config
spec:
connectionRef:
name: openbao
mountPath: obco-pki-int
type: intermediate
key:
source: existing
existing:
keyRef:
name: obco-int-key
certificate:
commonName: OBCO Sandbox Intermediate CA 2026b
ttl: 43800h
signer:
mountPath: obco-pki-root
issuerName: obco-root-2026
On GitHub: pkiissuer.yaml, generated sample with every field.
Behaviour and permissions¶
Create the PKI mount before the issuer. Root generation, intermediate signing and importing an existing certificate are different workflows; choose the issuer type and key source explicitly.
An internally generated private key stays in OpenBao. With an exported key, configure the output Secret before creation: private-key delivery is part of successful reconciliation. Losing a CR's status must not be treated as permission to generate a replacement CA.
The default Orphan keeps the issuer when its CR is deleted. Delete also requires the
destructive-delete annotation. Deleting a parent mount or OpenBao namespace destroys its CA
material regardless of the issuer's retention policy.
Ready confirms the issuer workflow and managed configuration; it does not prove an application trusts the chain. Verify certificate issuance and trust separately. Grant permissions only for the chosen generation/import, issuer configuration and signing paths; a signer may need a separate connection. See the PKI guide and the operator policy reference for the full workflow.
Fields¶
Defaults below are CRD schema defaults. A blank cell does not imply zero, false or an empty value; see the field description for omission behaviour. Required fields inside an optional object apply only when that object is set.
| Field | Type | Required | Default | Description | Validation |
|---|---|---|---|---|---|
spec | object | yes | spec is the desired CA issuer of a PKI secrets engine at `<mountPath>/issuer/<name>`. A root issuer is generated and self-signed. An intermediate issuer gets a CSR generated in its mount, signed by the signer issuer, and the signed certificate imported back. The certificate is created once; afterwards only the issuer settings (usage, chain, URLs and so on) are reconciled. | ConstraintsCEL:has(self.mountPath) == has(oldSelf.mountPath) && (!has(self.mountPath) || self.mountPath == oldSelf.mountPath) (mountPath is immutable)CEL: has(self.name) == has(oldSelf.name) && (!has(self.name) || self.name == oldSelf.name) (name is immutable)CEL: self.type == oldSelf.type (type is immutable)CEL: has(self.key) == has(oldSelf.key) && (!has(self.key) || self.key == oldSelf.key) (key is immutable)CEL: self.certificate == oldSelf.certificate (certificate is immutable; create a new PKIIssuer to rotate the CA)CEL: has(self.signer) == has(oldSelf.signer) && (!has(self.signer) || self.signer == oldSelf.signer) (signer is immutable)CEL: (self.type == 'intermediate') == has(self.signer) (signer is required for an intermediate and not allowed for a root)CEL: self.type == 'intermediate' || !has(self.certificate.addBasicConstraints) (certificate.addBasicConstraints applies only to an intermediate)CEL: (has(self.key) && self.key.?source.orValue('') == 'exported') == has(self.writeSecretRef) (writeSecretRef is required with key source exported and allowed only there)CEL: self.?name.orValue('') != 'default' (default is a reserved issuer name)CEL: !has(self.revocationSignatureAlgorithm) || self.?key.?source.orValue('internal') in ['existing', 'kms'] || (self.?key.?type.orValue('rsa') == 'rsa' ? self.revocationSignatureAlgorithm.contains('RSA') : self.?key.?type.orValue('rsa') == 'ec' ? self.revocationSignatureAlgorithm.startsWith('ECDSA') : self.?key.?type.orValue('rsa') == 'ed25519' ? self.revocationSignatureAlgorithm == 'Ed25519' : self.revocationSignatureAlgorithm.startsWith('MLDSA')) (revocationSignatureAlgorithm must match key.type (rsa by default): an RSA algorithm for rsa, ECDSA for ec, Ed25519 for ed25519, MLDSA for mldsa)CEL: !self.?enableAIAURLTemplating.orValue(false) || has(self.issuingCertificates) || has(self.crlDistributionPoints) || has(self.ocspServers) (enableAIAURLTemplating requires at least one of issuingCertificates, crlDistributionPoints and ocspServers; OpenBao drops it otherwise)CEL: has(self.__namespace__) == has(oldSelf.__namespace__) && (!has(self.__namespace__) || self.__namespace__ == oldSelf.__namespace__) (namespace is immutable)CEL: self.connectionRef == oldSelf.connectionRef (connectionRef is immutable) | |
spec.certificate | object | yes | certificate holds the subject and constraints of the issuer certificate. Immutable: create a new PKIIssuer to rotate the CA. | ConstraintsCEL:!has(self.ttl) || !has(self.notAfter) (set at most one of ttl and notAfter) | |
spec.certificate.addBasicConstraints | boolean | no | addBasicConstraints adds a CA basic constraints extension to the CSR of an intermediate (`add_basic_constraints`), for compatibility with Active Directory Certificate Services. Intermediate only. Defaults to false. | ||
spec.certificate.altNames | []string | no | altNames are DNS names and email addresses added as subject alternative names (`alt_names`). Example: `[ca.example.com]`. | Constraintsitems: <=64list type: atomic each item: pattern: ^[^,]+$each item: length: <=256 | |
spec.certificate.commonName | string | yes | commonName is the common name of the issuer certificate (`common_name`). Example: `Example Intermediate CA 2026`. | Constraintslength: >=1, <=256 | |
spec.certificate.country | []string | no | country is the country of the subject (`country`). Example: `[DE]`. | Constraintsitems: <=16list type: atomic each item: length: <=256 | |
spec.certificate.excludeCNFromSANs | boolean | no | excludeCNFromSANs keeps the common name out of the subject alternative names (`exclude_cn_from_sans`). Defaults to false. | ||
spec.certificate.ipSANs | []string | no | ipSANs are IP addresses added as subject alternative names (`ip_sans`). Example: `[10.0.0.10]`. | Constraintsitems: <=64list type: atomic each item: length: <=64 | |
spec.certificate.locality | []string | no | locality is the locality (city) of the subject (`locality`). Example: `[Berlin]`. | Constraintsitems: <=16list type: atomic each item: length: <=256 | |
spec.certificate.maxPathLength | integer (int32) | no | maxPathLength limits the number of intermediate CAs below this one (`max_path_length`); -1 means no limit. Defaults to -1. Example: `0`. | Constraintsvalue: >=-1 | |
spec.certificate.notAfter | string | no | notAfter sets the expiry of the certificate as a UTC timestamp (`not_after`). Example: `2036-01-01T00:00:00Z`. | Constraintspattern:^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$ | |
spec.certificate.notBeforeDuration | string | no | notBeforeDuration backdates the certificate's not-before time (`not_before_duration`), a duration. Defaults to `30s`. | Constraintspattern:^(0|([0-9]+(\.[0-9]+)?(ns|us|ms|s|m|h))+)$ | |
spec.certificate.organization | []string | no | organization is the organization of the subject (`organization`). Example: `[Example Corp]`. | Constraintsitems: <=16list type: atomic each item: length: <=256 | |
spec.certificate.otherSANs | []string | no | otherSANs are custom subject alternative names in the form `<oid>;<type>:<value>` (`other_sans`). Example: `["1.3.6.1.4.1.311.20.2.3;UTF8:ca@example.com"]`. | Constraintsitems: <=64list type: atomic each item: length: <=512 | |
spec.certificate.ou | []string | no | ou is the organizational unit of the subject (`ou`). Example: `[Platform]`. | Constraintsitems: <=16list type: atomic each item: length: <=256 | |
spec.certificate.permittedDNSDomains | []string | no | permittedDNSDomains restricts the DNS names of certificates issued below this CA (`permitted_dns_domains`). Example: `[example.com]`. | Constraintsitems: <=64list type: atomic each item: length: <=256 | |
spec.certificate.postalCode | []string | no | postalCode is the postal code of the subject (`postal_code`). Example: `["10115"]`. | Constraintsitems: <=16list type: atomic each item: length: <=256 | |
spec.certificate.province | []string | no | province is the province (state) of the subject (`province`). Example: `[Berlin]`. | Constraintsitems: <=16list type: atomic each item: length: <=256 | |
spec.certificate.serialNumber | string | no | serialNumber is the subject's serialNumber attribute, not the certificate serial number (`serial_number`). Example: `CA-0001`. | Constraintslength: <=256 | |
spec.certificate.signatureBits | integer (int32) | no | signatureBits selects the hash of the self-signature (root) or the CSR signature (intermediate) (`signature_bits`). Allowed: 256, 384, 512. Unset lets OpenBao pick one from the key. | Constraintsone of:256, 384, 512 | |
spec.certificate.streetAddress | []string | no | streetAddress is the street address of the subject (`street_address`). Example: `[Main Street 1]`. | Constraintsitems: <=16list type: atomic each item: length: <=256 | |
spec.certificate.ttl | string | no | ttl is the validity period of the certificate (`ttl`), a duration bounded by the mount's max lease TTL. Example: `43800h`. | Constraintspattern:^(0|([0-9]+(\.[0-9]+)?(ns|us|ms|s|m|h))+)$ | |
spec.certificate.uriSANs | []string | no | uriSANs are URIs added as subject alternative names (`uri_sans`). Example: `[spiffe://example.com/ca]`. | Constraintsitems: <=64list type: atomic each item: length: <=512 | |
spec.certificate.usePSS | boolean | no | usePSS signs with RSASSA-PSS instead of PKCS#1 v1.5 for rsa keys (`use_pss`). Defaults to false. | ||
spec.connectionRef | object | yes | Connection used to reach and log in to OpenBao. Immutable. | ||
spec.connectionRef.kind | string | no | "OpenBaoConnection" | Kind of the connection: OpenBaoConnection (in the same Kubernetes namespace as this resource) or ClusterOpenBaoConnection (cluster-scoped; its allowedNamespaces must select this namespace). Default: OpenBaoConnection. | Constraintsone of:OpenBaoConnection, ClusterOpenBaoConnection |
spec.connectionRef.name | string | yes | Name of the OpenBaoConnection or ClusterOpenBaoConnection. Example: openbao | Constraintslength: >=1, <=253 | |
spec.creationPolicy | string | no | "Create" | How an object that already exists in OpenBao, and is not yet owned by this resource, is treated. Create (default): create the object; an existing one is refused with reason Conflict. Adopt: take over an existing object and never create one. CreateOrAdopt: create it, or take over an existing one. Settings that always exist in OpenBao (configuration singletons) need Adopt or CreateOrAdopt. | Constraintsone of:Create, Adopt, CreateOrAdopt |
spec.crlDistributionPoints | []string | no | crlDistributionPoints are the CRL URLs of this issuer (`crl_distribution_points`), overriding the mount's config. Example: `[https://openbao.example.com/v1/pki-int/issuer/int-2026/crl/der]`. | Constraintsitems: <=16list type: atomic each item: length: <=1024 | |
spec.deletionPolicy | string | no | "Orphan" | What happens in OpenBao when this resource is deleted. Orphan (default): the OpenBao object stays. Delete: the object is removed (a configuration singleton is reset to its defaults); data and key holders (mounts, namespaces, KV data, audit devices, endpoints, transit, PKI, SSH CA and TOTP keys, MFA methods, entities) are removed only while the resource carries the annotation openbaoconfig.io/allow-destructive-delete: "true". Kinds whose OpenBao object cannot be deleted reject Delete. | Constraintsone of:Delete, Orphan |
spec.driftDetection | string | no | "Enabled" | Whether OpenBao is re-read periodically to detect and repair out-of-band changes. Enabled (default): re-read every driftInterval. Disabled: write only when the spec or a referenced Secret changes. | Constraintsone of:Enabled, Disabled |
spec.driftInterval | string | no | How often OpenBao is re-read for drift, as a duration of at least 30s. Default: the operator's interval for the kind (15m for kinds that grant access such as policies, auth mounts and roles, 1h for the rest), with jitter. Example: 30m | Constraintslength: <=32CEL: duration(self) >= duration('30s') (driftInterval must be at least 30s) | |
spec.enableAIAURLTemplating | boolean | no | enableAIAURLTemplating allows `{{cluster_path}}`, `{{cluster_aia_path}}` and `{{issuer_id}}` in the URLs above (`enable_aia_url_templating`); requires at least one of them, because OpenBao keeps it only with an AIA URL. Defaults to false. | ||
spec.issuingCertificates | []string | no | issuingCertificates are the AIA URLs of this issuer's certificate (`issuing_certificates`), overriding the mount's config. Example: `[https://openbao.example.com/v1/pki-int/issuer/int-2026/der]`. | Constraintsitems: <=16list type: atomic each item: length: <=1024 | |
spec.key | object | no | key describes the issuer's private key. Defaults to a new internal rsa key. Immutable. | ConstraintsCEL:self.?source.orValue('internal') == 'existing' ? (has(self.existing) && !has(self.name) && !has(self.type) && !has(self.bits)) : !has(self.existing) (existing is required with source existing and excludes name, type and bits)CEL: (self.?source.orValue('internal') == 'kms') == has(self.externalKeyRef) (externalKeyRef is required with source kms and allowed only there)CEL: self.?source.orValue('internal') != 'kms' || (!has(self.type) && !has(self.bits)) (type and bits come from the external key with source kms)CEL: !has(self.privateKeyFormat) || self.?source.orValue('internal') == 'exported' (privateKeyFormat applies only to source exported) | |
spec.key.bits | integer (int32) | no | bits is the size of a newly created key (`key_bits`): 2048, 3072, 4096 or 8192 for rsa; 224, 256, 384 or 521 for ec; 44, 65 or 87 for mldsa; unused for ed25519. Defaults to 2048 for rsa and 256 for ec. Example: `384`. | Constraintsone of:44, 65, 87, 224, 256, 384, 521, 2048, 3072, 4096, 8192 | |
spec.key.existing | object | no | existing selects the stored key to reuse when source is existing (`key_ref`). Example: `{keyRef: {name: int-2026}}`. | ConstraintsCEL:has(self.keyName) != has(self.keyRef) (set exactly one of keyName and keyRef) | |
spec.key.existing.keyName | string | no | keyName is the name or ID of the key in OpenBao. Example: `int-2026`. | Constraintslength: >=1, <=128 | |
spec.key.existing.keyRef | object | no | keyRef names a PKIKey in the same namespace and PKI mount; it must be Ready. Example: `{name: int-2026}`. | ||
spec.key.existing.keyRef.name | string | yes | Name of the referenced object, in the same namespace as this resource. Example: my-app | Constraintslength: >=1, <=253 | |
spec.key.externalKeyRef | string | no | externalKeyRef is the OpenBao external key used when source is kms; required there and allowed only there. Example: `hsm-pki-key`. | Constraintslength: >=1, <=512 | |
spec.key.name | string | no | name is given to a newly created key in OpenBao (`key_name`). Not allowed with source existing. Example: `int-2026`. | Constraintspattern:^[A-Za-z0-9_]([A-Za-z0-9_.-]*[A-Za-z0-9_])?$length: <=128 | |
spec.key.privateKeyFormat | string | no | privateKeyFormat is the format of an exported key (`private_key_format`): `der` writes a PKCS#1 or SEC1 PEM key, `pkcs8` a PKCS#8 PEM key. Source exported only. Defaults to der. | Constraintsone of:der, pkcs8 | |
spec.key.source | string | no | "internal" | source is `internal` (the key never leaves OpenBao), `exported` (also written once to writeSecretRef), `existing` (a key already stored in the mount) or `kms` (an OpenBao external key). Defaults to internal. | Constraintsone of:internal, exported, existing, kms |
spec.key.type | string | no | type is the algorithm of a newly created key (`key_type`). Allowed: rsa, ec, ed25519, mldsa. Defaults to rsa. Example: `ec`. | Constraintsone of:rsa, ec, ed25519, mldsa | |
spec.leafNotAfterBehavior | string | no | leafNotAfterBehavior controls a leaf whose expiry would exceed the issuer's (`leaf_not_after_behavior`): `err` rejects it, `truncate` shortens it, `permit` allows it. Defaults to err. | Constraintsone of:err, truncate, permit | |
spec.managementPolicy | string | no | "Manage" | Whether the operator writes to OpenBao. Manage (default): converge OpenBao to the spec, create and delete as the policies say. Observe: only read the object and report drift in the conditions; never write or delete. | Constraintsone of:Manage, Observe |
spec.manualChain | []string | no | manualChain overrides the computed CA chain with issuer names or IDs (`manual_chain`); the first entry must be this issuer. Example: `[int-2026, root-2026]`. | Constraintsitems: <=16list type: atomic each item: length: >=1, <=128 | |
spec.mountPath | string | no | "pki" | mountPath is the path of the PKI secrets engine mount. Defaults to `pki`. Immutable. Example: `pki-int`. | Constraintspattern:^[A-Za-z0-9_.-]+(/[A-Za-z0-9_.-]+)*$length: <=128 |
spec.name | string | no | name is the issuer name in OpenBao (`issuer_name`). Defaults to metadata.name; `default` is reserved. Immutable. Example: `int-2026`. | Constraintspattern:^[A-Za-z0-9_]([A-Za-z0-9_.-]*[A-Za-z0-9_])?$length: >=1, <=128 | |
spec.namespace | string | no | OpenBao namespace of the object, relative to the connection's base namespace; empty means the connection namespace itself. Segments are separated by "/", without leading or trailing slash. Immutable: it cannot be added, changed or removed after creation. Example: team-a/apps | Constraintspattern:^[A-Za-z0-9_-][A-Za-z0-9._-]*(/[A-Za-z0-9_-][A-Za-z0-9._-]*)*$length: <=256 | |
spec.ocspServers | []string | no | ocspServers are the OCSP URLs of this issuer (`ocsp_servers`), overriding the mount's config. Example: `[https://openbao.example.com/v1/pki-int/ocsp]`. | Constraintsitems: <=16list type: atomic each item: length: <=1024 | |
spec.revocationSignatureAlgorithm | string | no | revocationSignatureAlgorithm is the signature algorithm for CRLs and OCSP responses (`revocation_signature_algorithm`). Unset derives it from the key. Example: `ECDSAWithSHA384`. | Constraintsone of:SHA256WithRSA, SHA384WithRSA, SHA512WithRSA, ECDSAWithSHA256, ECDSAWithSHA384, ECDSAWithSHA512, SHA256WithRSAPSS, SHA384WithRSAPSS, SHA512WithRSAPSS, Ed25519, MLDSA44, MLDSA65, MLDSA87 | |
spec.signer | object | no | signer selects the issuer that signs an intermediate; it may be in another PKI mount. Required for an intermediate, not allowed for a root. Immutable. | ConstraintsCEL:has(self.issuerName) != has(self.issuerRef) (set exactly one of issuerName and issuerRef)CEL: !has(self.mountPath) || has(self.issuerName) (mountPath applies only to issuerName; issuerRef takes the mount from the PKIIssuer) | |
spec.signer.issuerName | string | no | issuerName is the name or ID of the signing issuer in OpenBao. Example: `root-2026`. | Constraintslength: >=1, <=128 | |
spec.signer.issuerRef | object | no | issuerRef names a PKIIssuer in the same namespace that signs this intermediate; it must be Ready. Its mount is taken from it. Example: `{name: root-2026}`. | ||
spec.signer.issuerRef.name | string | yes | Name of the referenced object, in the same namespace as this resource. Example: my-app | Constraintslength: >=1, <=253 | |
spec.signer.mountPath | string | no | mountPath is the PKI mount that holds the signing issuer named by issuerName. Defaults to the mount of this issuer; not allowed with issuerRef. Example: `pki-root`. | Constraintspattern:^[A-Za-z0-9_.-]+(/[A-Za-z0-9_.-]+)*$length: <=128 | |
spec.type | string | yes | type is `root` for a self-signed CA or `intermediate` for a CA signed by another issuer. Immutable. | Constraintsone of:root, intermediate | |
spec.usage | []string | no | usage lists what the issuer may do (`usage`): read-only, issuing-certificates, crl-signing, ocsp-signing; read-only is always added. Defaults to every usage. Example: `[issuing-certificates, crl-signing]`. | Constraintsitems: <=4list type: set each item: one of: read-only, issuing-certificates, crl-signing, ocsp-signing | |
spec.writeSecretRef | object | no | writeSecretRef names the Secret that receives the private key once, when key.source is exported; required there and allowed only there. The Secret is owned by this resource and holds the keys `private_key` and `private_key_type`; never stored in status. Example: `{name: int-ca-key}`. | ||
spec.writeSecretRef.name | string | yes | Name of the referenced object, in the same namespace as this resource. Example: my-app | Constraintslength: >=1, <=253 | |
status | object | no | status is the observed state of the issuer; `id` holds the OpenBao issuer ID. | ||
status.acquired | string | no | How the operator came to own the object: Created (it created it) or Adopted (it took over an existing one). Empty until owned. | ||
status.conditions | []object | no | Current state as conditions: Ready (the OpenBao object matches the spec) and Synced (the last reconcile succeeded), each with a reason such as Available, Drifted, Conflict, ConnectionNotReady or PermissionDenied, and the generation it describes. | Constraintslist type: map (keys: type) | |
status.conditions[] | object | no | Condition contains details for one aspect of the current state of this API Resource. | ||
status.conditions[].lastTransitionTime | string (date-time) | yes | lastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable. | ||
status.conditions[].message | string | yes | message is a human readable message indicating details about the transition. This may be an empty string. | Constraintslength: <=32768 | |
status.conditions[].observedGeneration | integer (int64) | no | observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance. | Constraintsvalue: >=0 | |
status.conditions[].reason | string | yes | reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty. | Constraintspattern:^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$length: >=1, <=1024 | |
status.conditions[].status | string | yes | status of the condition, one of True, False, Unknown. | Constraintsone of:True, False, Unknown | |
status.conditions[].type | string | yes | type of condition in CamelCase or in foo.example.com/CamelCase. | Constraintspattern:^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$length: <=316 | |
status.csr | string | no | csr is the PEM certificate signing request of an intermediate while it waits to be signed. | ||
status.id | string | no | Identifier OpenBao generated for the object (an entity, group or alias ID, or a mount accessor), for kinds that have one; other resources reference it. Example: 6c9f3e0a-1b2c-4d5e-8f90-123456789abc | ||
status.keyID | string | no | keyID is the OpenBao ID of the issuer's private key. | ||
status.namespace | string | no | Absolute OpenBao namespace the object was written in; empty means the root namespace. If it later differs from the spec, reconciling stops with reason NamespaceChanged. Example: team-a/apps | ||
status.observedGeneration | integer (int64) | no | The metadata.generation of this resource that the operator last reconciled. | ||
status.path | string | no | Full OpenBao API path of the object, including its namespace, as last written; deletion uses it even after the spec changed. Example: team-a/sys/policies/acl/app-read | ||
status.rotationNonce | string | no | Value of the resource's rotation nonce when one-time inputs, such as a root credential that OpenBao rotates afterwards, were last sent; changing the nonce in the spec sends them again. | ||
status.serverID | string | no | Cluster ID of the OpenBao server the object was acquired on. If the connection later reaches another server, reconciling stops with reason ServerChanged and nothing is written or deleted. Example: 80f7de92-c12e-e960-4754-255c32fc6b53 | ||
status.writeOnlyHash | string | no | Keyed hash (HMAC-SHA256) of the write-only inputs, such as passwords read from Secrets; a change forces a write. It never contains or reveals the values. |