Contexte et problème d’identifiants
Antonio utilise plusieurs agents d’IA (Claude Code, Codex, etc.) qui s’exécutent sur des machines virtuelles jetables. Le laptop conserve les secrets critiques : clés SSH, coffre‑1Password et les CLI gh et cloud déjà authentifiés. Lorsque l’un de ces agents doit accéder à un secret, deux solutions classiques sont envisagées : copier le token dans ~/.config/gh/hosts.yml (exposé à tous les processus du VM) ou activer le forwarding ssh -A (les clés restent locales mais le VM peut les utiliser sans trace). Les deux approches violent le principe de moindre privilège et ne couvrent pas les appels API non‑SSH.
Fonctionnement de lend et architecture
Le projet lend agit comme un proxy placé devant l’agent SSH existant. L’utilisateur redirige la variable SSH_AUTH_SOCK vers le socket de lend, puis lance lend ssh --config ./policy.json -- agent-vm. Le trafic SSH continue de fonctionner, mais chaque requête d’opération (signature ou exécution de commande) transite par le proxy, qui interroge une politique locale avant d’appeler l’agent réel.
{
"default": "deny",
"commands": [
{"executable": "/opt/homebrew/bin/gh", "approval": "biometric:inline"}
],
"ssh": {
"default": "deny",
"keys": [
{"fingerprint": "SHA256:...", "approval": "biometric:inline"}
]
}
}Cette configuration JSON montre que, par défaut, tout est refusé. Seul gh et la clé spécifiée sont autorisés, et chaque appel nécessite une validation biométrique via Touch ID. Le proxy peut également filtrer par préfixe d’arguments, limitant ainsi les sous‑commandes autorisées.
Gestion des politiques et approbation biométrique
Lorsqu’un agent sur le VM demande gh repo view, lend transmet la requête au laptop où le dialogue apparaît : chemin complet, arguments, répertoire d’exécution et raison fournie par le VM. L’utilisateur valide avec Touch ID (mode biometric:inline) et le processus gh s’exécute localement. La sortie standard, l’erreur et le code de retour sont renvoyés au VM, préservant ainsi la confidentialité du token. Le champ reason est obligatoire, ce qui empêche les appels non documentés.
Le même mécanisme fonctionne sans le serveur MCP : lend exec --reason "Read the repo description" -- gh repo view antoniomika/lend. Ainsi, le proxy peut être utilisé à la fois via l’API MCP (outil run_local_command) et directement en ligne de commande.
Stabilité du socket et intégration avec herdr
herdr maintient les panneaux actifs même après une déconnexion SSH, mais le socket SSH_AUTH_SOCK change à chaque reconnexion. Antonio résout ce problème avec un lien symbolique fixe (~/.ssh/lend/agent.sock) mis à jour par un script ~/.ssh/rc exécuté avant le shell. Le script vérifie que le socket appartient bien à lend via lend doctor --remote --socket "$SSH_AUTH_SOCK" avant de le remplacer, garantissant que les agents en cours conservent un accès valide.
#!/bin/sh
if [ -n "${SSH_AUTH_SOCK:-}" ] &&
[ "$SSH_AUTH_SOCK" != "$HOME/.ssh/lend/agent.sock" ] &&
"$HOME/.local/bin/lend" doctor --remote --socket "$SSH_AUTH_SOCK" --timeout 1s >/dev/null 2>&1; then
install -d -m 700 "$HOME/.ssh/lend" &&
ln -sfn -- "$SSH_AUTH_SOCK" "$HOME/.ssh/lend/agent.sock"
fi
# X11 forwarding handling omitted for brevity
Cette approche assure que chaque pane herdr conserve un point d’accès fiable, même si la connexion sous‑jacente est réinitialisée. En combinant le proxy lend, la politique fine‑grained et le mécanisme de socket persistant, l’ensemble du workflow d’agents distants reste fonctionnel tout en maintenant les secrets strictement sur le laptop.