Docker-Compose : Portainer Agent

Mon, 15 Aug 2022 16:55:25 +0200

docker-compose.yml

version: '3'

services:
 agent:
 image: portainer/agent
 container_name: portainer_agent
 restart: unless-stopped
 security_opt:
 - no-new-privileges:true
 volumes:
 - /etc/localtime:/etc/localtime:ro
 - /var/run/docker.sock:/var/run/docker.sock:ro
 - /var/lib/docker/volumes:/var/lib/docker/volumes
 ports:
 - 9001:9001

Tactical RMM : Agent installation

Thu, 21 Oct 2021 10:35:03 +0200

A lire

Pour l'instant seul un agent Windows est pleinement fonctionnel. Les versions Linux et macOS sont en cours de développement.
Afin d'éviter la détection de l'agent par l'antivirus, 2 solutions :
- Agent avec code signé par Microsoft.
Un don mensuel de 50$ est demandé afin d'avoir accès à l'agent avec le code signé Microsoft. Le status Sponsor est alors attribué au sein du projet Tactical RMM.
- Agent sans code signé par Microsoft.
Le setup généré dynamiquement de l'agent (explications plus bas) sans code signé peut provoquer une alerte virale sur votre système. L'utilisation de l'agent générique (via script, gpo) ne provoque pas d'alerte virale.
Penser à vérifier vos exclusions antivirus une fois l'agent Windows déployé:
```
C:\Program Files\TacticalAgent\*
C:\Program Files\Mesh Agent\*
C:\Windows\Temp\winagent-v*.exe
C:\Windows\Temp\trmm\*
C:\temp\tacticalrmm*.exe
```
Lors du déploiement de l'agent, les exclusions sont automatiquement créées dans Windows Defender.
Par défaut les mises à jour Windows sont désactivées automatiquement après l'installation de l'agent.

Déploiement agent

L'exécution de l'installation des agents doit être effectué sur les hôtes à surveiller.

Déploiement manuel

Se rendre sur https://rmm.example.com.
Clic droit sur le client/site puis Install Agent.
Vérifier que le Client et le Site soient corrects.
Définir le type de machine (Server / Workstation) à qui s'adresse l'agent.
Définir le temps de validité de l'agent (Token expiration).
Définir les options appliqués par l'agent (Enable RDP, Enable Ping, Disable sleep/hibernate).
Sélectionner la méthode d'installation souhaitée :
- Agent généré dynamiquement
Attention à l'antivirus si le code de l'agent est non signé par Microsoft. Voir la section A lire au début de cet article.
- Powershell : Génération d'un script Powershell. L'agent est générique et le scripts contient tous les paramètres de l'agent.
- Autoriser l'exécution du script Powershell :
```
PS C:\> Set-ExecutionPolicy Unrestricted
```
- Manuel : L'agent est générique. Le script d'exécution est afficher à l'écran. Cette méthode est préconisée pour l'intégration dans des scripts et/ou des GPOs.
Attention à la durée du token si cette méthode est choisie pour une utilisation dans des scripts et/ou GPOs. Mettre une valeur très importante si besoin d'une validité permanente.

Lien de déploiement

A partir du client, se rendre sur https://rmm.example.com.
Menu Agents puis Manage Deployments.

Astuce : Créer un client/site default avec un lien de déploiement (token avec une longue expiration) pour avoir une URL générique. Puis déplacer l'agent dans le client / site souhaité.

L'agent téléchargé à travers ce lien est de type dynamique. Il est potentiellement détectable par les antivirus (si code non signé). Se référer à la section A lire en début de cet article.

Déploiement par GPO

La GPO de déploiement de l'agent doit être appliquée au niveau ordinateur afin que l'installation de l'agent se déroule sous un compte Local System ayant les droits nécessaires.

Récupérer le script d'installation de l'installation manuelle (voir plus haut) ainsi que l'exécutable de l'agent générique.
Stocker le script et l'agent.exe dans un dossier partager du contrôleur de domaine (exemple: C:\agent_rmm\).
Sur le domaine Windows, ouvrir la console MMC des GPOs :

gpmc.msc

Créer une nouvelle GPO ciblant une OU contenant des Ordinateurs.

Editer cette GPO. Trois étapes sont nécessaire pour que celle-ci fonctionne parfaitement.
- La création d'un dossier sur le poste client.
- La copie du script et de l'agent.exe sur le poste client.
- L'exécution d'un script au démarrage du poste client :
```
cd c:\agent_rmm
agent_rmm.bat
```
Patienter ou forcer l'application de la nouvelle GPO :

gpupdate /force

Un modèle de GPO importable dans un domaine est disponible : ICI

Arguments optionnels

Quelques arguments qui peuvent être utilisés dans des scripts :
- -log debug : Affiche un log verbeux lors de l'installation de l'agent
- -silent : Aucun message durant l'installation de l'agent
- -proxy "http://proxyserver:port" : Pour utiliser un proxy
- -meshdir "C:\Mesh Agent" : Spécifier le chemin contenant meshagent.exe
- -nomesh : N'installe pas l'agent meshcentral. Pas de take control, remote terminal, file browser

Agent on slash-root.fr

Docker-Compose : Portainer Agent

docker-compose.yml

Tactical RMM : Agent installation

A lire

Déploiement agent

Déploiement manuel

Lien de déploiement

Déploiement par GPO

Arguments optionnels