Installation de l'agent Kapsul par GPO

L'agent Kapsul peut être déployé de manière centralisée sur l'ensemble de vos serveurs Windows grâce aux stratégies de groupe (GPO) de Microsoft Active Directory.

Prérequis

• Droits d'administration sur le contrôleur de domaine
• Serveurs Windows joints au domaine
• Package MSI de Kapsul téléchargé
• Clé d'API Kabeen

Étape 1 : Préparer le partage réseau

1. Créez un dossier partagé accessible par tous les serveurs
2. Copiez le fichier MSI de Kapsul dans ce partage
3. Vérifiez les permissions : les comptes d'ordinateurs doivent avoir un accès en lecture

\\serveur\partage\kapsul\kapsul-agent.msi

Étape 2 : Créer la GPO de déploiement

1. Ouvrez la console Gestion des stratégies de groupe

2. Créez une nouvelle GPO liée à l'OU contenant vos serveurs

3. Éditez la GPO et naviguez vers :

   • Configuration ordinateur > Stratégies > Paramètres logiciels > Installation de logiciel

4. Cliquez droit > Nouveau > Package

5. Sélectionnez le fichier MSI depuis le chemin réseau UNC

6. Choisissez Attribué comme méthode de déploiement

Étape 3 : Configurer la clé d'API

L'agent Kapsul nécessite une clé d'API pour s'authentifier. Configurez-la via une GPO de préférences :

1. Dans la même GPO, naviguez vers :

   • Configuration ordinateur > Préférences > Paramètres Windows > Registre

2. Créez une nouvelle entrée de registre :

   • Action : Créer
   • Ruche : HKEY_LOCAL_MACHINE
   • Chemin : SOFTWARE\Kabeen\Kapsul
   • Nom de la valeur : ApiKey
   • Type : REG_SZ
   • Données : Votre clé d'API Kabeen

Étape 4 : Appliquer et vérifier

1. Forcez la mise à jour des stratégies sur un serveur de test :

gpupdate /force

2. Redémarrez le serveur pour déclencher l'installation
3. Vérifiez que le service Kapsul est démarré :

sc query kapsul

Filtrage par groupe de sécurité

Pour un déploiement progressif :

1. Créez un groupe de sécurité (ex: "Serveurs-Kapsul")
2. Dans la GPO, onglet Délégation > Avancé
3. Retirez "Utilisateurs authentifiés" de l'application
4. Ajoutez votre groupe avec les droits "Lire" et "Appliquer"

Dépannage

L'installation ne démarre pas

• Vérifiez que le chemin UNC est accessible depuis le serveur
• Consultez les journaux d'événements Windows (Application + Système)
• Vérifiez les permissions sur le partage et le fichier MSI

Le service ne démarre pas

• Vérifiez que la clé d'API est correctement configurée dans le registre
• Consultez les logs Kapsul dans C:\ProgramData\Kabeen\Kapsul\logs
• Vérifiez la connectivité réseau vers api.kabeen.io:443