Installez Agent Client Collector manuellement sur un ordinateur qui utilise MacOS lorsque l'agent n'est pas connecté à l'instance ou que vous souhaitez utiliser des options de personnalisation améliorées.
Avant de commencer
- Assurez-vous d'avoir configuré le serveur Web d'Agent Client Collector.
- Vérifiez que le système d'exploitation et la version de votre serveur correspondent à la liste des versions du système d'exploitation prises en charge, comme décrit à la rubrique Installation d'Agent Client Collector.
- Accédez à la et téléchargez la .pkg signée pertinente pour votre système d’exploitation.
- Stockez le package d'installation .pkg sur l'un de vos agents installés.
Rôle requis : agent_client_collector_admin
Procédure
-
Téléchargez les fichiers d'installation sur votre ordinateur local.
curl -L <download link from the Agent Downloads page on the instance>
-
Validez la signature du fichier d'installation.
pkgutil --check-signature agent-client-collector-<version number>-macos-catalina_x64.pkg
Remarque : assurez-vous que la chaîne de certification pkg possède le certificat du programme d'installation de l'ID de développement ServiceNow.
-
Installez le package Agent Client Collector.
sudo installer -pkg agent-client-collector-<version number>-macos-catalina_x64.pkg -target /
-
Copiez les fichiers d'installation.
-
Exemple de fichier de configuration :
sudo cp -p /Library/Application\ Support/servicenow/agent-client-collector/acc.yml.example /Library/Application\ Support/servicenow/agent-client-collector/acc.yml
-
Exemple de fichier de liste d'autorisation :
sudo cp -p /Library/Application\ Support/servicenow/agent-client-collector/check-allow-list.json.default /Library/Application\ Support/servicenow/agent-client-collector/check-allow-list.json
- Facultatif :
pour créer de nouvelles définitions de vérification à inclure dans la liste d'autorisation, désactivez au préalable la liste d'autorisation en commentant le paramètre allow-list dans le fichier acc.yml.
sudo -H -u _servicenow vi /Library/Application\ Support/servicenow/agent-client-collector/acc.yml
Remarque : dans la mesure où cette action compromet la sécurité de votre système, elle est recommandée uniquement comme mesure temporaire jusqu'à ce que vous terminiez la mise à jour de la liste d'autorisation. Une fois la mise à jour terminée, annulez le commentaire du paramètre de liste d'autorisation dans le fichier de configuration pour réactiver la liste d'autorisation.
Pour en savoir plus sur l'ajout de vérifications personnalisées à une liste d'autorisation, consultez la rubrique Générer une liste d'autorisation Agent Client Collector.
-
Enregistrez le fichier de configuration.
-
Dans le fichier de configuration, connectez l'agent au Serveur MID.
-
Définissez la connexion du Serveur MID.
"wss://<MID Server IP>:<Web Socket Port>/ws/events"
Le port de socket Web a été configuré sur le Serveur MID au moment où il a été défini en tant qu'écouteur Agent Client Collector.
-
Recherchez le paramètre api-key et spécifiez la valeur de clé API entre guillemets doubles, comme suit :
api-key:"111111111"
La clé API spécifiée est chiffrée la première fois que l'agent s'exécute.
-
Pour vous assurer que le fichier de configuration pointe vers un point de terminaison valide, exécutez les commandes suivantes pour redémarrer :Agent Client Collector
sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist
sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist
Remarque : par défaut, quitter le programme d'installation entraîne le redémarrage immédiat du programme. Pour vous assurer que le programme ne redémarre pas après l'avoir quitté, définissez la propriété KeepAlive dans le fichier /Library/LaunchDaemons/com.sn.acc.plist sur faux.