From 165dc5b9cbf4d47cee838855756faf12f2c18846 Mon Sep 17 00:00:00 2001 From: decentral1se Date: Wed, 9 Mar 2022 12:34:06 +0100 Subject: [PATCH] document length hack --- docs/maintainers/handbook.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/maintainers/handbook.md b/docs/maintainers/handbook.md index c3482c94..ece15bea 100644 --- a/docs/maintainers/handbook.md +++ b/docs/maintainers/handbook.md @@ -443,3 +443,22 @@ If you want to get the highest rating on SSL certs, you can use the following tr ``` See [this PR](https://git.coopcloud.tech/coop-cloud/traefik/pulls/8/files) for the technical details + +## Tweaking secret generation length + +It is possible to tell `abra` which length it should generate secrets with from your recipe config. + +You do this by adding a inline comment to the secret definition in the `.env.sample` / `.env` file. + +Here are examples from the gitea recipe: + +``` +SECRET_INTERNAL_TOKEN_VERSION=v1 # length=105 +SECRET_JWT_SECRET_VERSION=v1 # length=43 +SECRET_SECRET_KEY_VERSION=v1 # length=64 +``` + +When using this length specifier, `abra` will not use the "easy to remember +word" styl generator but instead a string of chars to match the exact length. +This can be useful if you have to generate "key" style values instead of +passwords which admins have to type out in database shells.