Note

Tout est présenté avec placeholders (pas de clés, pas de secrets, pas de code privé).

Illustration (Extension Generator)

Capture : générateur dextension VS Code (Yeoman). Affichage plein largeur.

Chaîne dexécution

tapes minimum viable

```mermaid
sequenceDiagram
  participant W as Windows
  participant P as Raspberry Pi
  W->>P: ping <PI_IP>
  W->>P: ssh <USER>@<PI_IP> "uname -a"
  W: ssh-keygen (clé dédiée sans passphrase)
  W->>P: installer la clé publique dans authorized_keys
  W->>P: ssh <ALIAS> "uname -a" (non-interactif)
```

3.1 Pré-requis

3.2 Vérifier la connectivité réseau

ping <PI_IP>

3.3 Vérifier SSH

ssh <PI_USER>@<PI_IP> "uname -a"

Astuce

Si lIP ne répond pas : corriger lIP (DHCP/routeur), vérifier Wi-Fi/Ethernet, vérifier isolation réseau.

3.4 Créer une clé dédiée automation (sans passphrase)

Objectif : permettre à lagent dexécuter des commandes sans saisie interactive.

ssh-keygen -t ed25519 -f "%USERPROFILE%\.ssh\<PROJECT_KEY>" -N ""

Exemple (nom de clé) :

ssh-keygen -t ed25519 -f "%USERPROFILE%\.ssh\obambou_pi_ed25519" -N ""

3.5 Installer la clé publique sur le Pi

On ajoute la clé publique dans ~/.ssh/authorized_keys (une ligne par clé).

type "%USERPROFILE%\.ssh\<PROJECT_KEY>.pub" | ssh <PI_USER>@<PI_IP> "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"

3.6 Permissions côté Pi (obligatoires)

chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

3.7 Test non-interactif (clé dédiée)

ssh -i "%USERPROFILE%\.ssh\<PROJECT_KEY>" <PI_USER>@<PI_IP> "uname -a"

3.8 Alias SSH (évite les erreurs et simplifie lagent)

Créer/éditer C:\Users\<USER>\.ssh\config :

Host raspoutine
  HostName <PI_IP>
  User <PI_USER>
  IdentityFile C:\Users\<WIN_USER>\.ssh\<PROJECT_KEY>
  IdentitiesOnly yes

Test :

ssh raspoutine "uname -a"

Résultat attendu

La commande sexécute sans demander de mot de passe ni passphrase.

4.1 Principe

4.2 Démarche (résumé)

• Génération dextension VS Code (Yeoman) : yo code.
• Ouverture en Extension Development Host (F5).
• Dans cette fenêtre, ouvrir un dossier de travail (sinon lexplorer est vide).
• Dans le chat agent : demander lexécution via le shell tool.

4.3 Commande de test agent Pi

ssh raspoutine "uname -a"

Validation

Le tool renvoie : SSH command ran successfully + la sortie uname -a.

5.1 Garde-fous appliqués

5.2 Recommandation forte : dispatcher obbctl côté Pi

Objectif : éviter que lagent exécute des commandes arbitraires. On expose un petit API CLI local : obbctl (actions autorisées).

sudo tee /usr/local/bin/obbctl >/dev/null <<'EOF'
#!/usr/bin/env bash
set -euo pipefail

case "${1:-}" in
  info)   uname -a ;;
  uptime) uptime ;;
  # ajouter ici UNIQUEMENT les actions validées
  *) echo "Usage: obbctl {info|uptime}" ; exit 2 ;;
esac
EOF
sudo chmod +x /usr/local/bin/obbctl

Usage (depuis Windows / agent) :

ssh raspoutine obbctl info
ssh raspoutine obbctl uptime

5.3 Recommandation optionnelle : allowlist côté Shell Tool

Renforcer encore : le tool refuse toute commande qui nest pas dans une liste autorisée (par exemple uniquement ssh raspoutine obbctl ...).

// Exemple (pseudo-code)
if (!cmd.startsWith("ssh raspoutine obbctl ")) {
  throw new Error("Refus: seules les commandes ssh raspoutine obbctl ... sont autorisées.");
}

Hygiène clé

Ne jamais publier / copier une clé privée. Si une clé privée a circulé, rotation recommandée (nouvelle clé + suppression de lancienne du Pi).

SSH

ping <PI_IP>
ssh <PI_USER>@<PI_IP> "uname -a"
ssh-keygen -t ed25519 -f "%USERPROFILE%\.ssh\<PROJECT_KEY>" -N ""
type "%USERPROFILE%\.ssh\<PROJECT_KEY>.pub" | ssh <PI_USER>@<PI_IP> "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"
# sur le Pi:
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
# test:
ssh -i "%USERPROFILE%\.ssh\<PROJECT_KEY>" <PI_USER>@<PI_IP> "uname -a"

Alias

Host raspoutine
  HostName <PI_IP>
  User <PI_USER>
  IdentityFile C:\Users\<WIN_USER>\.ssh\<PROJECT_KEY>
  IdentitiesOnly yes

Agent

ssh raspoutine "uname -a"
ssh raspoutine obbctl info