LibreNMS LibreNMS

Configurez le connecteur LibreNMS pour paramétrer l'accès API et récupérer les informations

Objectif

Le but de ce document est de fournir une procédure pour mettre en place l'API LibreNMS et générer le jeton API (X-Auth-Token) requis pour récupérer les informations de surveillance réseau depuis LibreNMS.

À l'issue de cette procédure, vous serez en mesure de fournir :

  • IP/URL du serveur
  • Jeton API (X-Auth-Token)

Création des identifiants d'accès

  1. Connectez-vous à la console LibreNMS avec un utilisateur ayant les droits administrateur.
  2. Accédez à Settings > API access.
  3. Cliquez sur Create API access token.
  4. Sélectionnez l'utilisateur pour lequel générer le jeton.
  5. Copiez le jeton API généré (X-Auth-Token).
  6. Stockez le jeton de manière sécurisée pour l'utiliser dans la configuration OverSOC.
  7. Le jeton peut également être récupéré via un QR Code s'il est disponible dans votre version.

Étapes de configuration

1. Configuration du compte utilisateur

  1. Assurez-vous que vous disposez d'un compte utilisateur avec les permissions appropriées
  2. Le compte doit avoir accès en lecture aux informations des appareils
  3. Vérifiez que l'utilisateur peut accéder à la section des paramètres API

2. Génération du jeton API

  1. Accédez à Settings > API access
  2. Cliquez sur Create API access token
  3. Sélectionnez l'utilisateur et créez le jeton
  4. Copiez le jeton API généré immédiatement
  5. Stockez le jeton de manière sécurisée pour la configuration OverSOC

3. Configurer dans OverSOC

  1. Dans OverSOC, accédez à Data Sources Settings > Sources.
  2. Sélectionnez LibreNMS et cliquez sur Configure.
  3. Entrez l'URL du serveur LibreNMS (nom d'hôte ou adresse IP).
  4. Collez le jeton API dans le champ d'authentification.
  5. Utilisez l'en-tête X-Auth-Token pour l'authentification.
  6. Cliquez sur Save Configuration.

Authentification

Le connecteur LibreNMS utilise l'authentification par jeton API avec l'en-tête X-Auth-Token.

Test de l'accès API

Vous pouvez tester le jeton API en utilisant curl :

curl -H "X-Auth-Token: YOUR_TOKEN" "https://YOUR_SERVER/api/v0/devices"

Recommandations de sécurité

  • Utilisez HTTPS pour la communication API
  • Faites tourner régulièrement les jetons API
  • Surveillez les journaux d'accès API
  • Limitez l'accès API aux plages d'adresses IP nécessaires

Documentation officielle

Pour plus d'informations, consultez la Documentation de l'API LibreNMS

Précédent← CentreonSuivantPRTG Network Monitor →