Comment fonctionnent les connexions
Ce qui se passe entre votre question et vos systèmes, où sont les identifiants, et comment les passerelles proxy atteignent les réseaux que Opsaido ne peut pas joindre.
Le parcours d’une demande
- Vous demandez avec vos mots.
- Opsaido choisit les outils des systèmes connectés et envoie la question, avec ces outils, à votre fournisseur d’IA.
- L’IA choisit une étape, par exemple « liste les VM du cluster Proxmox ».
- Opsaido vérifie l’étape. Une lecture s’exécute tout de suite ; une modification attend votre accord (voir Validations et simulations).
- Opsaido se connecte au système avec l’identifiant enregistré du connecteur, exécute l’étape et l’inscrit au journal d’audit.
- Le résultat revient à l’IA, qui passe à l’étape suivante ou rédige la réponse pour vous.
Les identifiants sont stockés chiffrés dans la base de données de Opsaido et déchiffrés uniquement le temps d’une connexion. L’IA voit ce qu’une étape a renvoyé, jamais comment Opsaido s’est connecté.
Ce qui utilise un connecteur
| Usage | Quand | Validation |
|---|---|---|
| Test connection | Quand vous cliquez sur le bouton ; enregistre la clé d’hôte SSH la première fois | — |
| Supervision | Toutes les quelques minutes : CPU, mémoire, disque, état, alertes | — |
| Assistant | Quand vous posez une question sur ce système | Lectures : aucune · modifications : oui |
| Tâches planifiées | Selon leur planning | Comme réglé sur la tâche |
| Accès à distance | Terminal SSH ou bureau RDP dans le navigateur | Nécessite la permission d’accès à distance |
Comment chaque type de système est joint
| Se connecte via | Systèmes | Via une passerelle ? | Via un proxy HTTP ? |
|---|---|---|---|
| SSH | Linux, hôtes KVM / libvirt, Docker via SSH, hôtes Terraform et Ansible | ✓ | — |
| WinRM | Windows, Hyper-V, Exchange, DNS Windows, AD CS, MECM | ✓ | — |
| API web (HTTPS) | Proxmox, Xen Orchestra (XCP-ng), API Docker, pare-feu, NAS, sauvegardes, fournisseurs DNS, Microsoft 365, Azure… | — | ✓ |
| Protocoles natifs | Active Directory (LDAPS), bases de données, VMware | — | — |
Les API web d’un autre réseau se joignent généralement via un proxy HTTP plutôt qu’une passerelle. Définissez le proxy par défaut dans Settings → General → Outbound proxy, et choisissez default, direct ou un proxy custom sur chaque connecteur. Les adresses privées contournent le proxy par défaut, sauf si vous modifiez la liste d’exclusions.
Passerelles proxy (hôtes de rebond)
Utilisez une passerelle quand Opsaido ne peut pas joindre certains hôtes directement : une DMZ, un autre site, un VLAN isolé ou le réseau d’un client. La passerelle est une machine qui peut les joindre, et Opsaido passe par elle.
Mise en place
- Ajoutez la passerelle : Settings → Connectors → Add connector → Proxy gateways. Choisissez Linux gateway (SSH) ou Windows gateway (WinRM) et donnez-lui un identifiant.
- Testez-la. Le test vérifie l’identifiant et enregistre sa clé d’hôte SSH. Sur une passerelle Windows, il vérifie aussi que le client OpenSSH est installé (nécessaire pour les cibles Linux).
- Rattachez les hôtes : sur chaque connecteur Linux ou Windows derrière elle, choisissez la passerelle dans le champ Proxy gateway.
- Testez chaque hôte. Dès lors, tout ce qui concerne cet hôte — tests, supervision, étapes de l’assistant, tâches — passe par la passerelle.
Ce qui se passe pour chaque cible
| Cible | Via une passerelle Linux (SSH) | Via une passerelle Windows (WinRM) |
|---|---|---|
| Linux | SSH est tunnelisé à travers la passerelle (ProxyJump). Les deux clés d’hôte sont enregistrées. Le terminal dans le navigateur fonctionne aussi. | Le client OpenSSH de la passerelle (ssh.exe) se connecte. Connexion par clé uniquement ; la clé d’hôte de la cible est enregistrée au premier test. |
| Windows | WinRM passe par un tunnel SOCKS sur la passerelle. Les noms sont résolus côté passerelle, Kerberos fonctionne donc. | Invoke-Command s’exécute sur la passerelle avec l’identifiant propre de la cible. |
Ce dont la passerelle a besoin
| Passerelle | Besoins |
|---|---|
| Linux (SSH) | Un accès SSH et le transfert TCP autorisé (AllowTcpForwarding yes, par défaut). Le compte n’a pas besoin de sudo. |
| Windows (WinRM) | Un accès WinRM. Pour les cibles Linux : la fonctionnalité OpenSSH Client. Pour les cibles Windows en groupe de travail : ces hôtes dans TrustedHosts. |
| Réseau | Elle doit joindre les cibles en SSH (22) ou WinRM (5985/5986) ; Opsaido doit la joindre en SSH ou WinRM. |
La passerelle ne stocke aucun identifiant pour les cibles : Opsaido fait passer l’identifiant de chaque cible uniquement pour cette connexion. Traitez tout de même une passerelle comme n’importe quel hôte de rebond : tenez-la à jour et limitez qui peut s’y connecter.
Bon à savoir
| Question | Réponse |
|---|---|
| Une passerelle peut-elle servir plusieurs hôtes ? | Oui, autant que vous voulez. Regroupez-les avec des étiquettes. |
| Puis-je désactiver une passerelle ? | Oui ; ses hôtes affichent alors « Proxy gateway is disabled » jusqu’à sa réactivation. |
| Puis-je supprimer une passerelle utilisée ? | Non. Déplacez d’abord ses hôtes vers une autre passerelle, ou videz leur champ. |
| Les passerelles s’enchaînent-elles ? | Non, une passerelle par hôte. Choisissez-en une qui joint directement la cible. |
| Et les API web derrière ? | Utilisez un proxy HTTP pour celles-ci (voir l’astuce plus haut). |