OpenBaoTenant API

Fields, defaults, and validation for the OpenBaoTenant API.

Updated 9 August 2026 · 2 min read

On this page

Packages

openbao.org/v1alpha1

Package v1alpha1 contains API Schema definitions for the openbao v1alpha1 API group.

Resource Types

OpenBaoTenant

OpenBaoTenant is the Schema for the openbaotenants API. OpenBaoTenant is a governance CRD that explicitly declares which namespace should be provisioned with tenant RBAC. This replaces the previous label-based approach (openbao.org/tenant=true) to improve security by eliminating the need for the Provisioner to have list/watch permissions on namespaces.

FieldDescriptionDefaultValidation
apiVersion stringopenbao.org/v1alpha1
kind stringOpenBaoTenant
spec OpenBaoTenantSpec
status OpenBaoTenantStatus

OpenBaoTenantSpec

OpenBaoTenantSpec defines the desired state of OpenBaoTenant.

Appears in:

FieldDescriptionDefaultValidation
targetNamespace stringTargetNamespace is the name of the namespace to provision with tenant RBAC.
The Provisioner will create Role and RoleBinding resources in this namespace
to grant the OpenBaoCluster controller permission to manage OpenBaoCluster
resources in that namespace.
MinLength: 1
quota ResourceQuotaSpecQuota defines the resource quota to apply to the tenant namespace.Optional: {}
limitRange LimitRangeSpecLimitRange defines the limit range to apply to the tenant namespace.Optional: {}

OpenBaoTenantStatus

OpenBaoTenantStatus defines the observed state of OpenBaoTenant.

Appears in:

FieldDescriptionDefaultValidation
provisioned booleanProvisioned indicates if the RBAC has been successfully applied to the target namespace.Optional: {}
lastError stringLastError reports any issues finding the namespace or applying RBAC.Optional: {}
conditions Condition arrayConditions represent the latest available observations of the tenant’s state.Optional: {}

Search the handbook

Try “install”, “threat model”, or “compatibility”.