Stocker des informations d'identification pour le collecteur
Des informations d'identification représentent la connexion en lecture seule qu'utilise le collecteur pour atteindre un système : une connexion SQL, un compte Windows, une clé SSH ou un principal de service Azure. Vous les stockez une seule fois sur une entité, et chaque ressource de cette entité et des entités situées en dessous peut les utiliser. Ce guide explique comment en ajouter, quel type choisir, quelles sont les options de connexion de chaque type et comment une ressource trouve les informations d'identification qu'elle utilise.
Avant de commencer
- Vous devez disposer du rôle Entity admin sur l'entité qui sera propriétaire des informations d'identification.
- La connexion existe sur le système surveillé avec des autorisations en lecture seule. Pour SQL Server, consultez Prérequis pour les groupes de disponibilité ; pour toutes les plateformes, consultez Autorisations.
- Stockez les informations d'identification aussi haut dans l'arborescence des entités qu'elles sont valides. Une connexion SQL utilisée sur tous les serveurs de Combray SA se place sur Combray SA, et non sur chaque environnement.
Choisir le type
| Type | Utilisateur | Secret | Utilisation |
|---|---|---|---|
SQL login (sql_login) | Connexion SQL | Mot de passe | Les instances SQL Server et les groupes de disponibilité ; leurs bases de données et serveurs liés découverts utilisent ceux de l'instance. Également le journal d'exécution de Reporting Services |
Windows account (windows) | Compte (DOMAIN\user) | Mot de passe | Les hôtes Windows via WinRM ; les serveurs de rapports et les points de terminaison web avec l'authentification Windows (NTLM) |
HTTP user and password (http_basic) | Utilisateur | Mot de passe | Les points de terminaison web et les serveurs de rapports avec l'authentification de base ; les vérifications Wazuh |
Bearer token (token) | — | Jeton | Les points de terminaison web avec l'authentification par jeton du porteur |
SSH key (ssh_key) | Utilisateur | Clé privée | Les hôtes Linux |
SSH password (ssh_password) | Utilisateur | Mot de passe | Les hôtes Linux |
Azure service principal (azure_sp) | ID client | Secret client | Les vérifications de posture Azure et les vérifications d'identité Entra ID, pour un locataire que l'identité managée du serveur ne peut pas atteindre |
L'authentification Windows intégrée à SQL Server n'est pas prise en charge : le collecteur s'exécute dans un conteneur Linux sans ticket Kerberos. Utilisez une connexion SQL, ce qui exige que l'instance accepte l'authentification SQL Server (mode mixte).
Ajouter des informations d'identification
- Ouvrez Settings › Credentials et choisissez l'entité dans le sélecteur d'entités, par exemple Combray SA.
- Sélectionnez Add credential.
- Saisissez un Name que vous reconnaîtrez, comme
sql-monitoring, et choisissez le Kind. Le type ne peut pas être modifié par la suite. - Vérifiez l'Entity : les ressources de cette entité et des entités situées en dessous peuvent utiliser ces informations d'identification.
- Saisissez l'utilisateur et le secret. Les libellés dépendent du type, par exemple SQL login et Password, ou Client id et Client secret.
- Sous Connection options, définissez ce dont le type a besoin. Consultez la section suivante.
- Sélectionnez Create.
Les informations d'identification apparaissent dans la liste avec le secret marqué stored, le nombre de ressources qui les utilisent et la date de leur dernière utilisation.
Options de connexion
| Type | Option | Valeurs | Effet |
|---|---|---|---|
| SQL login | encrypt | yes (par défaut), no, strict | Chiffre la connexion. strict utilise TDS 8 et nécessite SQL Server 2022 ou une version ultérieure |
| SQL login | trust_server_certificate | true (par défaut), false | La plupart des instances utilisent des certificats auto-signés. Définissez false dès que l'instance dispose d'un certificat approuvé par le collecteur |
| SQL login | host_name_in_certificate | Un nom d'hôte | Le nom à valider lorsqu'il diffère de l'hôte, par exemple via un écouteur ou un alias |
| SQL login | application_intent | ReadOnly (par défaut), ReadWrite | ReadWrite modifie uniquement le routage, afin que les vérifications par base de données incluent les bases de données de disponibilité d'un réplica principal qui refuse les connexions avec intention de lecture. La connexion n'a toujours aucune autorisation d'écriture |
| Windows account | auth | kerberos (par défaut), negotiate, ntlm | La méthode d'authentification de WinRM. L'image du collecteur n'a pas de configuration Kerberos ; choisissez donc negotiate ou ntlm |
| SSH key, SSH password | known_hosts | Des lignes OpenSSH known_hosts, une par ligne | Épingle les clés d'hôte que le collecteur accepte |
| Azure service principal | tenant_id | L'ID du locataire Entra | Le locataire de l'inscription d'application |
Certaines options ne peuvent être définies que par l'API, dans les attributes des informations d'identification :
| Type | Option | Effet |
|---|---|---|
| Azure service principal | subscriptions | Limite les vérifications de posture Azure à ces abonnements. Sans elle, AZURE_SUBSCRIPTION_IDS s'applique, ou à défaut tous les abonnements que l'identité peut lire |
| HTTP user and password | verify_tls | false accepte un certificat non approuvé sur l'indexeur et le gestionnaire Wazuh. Valeur par défaut : true |
Les noms d'options ne contiennent jamais de secrets : l'API refuse une option dont le nom contient pass, secret, token, private ou pwd. Placez les secrets dans le champ du secret.
Protection du secret
- Le secret est en écriture seule. Il est chiffré avec la clé de données de l'installation (
EXCUBIUS_DATA_KEY) et n'est plus jamais affiché, ni sur un écran ni par l'API, qui indique seulement si un secret est stocké. - Pour le changer, modifiez les informations d'identification et saisissez-en un nouveau. Laissez le champ vide pour conserver le secret stocké, ou sélectionnez Remove the stored secret pour l'effacer.
- Le collecteur reçoit le secret par le réseau interne, le conserve uniquement en mémoire et ne le journalise jamais.
- Conservez
EXCUBIUS_DATA_KEYavec la sauvegarde du fichier.env. Sans elle, les secrets stockés ne peuvent pas être déchiffrés, et les vérifications échouent avec le type d'erreurconfigjusqu'à ce que vous les saisissiez de nouveau.
Informations d'identification utilisées par une ressource
Une ressource recherche des informations d'identification dans l'ordre suivant et retient les premières dont le type convient à la vérification :
- Les informations d'identification propres à la vérification, si elles sont définies.
- Les informations d'identification de la ressource.
- Les informations d'identification de la ressource parente la plus proche. Un groupe de disponibilité ou une base de données découverts sous une instance utilisent la connexion SQL de l'instance.
Par exemple, la vérification du journal d'exécution d'un serveur de rapports est une vérification T-SQL. Lorsque la ressource du serveur de rapports contient un compte Windows pour son portail, la vérification utilise la connexion SQL de l'instance située au-dessus, ou une connexion SQL que vous définissez sur cette seule vérification.
Pour définir des informations d'identification sur une vérification, utilisez l'API : PATCH /api/v1/resources/{id}/checks/{check_id} avec credential_id. Associer une ressource ou une vérification à des informations d'identification nécessite le rôle Entity admin sur l'entité qui en est propriétaire.
Modifier ou supprimer des informations d'identification
- Edit modifie le nom, l'utilisateur, le secret et les options. Le type reste inchangé.
- Delete ne fonctionne que si rien n'utilise les informations d'identification. Modifiez d'abord les ressources et les vérifications qui les utilisent.
- La suppression d'une entité supprime aussi les informations d'identification dont elle est propriétaire.
La liste indique, pour chaque élément, le nombre de ressources et de vérifications qui l'utilisent et la date de sa dernière utilisation par une vérification réussie.
Contenu connexe
- Fonctionnement du collecteur
- Ajouter une ressource, où Test connection prouve que les informations d'identification fonctionnent
- Erreurs du collecteur
- Autorisations