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(voircore.audit.query, filtresub=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èreuser 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.