Cette page a été traduite automatiquement. Lire l’original en anglais.

Component

core/security/openbao

An OpenBao secrets-management server. OpenBao stores, generates, and controls access to tokens, passwords, certificates, and other secrets behind an authenticated HTTP API, and encrypts data at rest on a durable data volume — so it renders as a self-hosted, stateful running server, not a managed-cloud resource. Its operational type is therefore `stateful-server`: the deployment runs and owns the OpenBao process backed by a persistent volume. This component ships a single standalone server that keeps its state in the built-in file storage backend; highly-available, multi-node topologies are a future refinement not modelled here. OpenBao is initialized and unsealed at runtime inside the cluster — its root token and unseal keys are produced by the running server after it starts — so the component declares no credential slot and no secret is materialized at render time. Realized on Kubernetes through its Helm Recipe; it has no standalone local-container form, so no Compose Recipe is provided. Exports its API endpoint host and port to consumers via the uses topology. OpenBao is distributed under the MPL-2.0 license. With `values.metrics_enabled` true the Recipe turns on OpenBao's Prometheus telemetry and publishes its address as `metrics_endpoint`. A scrape presents an OpenBao token, best one whose policy grants read and list on sys/metrics and nothing else.

Provenance

OfficielSigné par une identité de signature que ce catalogue reconnaît comme éditeur officiel.
Empreinte du contenu
sha256:23c9c7fe8b974078b50334df9cd0a72089f9d6ae92c93cdc826439fb914da97b
Publié
2026-11-10T10:13:49Z
Identité de signature
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officielapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:f52d92728e93277b7e4fe852e6a2a331e14030515000abd0daa2f7495b42cd2c

Référence à cette version

oci://hub.aggrega.ai/component/core/security/openbao:1.0.0

Paramètres du développeur

Valeurs que le développeur définit dans l’Aggregate.

NomTypeValeur par défautObligatoireDescription
ui_enabledbooleantruenonWhether the OpenBao server serves its built-in web UI on the API endpoint. Leave on for interactive administration; set false to expose the HTTP API only.
metrics_enabledbooleanfalsenonTurns on OpenBao's own metrics, in the Prometheus format, at /v1/sys/metrics on the API port, and publishes their address as `metrics_endpoint`; while false that key is empty. Only an active server serves them, and only to a token whose policy grants read and list on sys/metrics.

Dimensionnement de l’opérateur

Dimensionnement de l’infrastructure que l’opérateur ajuste pour chaque environnement.

NomTypeValeur par défautObligatoireDescription
external_base_urlstring—nonExternally reachable base URL of the secrets API, as assembled at the ingress tier — for example https://secrets.example.com. The server advertises this as its own API address: the address it hands a client to be redirected to, and the one its plugin backends are given as the server's own. Omitted, the Recipe advertises the server's pod address, which is reachable only from inside the cluster.
source_versionstring—nonSource artifact version (Helm chart). Overrides the Recipe's default source version. Changing from default does not guarantee value mapping compatibility.
computeobject—non—
storageobject—non—
overridesobject (open)—nonProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Contrat de sortie

Valeurs que ce composant publie vers les consommateurs via la topologie uses.

NomTypeValeur par défautObligatoireDescription
hoststring—ouiIn-cluster DNS name of the Service fronting the secrets API. A consumer points its client's address at this name together with `port`.
portinteger—ouiTCP port that Service accepts API requests on. The realization serves the project's own default, so a consumer reads this rather than hard-coding one.
protocolstring—nonHow the published address is spoken to — `http`, the scheme a consumer composes its client address on.
metrics_endpointstring—nonThe full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:8200/v1/sys/metrics`, the host being the server's Service name. Empty while values.metrics_enabled is false. A scrape asks for the Prometheus format with the parameter format=prometheus.
metrics_credential_requiredboolean—nonWhether a scrape of `metrics_endpoint` must present a credential: true while values.metrics_enabled is true, because OpenBao answers its metrics only to a token, and false while no address is published. Present a token whose policy grants read and list on sys/metrics and nothing else, so the scraper reads the metrics and no secret.

Sockets uses

Les sockets de dépendance par lesquels ce composant se connecte. La cible de chaque connexion câblée via un socket doit satisfaire son sélecteur d’étiquettes, et chaque connexion peut porter une attache dans les emplacements que le socket déclare. Un emplacement obligatoire doit être rempli par chaque connexion que l’Aggregate ou la Release câble via le socket.

Aucun socket uses déclaré.

Emplacements d’attache

Points de liaison nommés auxquels une Feature s’attache à ce composant. Le sélecteur d’un emplacement restreint la Feature qui peut le remplir, et sa liste inject indique comment le matériel de la Feature peut être livré. Un emplacement obligatoire doit être lié sur chaque instance, par une attache sur l’instance ou à une portée supérieure, et un emplacement sensible est déclaré pour traiter du matériel secret. Une Feature peut aussi s’attacher sous un nom qu’aucun emplacement ne déclare.

Aucun emplacement d’attache déclaré.

Liste d’autorisation d’auto-injection

Aucun canal d’auto-injection déclaré.

Relations

Arêtes typées vers et depuis d’autres entités publiées. Une référence sans cible publiée s’affiche comme une arête rompue plutôt que comme un lien.

Utilise

Cette entité n’utilise rien du catalogue.

Utilisé par

Référence du concept Component →

Le catalogue Aggrega — un index ouvert de composants, de fonctionnalités, de recettes et des plugins qui en assurent le rendu.

Conçu avec le système de design partagé d’Aggrega.

Confidentialité