dtoro
8ef17dba3d
The IONOS netbird VPS held two credentials in plaintext that were the last
holdouts from the homelab's sops+age secrets pattern:
- /root/turn-pass.txt (coturn long-term-credential password)
- PKCEAuthorizationFlow.ProviderConfig.ClientSecret inline in
/opt/management.json (Authentik OIDC client secret)
This commit moves both into sops-encrypted YAML in the repo and adds a render
command that recreates the VPS config files from templates + decrypted secrets:
* secrets/turn-shared-secret.yaml — encrypted `password: <coturn pwd>`
* secrets/netbird-authentik-oidc.yaml — encrypted `client_secret: <...>`
Both recipients = hubris + apps + republic-laptop (same 3 as hello.yaml).
* vps/turnserver.conf.tmpl + vps/management.json.tmpl — templates with
{{TURN_PASSWORD}} + {{AUTHENTIK_CLIENT_SECRET}} placeholders.
* bin/homelab new subcommand `render-vps-configs`:
- Decrypts both secrets locally (works on any recipient).
- Substitutes placeholders into templates.
- Diffs against current VPS state via ssh, prompts, applies atomically
(write `.new` then mv), restarts coturn + netbird-mgmt.
- --dry-run + -y flags. Hops through hubris when not running on hubris
itself, since VPS sshd is locked to hubris's pubkey.
* inventory.yaml adds the VPS as `kind: external` (new kind; reserved for
ssh-managed hosts that aren't homelab clients themselves — no age key,
no /opt/homelab-context). hosts/netbird-vps.yaml regenerated.
* SHARED_SECRETS list includes both new secrets so re-keys on enrollment
changes pick them up automatically.
After this lands + the 5-min sync propagates to hubris, run from hubris PVE
shell (or any client; hubris just skips the extra ssh hop):
homelab render-vps-configs --dry-run # see plan, no changes
homelab render-vps-configs -y # apply + restart services
Once verified working, the plaintext `/root/turn-pass.txt` should be deleted
on the VPS (the rendered /etc/turnserver.conf no longer needs it as a
reference).
66 lines
3.2 KiB
YAML
66 lines
3.2 KiB
YAML
# SOPS recipient rules.
|
|
#
|
|
# Each rule pins one or more age public keys as recipients for files matching
|
|
# the path_regex. The build_host_files.py generator doesn't read this file;
|
|
# `sops` does — to encrypt a new secret, run `sops -e secrets/<name>.yaml`
|
|
# from the repo root and SOPS will pick the matching rule below.
|
|
#
|
|
# To grant a secret to a new client: add their age public key (from
|
|
# inventory.yaml `hosts.<name>.age_pubkey`) to the relevant rule below, then
|
|
# run `sops updatekeys secrets/<name>.yaml` to re-encrypt without rotating
|
|
# the ciphertext payload.
|
|
#
|
|
# To revoke: remove the recipient from the relevant rule and run
|
|
# `sops updatekeys` (this is what `homelab client remove` calls). Past
|
|
# ciphertext the client already decrypted is not affected — rotate the
|
|
# underlying credential if compromise is suspected.
|
|
|
|
creation_rules:
|
|
- path_regex: ^secrets/hello\.yaml$
|
|
# The "hello" secret is encrypted to every enrolled client so the bootstrap
|
|
# decrypt test works for everyone. Add each new client's age_pubkey when
|
|
# they enrol; re-key with `sops updatekeys -y secrets/hello.yaml`.
|
|
age: >-
|
|
age1xkklkvnk5z0fsnh6cfgv70hy9ksfy8rdprwerzw4yk3p4p7cxcqs2yvpz6,
|
|
age1duyl8mkpgu80uv934dy8q7enqjms6yvdz264hme8uryuxmvvqesq6rusq0,
|
|
age1vf8h7s8mqsn2q5eadgpdupsj4mwn8zguc77d85ws3xj40sl9rgksx2rxw6
|
|
|
|
- path_regex: ^secrets/gitea-pat\.yaml$
|
|
# Write-scoped Gitea PAT (dtoro user). Same recipient list as hello.yaml
|
|
# since every enrolled client should be able to push (homelab client
|
|
# add/remove, wiki edits, etc.).
|
|
age: >-
|
|
age1xkklkvnk5z0fsnh6cfgv70hy9ksfy8rdprwerzw4yk3p4p7cxcqs2yvpz6,
|
|
age1duyl8mkpgu80uv934dy8q7enqjms6yvdz264hme8uryuxmvvqesq6rusq0,
|
|
age1vf8h7s8mqsn2q5eadgpdupsj4mwn8zguc77d85ws3xj40sl9rgksx2rxw6
|
|
|
|
- path_regex: ^secrets/gitea-tokens\.yaml$
|
|
# Workstations only.
|
|
age: >-
|
|
# placeholder — fill with age_pubkey of: republic-laptop, mac-mini, ludo-mini, hubris
|
|
|
|
- path_regex: ^secrets/webhook-hmacs\.yaml$
|
|
# LXCs that run a webhook receiver.
|
|
age: >-
|
|
# placeholder — fill with age_pubkey of: apps, caddy, claudio-bot, claudio-monitor host
|
|
|
|
- path_regex: ^secrets/turn-shared-secret\.yaml$
|
|
# coturn TURN long-term-credential password. Consumed by hubris (which
|
|
# renders /etc/turnserver.conf + /opt/management.json on the VPS via
|
|
# `homelab render-vps-configs`). Other recipients are convenience for
|
|
# operator debugging — only hubris's pubkey is strictly required.
|
|
age: >-
|
|
age1xkklkvnk5z0fsnh6cfgv70hy9ksfy8rdprwerzw4yk3p4p7cxcqs2yvpz6,
|
|
age1duyl8mkpgu80uv934dy8q7enqjms6yvdz264hme8uryuxmvvqesq6rusq0,
|
|
age1vf8h7s8mqsn2q5eadgpdupsj4mwn8zguc77d85ws3xj40sl9rgksx2rxw6
|
|
|
|
- path_regex: ^secrets/netbird-authentik-oidc\.yaml$
|
|
# Authentik OIDC client secret for the netbird-dashboard provider.
|
|
# Consumed by hubris to render /opt/management.json on the VPS
|
|
# (PKCEAuthorizationFlow.ProviderConfig.ClientSecret).
|
|
age: >-
|
|
age1xkklkvnk5z0fsnh6cfgv70hy9ksfy8rdprwerzw4yk3p4p7cxcqs2yvpz6,
|
|
age1duyl8mkpgu80uv934dy8q7enqjms6yvdz264hme8uryuxmvvqesq6rusq0,
|
|
age1vf8h7s8mqsn2q5eadgpdupsj4mwn8zguc77d85ws3xj40sl9rgksx2rxw6
|
|
# webhook noop 2026-05-20T18:16:57+02:00
|