Feature
core/random-password
A credential the target generates when it deploys, so no one authors it and no default ships for every reader of a catalog to know. The build cannot make the password: its output is identical for identical input and never carries a secret's value. So the FeatureRecipe renders a request instead — a generator resource naming the secret resource it fills — and the target draws the value at deploy time: a controller in a Kubernetes cluster, the random provider during a Terraform apply, Secrets Manager when a CloudFormation stack is created. The rendered output names the generator and the secret resource, and carries no value. It publishes the same locator core/referenced-secret publishes, the secret resource's name and the data key within it, so a consuming component references a generated credential exactly as it references one that already exists, and a slot selecting the credential family admits it. Where several components share one credential, attach core/random-password on one of them and core/referenced-secret, bound to k8s-existing-secret, on the others, with its origin set to the name this attachment publishes; pin that name with the name value so both attachments can be written from one parameter. Attaching core/random-password on each of them, or once at a scope that reaches them all, instead renders one request per component, and each request draws a different password. Realized on helm (through the External Secrets Operator, or through the kubernetes-secret-generator controller), on terraform and on cloudformation. The compose target has no generator, so a Release binding this Feature there halts for want of a realization; supply the credential with core/secret-value instead.
Proveniência
- Digest do conteúdo
- sha256:ed8a7528bc29b9397327cd33ca3cdac57d665c00dc4db06bba85a06eb0fd29b9
- Publicado
- 2026-11-10T10:17:21Z
- Identidade de assinatura
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Assinatura
- Oficialapplication/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:234dcd7f285e54a007e6995280210313ea3a00da3840df02804519ef9a8d4655
Referência nesta versão
oci://hub.aggrega.ai/feature/core/random-password:1.0.0- Aplica-se a
- —
- Entra em conflito com
- —
Parâmetros do programador
Valores que o programador define ao acoplar esta funcionalidade.
| Nome | Tipo | Predefinição | Obrigatório | Descrição |
|---|---|---|---|---|
| key | string | value | sim | The data key within the generated secret resource under which the password is written, and which a consumer reads. |
| name | string | — | não | The name of the secret resource the generator fills, honoured exactly as written. Supplied where another attachment must reference the same credential — core/referenced-secret bound to k8s-existing-secret, with its origin set to this name — so one parameter can feed both. Left unset, the name is derived from the component carrying the attachment and the attachment's own name, as the other credential realizations derive theirs. On helm it names the Secret and must be a valid Kubernetes object name; on terraform it names the random_password resource, with a dot folded to an underscore; on cloudformation it is the Secrets Manager secret's name, and its words, capitalised, form the resource's logical ID. |
| length | integer (min 8, max 128) | 32 | não | Length of the generated password, in characters. |
| symbols | boolean | false | não | Whether the generated password may contain punctuation. Off by default, because a password is often placed inside a connection string or URL, where a character such as @, / or : changes what the string means. Turned on, each realization uses its generator's own default punctuation set. |
Contrato de saída
Valores que esta funcionalidade publica para os consumidores.
| Nome | Tipo | Predefinição | Obrigatório | Descrição |
|---|---|---|---|---|
| name | string | — | não | The generated secret resource's locator: the Kubernetes Secret name on helm, the attachment's own module call on terraform, a reference resolving to the Secrets Manager secret's ARN on cloudformation. |
| key | string | — | não | The data key within the resource a consumer reads: the Kubernetes Secret data key on helm, the module output carrying the password on terraform, the JSON key within the secret string on cloudformation. |
Anotações
Nenhuma anotação declarada.
Relações
Arestas tipadas de e para outras entidades publicadas. Uma referência sem destino publicado é apresentada como uma aresta quebrada em vez de uma ligação.
Usa
Esta entidade não usa nada do catálogo.
Usado por
implementa
implementa
implementa
implementa