Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

QdrantAccessKey

qdrantaccesskeys.qdrant.io, short name qak, namespaced. A Qdrant RBAC token, signed with the cluster's API key and kept in a Secret.

Spec

FieldDefaultDescription
clusterRef.namerequiredA QdrantCluster with apiKey.jwtRbac: true. Immutable
clusterRef.namespaceown namespace
accessr or m, cluster-wide. Exclusive with collections
collections[]Up to 256, keyed by name. Exclusive with access
collections[].namerequiredCollection inside Qdrant
collections[].accessrequiredr, rw or prw
subjectunsetThe sub claim
ttlnever expiresLifetime such as 720h or 1h30m
renewBeforea third of ttlHow long before expiry a new token is written. Needs ttl
valueExists.collectionToken valid only while a matching point exists here
valueExists.matches[]One to 32 {key, value} pairs the point must carry
secretNamemetadata.nameSecret receiving the token. Immutable

Admission rules: exactly one of access and collections; renewBefore needs ttl; clusterRef and secretName cannot change.

Status

FieldMeaning
phasePending, Ready or Failed
secretRef.name, secretRef.keyWhere the token is; the key is token
issuedAt, expiresAt, renewAtTimeline of the current token
keyFingerprintFirst sixteen hex digits of the SHA-256 of the signing key
errorWhy the phase is not Ready
observedGenerationSpec generation the token reflects
conditions[Ready]TokenIssued, JwtRbacDisabled or ApiKeyMissing

Behavior

On create, spec update, operator start and once a minute: read the cluster, stay Pending when jwtRbac is off or it has no API key, read the API key, and re-issue when the phase is not Ready, the Secret is missing, the spec generation or key fingerprint changed, or renewAt has passed. The Secret is Opaque with keys token and url, lives in the access key's namespace, and is owned by the resource, so it is garbage-collected on delete. The token is an HS256 JWT with claims sub, exp, access and value_exists, each only when set.

Print columns: CLUSTER, ACCESS, PHASE, SECRET, EXPIRES, AGE.