Aller au contenu

Administration locale : harness-admin

harness-admin est l'outil de l'exploitant qui a accès à la machine. Il fait les mêmes opérations que l'interface, l'API et le MCP, mais depuis le serveur, sans connexion web : c'est la voie de secours (compte verrouillé, TOTP perdu, premier compte à créer) et la voie d'automatisation (installation par profil).

Comment ça marche

docker exec -i <conteneur-web> harness-admin <commande>
  • La commande s'exécute dans le conteneur web ; elle ne s'ouvre sur aucun réseau, aucun port, aucun jeton.
  • Elle agit en tant que local:root : un super-admin traité comme un humain qui vient de se ré-authentifier. Les actions réservées aux humains (élargir des droits, approuver une demande) passent donc sans étape de plus.
  • Chaque appel est audité avec l'origine local (voir core.audit.query, filtre sub=local:root).
  • Pourquoi c'est sûr : pouvoir lancer une commande dans ce conteneur donne déjà accès à la clé maître et à la base. La CLI n'ajoute aucun pouvoir ; elle retire seulement le besoin d'un navigateur. Aucun jeton, aucune session web ne peut porter l'identité local:root.

Commandes

Commande Rôle
ops [filtre] Liste les opérations (nom, résumé).
op <nom> [--json '{…}'] Exécute une opération ; --json - lit les arguments sur l'entrée standard.
install <profil.yml> [--out FICHIER] [--dry-run] Applique un profil d'installation (voir Installation).
user create <nom> [--role R] [--display-name N] [--email E] [--password-env VAR] [--no-totp] [--out F] Crée un compte actif ; mot de passe et TOTP générés, montrés une fois. Une adresse --email est réputée vérifiée (pas de code).
user reset-password <nom> [--out F] Nouveau mot de passe généré ; sessions révoquées.
user reset-totp <nom> [--clear] [--out F] Nouveau secret TOTP (obligatoire pour un administrateur) ; --clear retire l'authentificateur d'un non-administrateur.

Sortie : du JSON sur la sortie standard. Code de sortie : 0 réussi, 1 l'opération ou le profil a échoué, 2 mauvaise utilisation. Avec --out, les identifiants générés vont dans un fichier lisible par vous seul (0600) et n'apparaissent pas à l'écran.

Cas typiques

Inviter un super-admin quand vous n'en avez qu'un. Depuis l'interface ou l'API, la demande reste « en attente » et personne ne peut l'approuver (l'auteur ne peut pas approuver sa propre demande). Depuis l'hôte :

docker exec -i web harness-admin op core.user.invite --json '{"username":"e2e-bot","role":"superadmin"}'

Le lien d'activation est affiché une fois. Une demande déjà bloquée se débloque aussi d'ici :

docker exec -i web harness-admin op core.rbac.pending.list --json '{}'
docker exec -i web harness-admin op core.rbac.pending.approve --json '{"id":"<identifiant>"}'

Authentificateur perdu. harness-admin user reset-totp salim affiche un nouveau secret (et son URI otpauth://) ; la personne se reconnecte avec son mot de passe et le nouveau code.

Mot de passe perdu. harness-admin user reset-password salim affiche un mot de passe généré ; à changer à la première connexion (Mon compte).

Créer un compte de test. harness-admin user create e2e-bot --role superadmin --out /data/bootstrap/e2e-bot.json.

À savoir

  • Les opérations core.local.user.* (celles derrière user create|reset-*) sont refusées à tout autre principal, y compris un super-admin connecté à l'interface.
  • Les secrets passés en argument (--json '{…}') sont visibles quelques instants dans la liste des processus du conteneur : préférez --json - ou --password-env.
  • Les opérations fournies par des plugins ne sont pas toutes disponibles ici (seul le socle est chargé) ; les opérations de plugins qui passent par la gateway (installation d'un plugin) fonctionnent.