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.
Походження
- Дайджест вмісту
- sha256:ed8a7528bc29b9397327cd33ca3cdac57d665c00dc4db06bba85a06eb0fd29b9
- Опубліковано
- 2026-11-10T10:17:21Z
- Ідентичність підписувача
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Підпис
- Офіційнийapplication/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
Посилання на цю версію
oci://hub.aggrega.ai/feature/core/random-password:1.0.0- Застосовується до
- —
- Конфліктує з
- —
Параметри розробника
Значення, які розробник задає під час приєднання цієї функції.
| Назва | Тип | Типове значення | Обов’язкове | Опис |
|---|---|---|---|---|
| key | string | value | так | The data key within the generated secret resource under which the password is written, and which a consumer reads. |
| name | string | — | ні | 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 | ні | Length of the generated password, in characters. |
| symbols | boolean | false | ні | 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. |
Вихідний контракт
Значення, які ця функція публікує для споживачів.
| Назва | Тип | Типове значення | Обов’язкове | Опис |
|---|---|---|---|---|
| name | string | — | ні | 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 | — | ні | 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. |
Анотації
Анотацій не оголошено.
Зв’язки
Типізовані ребра до інших опублікованих сутностей і від них. Відсилання без опублікованої цілі відображається як розірване ребро, а не як посилання.
Використовує
Ця сутність не використовує нічого з каталогу.
Використовується в
реалізує
реалізує
реалізує
реалізує