PRTG Network Monitor PRTG Network Monitor

Collectez l'inventaire, statut des capteurs et alertes réseau PRTG

Le connecteur PRTG Network Monitor vous permet de récupérer les données de surveillance réseau depuis votre instance PRTG.

Objectif

Le connecteur PRTG Network Monitor permet de récupérer les informations suivantes :

  • Inventaire des équipements surveillés
  • Statut des capteurs
  • Alertes réseau

Prérequis

  • Accès à une instance PRTG Network Monitor
  • Token API PRTG OU credentials utilisateur/mot de passe
  • Accès réseau au serveur PRTG

Informations à fournir dans OverSOC

ChampDescription
Server URL*URL de votre serveur PRTG (ex: https://prtg.example.com)
API TokenToken API PRTG (alternative aux identifiants)
UsernameNom d'utilisateur PRTG (optionnel, si pas de token)
PasswordMot de passe utilisateur PRTG (optionnel, si pas de token)
Password HashHash du mot de passe (optionnel, alternative au mot de passe)

Note : Vous devez fournir soit un API Token, soit une combinaison Username/Password, mais pas les deux.

Procédure

Option 1 : Utiliser un nom d'utilisateur avec Passhash (recommandé)

  1. Connectez-vous à votre console PRTG.
  2. Naviguez vers Setup > Account Settings > My Account.
  3. Cliquez sur Show passhash pour révéler votre valeur Passhash.
  4. Alternativement, récupérez le passhash par programmation en utilisant :
    https://yourserver/api/getpasshash.htm?username=myuser&password=mypassword
    

Option 2 : Utiliser un API Token

  1. Connectez-vous à votre console PRTG.
  2. Naviguez vers Setup > Notification > API Token.
  3. Cliquez sur Create new token.
  4. Nommez le token (ex: OverSOC Connector).
  5. Configurez les droits d'accès :
    • Objects : Read
    • Reports : Read
  6. Cliquez sur Save et notez la valeur du token.

Configurer le connecteur dans OverSOC

  1. Dans OverSOC, accédez à Data Sources Settings > Sources.
  2. Sélectionnez PRTG Network Monitor et cliquez sur Configure.
  3. Renseignez les champs requis :
    • Server URL : https://yourserver (ex : https://prtg.example.com)
    • Username : Votre nom d'utilisateur PRTG
    • Passhash : Votre passhash (préféré à la place du mot de passe)
    • API Token (optionnel) : Si vous utilisez l'authentification par token
  4. Cliquez sur Save Configuration.

Note : Les appels API utilisent le format : https://yourserver/api/[endpoint].json?username=myuser&passhash=hash

Référence : Documentation PRTG HTTP API

Permissions requises

L'authentification utilisée doit disposer des permissions minimales suivantes :

  • Accès en lecture à l'inventaire des objets
  • Accès aux statuts des capteurs
  • Accès aux alertes et notifications