Connecteurs
Connectez serveurs, hyperviseurs, DNS, pare-feu, stockage, cloud et maison connectée — un à un ou des centaines d'un coup.
Un connecteur est un système avec lequel Opsaido peut dialoguer : un cluster Proxmox, un serveur Linux, un fournisseur DNS, un pare-feu. L’assistant n’utilise que les outils des systèmes que vous avez connectés.
En ajouter un
- Allez dans Settings → Connectors → Add connector et choisissez le type.
- Renseignez l’adresse et l’identifiant. Chaque type précise exactement ce dont il a besoin.
- Cliquez sur Test connection. Pour les hôtes SSH, la clé d’hôte est enregistrée au premier test.
Donnez à Opsaido son propre compte de service sur chaque système, avec uniquement les droits que vous voulez accorder à l’assistant. Des droits en lecture suffisent pour superviser et enquêter.
Ce dont chaque système a besoin
| Système | Se connecte via | Pour superviser | Pour modifier |
|---|---|---|---|
| Proxmox VE | Jeton d’API | PVEAuditor | PVEVMAdmin + droits sur le datastore |
| XCP-ng | Jeton Xen Orchestra | Un utilisateur XO en lecture | Un admin XO, ou des ACL sur les pools / VM |
| KVM / libvirt | Le connecteur Linux (SSH) de l’hôte | Un utilisateur du groupe libvirt | Idem, ou sudo |
| VMware ESXi / vCenter | API vSphere | Rôle en lecture seule | Alimentation, instantanés, provisionnement des VM |
| Linux | SSH (clé recommandée) | Un utilisateur normal | sudo |
| Windows | WinRM (HTTPS 5986 recommandé) | Un utilisateur normal | Admin local |
| Docker | Proxy de socket ou SSH | Proxy en lecture seule | Proxy avec actions autorisées |
| Kubernetes / k3s | kubeconfig ou jeton | view | edit / admin |
| Active Directory | LDAPS | Lecture sur les OU (tout utilisateur du domaine) | Droits d’administration délégués sur les OU pour gérer utilisateurs, ordinateurs et groupes (créer, modifier, réinitialiser les mots de passe, déplacer, supprimer) |
| Cloudflare DNS | Jeton d’API | Zone:Read | DNS:Edit |
| Microsoft 365 / Azure | Inscription d’application Entra ID | Permissions Graph en lecture, Reader Azure | Permissions d’écriture correspondantes |
| Pare-feu (OPNsense, pfSense, MikroTik) | Clé d’API REST | Privilèges en lecture | Privilèges en écriture |
| FortiGate | Jeton d’administrateur API REST | Profil d’administration en lecture seule (ce serveur en hôte de confiance) | — (connecteur en lecture seule) |
| Palo Alto (PAN-OS) | Clé d’API XML, ou nom d’utilisateur et mot de passe | Administrateur en lecture seule | — (connecteur en lecture seule) |
| Check Point | API de gestion (R80+), utilisateur ou clé d’API | Profil de permissions en lecture seule | — (connecteur en lecture seule) |
| Meraki MX | Clé d’API Dashboard | Accès à l’organisation en lecture seule | — (connecteur en lecture seule) |
| SonicWall / Sophos Firewall | API REST SonicOS 7 / API XML SFOS (activer l’API, autoriser l’adresse de ce serveur) | Un administrateur en lecture seule | — (connecteur en lecture seule) |
| Cisco Firepower / ASA | API REST FMC / SSH | Utilisateur FMC en lecture seule / utilisateur ASA en lecture seule (le privilège 5 suffit pour les commandes show) | — (connecteur en lecture seule) |
| Commutateurs, NAS, onduleurs, imprimantes (tout fabricant) | SNMP v1 / v2c / v3 | Une communauté en lecture seule, ou un utilisateur v3 avec mot de passe | — (lecture seule) |
| Citrix Virtual Apps and Desktops | WinRM vers un Delivery Controller (et les serveurs de licences, StoreFront et PVS) | Read Only Administrator | Help Desk / Machine Catalog / Delivery Group Administrator |
| Sauvegardes (PBS, Veeam) | Jeton d’API | Rôle audit / lecteur | Rôle opérateur / admin |
| CrowdSec | Local API | Clé bouncer (voit qui est bloqué) | Login machine (cscli machines add) : alertes, bannir, débannir |
La liste complète se trouve sur la page Intégrations.
Plusieurs serveurs avec le même identifiant
| Étape | Où | Ce que vous faites |
|---|---|---|
| 1 | Settings → Credentials → New credential | Enregistrez une fois l’identifiant partagé : clé SSH, compte Windows, jeton d’API… |
| 2 | Settings → Connectors → Add many | Choisissez le type et l’identifiant, collez un serveur par ligne (nom, hôte) ou chargez un CSV |
| 3 | Même page | Ajoutez des étiquettes comme web ou prod ; Opsaido crée et teste les serveurs dix par dix |
Ensuite :
- Changez le mot de passe dans l’identifiant et tous les serveurs qui l’utilisent le reprennent.
- Interrogez par étiquette : « vérifie les mises à jour sur tous les serveurs #web ».
- Limitez un rôle à une étiquette ; les serveurs ajoutés plus tard avec cette étiquette sont inclus automatiquement.
Hôtes injoignables directement
Pour une DMZ, un autre site ou un VLAN isolé, ajoutez une passerelle proxy : une machine Linux ou Windows qui peut les joindre. Le fonctionnement et la mise en place sont décrits dans Comment fonctionnent les connexions.
Ajouter deux fois la même machine — par exemple comme hôte Docker et comme hôte Linux — ne pose aucun problème. Les tâches shell et fichiers passent par le connecteur SSH ; les tâches de conteneurs par le connecteur Docker.