clusterlogs/content/manuales/primer-administrador.md

+++ title = "Registrar al primer administrador" description = "Inicialización segura del registro de identidad de clusterlog." date = 2026-08-12T00:00:00Z authors = ["sistema"] slug = "registrar-primer-administrador" template = "page.html" weight = 10

[taxonomies] categories = ["manuales"] tags = ["identidad", "ssh", "inicio"] systems = ["bitacora"]

[extra] id = "RUN-DEMO-001" kind = "manuales" author_id = "sistema" author_fingerprint = "" +++

Prerrequisitos

• Una llave SSH personal con su archivo público disponible.
• Git inicializado en la raíz del proyecto.
• El binario clusterlog compilado.

Procedimiento

git init
make build
./bin/clusterlog --ssh-key ~/.ssh/id_ed25519 --commit admin add \
  --id ana --name "Ana Operadora" --email ana@example.org

El primer administrador recibe automáticamente el rol owner. Después, sólo un owner activo puede registrar a otra persona.

Verificación

./bin/clusterlog --ssh-key ~/.ssh/id_ed25519.pub identity
./bin/clusterlog validate --skip-zola
git log --show-signature -1

Bonus: registrar al segundo administrador

Sólo un owner activo puede hacer esto — corra el comando con su propia llave (la del primer administrador, ya registrado arriba), nunca con la del segundo.

Prerrequisitos

• Usted ya es owner activo (procedimiento anterior completado).
• El segundo administrador ya tiene su propia llave SSH y le compartió únicamente el archivo público (.pub) — nunca la privada.

Procedimiento

./bin/clusterlog --ssh-key ~/.ssh/id_ed25519.pub --commit admin add \
  --id beto --name "Beto Salazar" --email beto@example.org \
  --key /ruta/a/la/llave/del-segundo-administrador.pub \
  --roles admin

Use --roles owner,admin sólo si el segundo administrador también debe poder registrar administradores futuros; de lo contrario, admin alcanza.

Verificación

./bin/clusterlog --json admin list --active
git log --show-signature -1

• admin list --active muestra a ambos administradores.

• Desde su propia máquina, el segundo administrador confirma su propia identidad:

  ./bin/clusterlog --ssh-key ~/.ssh/id_ed25519.pub identity
  

data/admins.json y config/allowed_signers se actualizan juntos en el mismo commit — no hace falta un paso aparte para autorizar sus futuras firmas.