Matrix42 Matrix42

Intégrez Matrix42 Enterprise Service Management pour récupérer les ordinateurs de votre inventaire d'assets

Le connecteur Matrix42 récupère dans OverView les ordinateurs enregistrés dans Matrix42 Enterprise Service Management, via l'API de Matrix42.

Objectif

Le connecteur Matrix42 récupère les informations suivantes :

  • Ordinateurs de l'inventaire d'assets (nom, nom DNS, adresse IP, adresse MAC, numéro de série, fabricant et modèle, mémoire et processeur)
  • Système d'exploitation de chaque ordinateur
  • Utilisateur assigné et localisation de chaque ordinateur
  • Statut du cycle de vie de chaque ordinateur (par exemple Active ou Disposed)
  • Dates du premier et du dernier scan d'inventaire

Prérequis

  • Un compte ayant accès aux applications Administration et Master Data de Matrix42, pour créer la Person, le rôle utilisateur et le jeton API utilisés par OverView
  • Pour un serveur Matrix42 installé sur site : un OverView OutPost déployé dans votre réseau et un flux HTTPS autorisé de la VM OutPost vers le serveur Matrix42

Informations à fournir dans OverView

ChampDescription
URL du serveur*URL de base des web services Matrix42, telle que la VM OutPost la joint, sans slash final (ex. : https://matrix42.example.com/M42Services)
Jeton API*Jeton API généré ci-dessous

Paramètres

Ces paramètres sont facultatifs. Conservez leur valeur par défaut sauf besoin particulier.

ParamètreDescriptionDéfaut
Vérifier le SSLVérifier le certificat TLS du serveur Matrix42. À désactiver pour un serveur utilisant un certificat auto-signé ou interneActivé

Procédure

Créer une Person pour OverView

Le jeton API s'exécute avec les permissions de la Person à laquelle il est rattaché. Une Person dédiée à OverView limite ces permissions à ce que le connecteur lit.

  1. Ouvrez l'application Master Data et allez dans Users > Persons.
  2. Créez une Person nommée d'après son usage (ex. : OverView Connector).

Créer un rôle utilisateur en lecture seule

  1. Ouvrez l'application Administration et allez dans Security > User Roles.
  2. Cliquez sur Add User Role et saisissez un Name (ex. : OverView Read Only).
  3. Dans l'onglet Members, ajoutez la Person créée ci-dessus.
  4. Enregistrez le rôle, puis lancez l'action Set Permissions sur celui-ci.
  5. Sélectionnez le configuration item Computer, positionnez la permission read sur allowed et laissez toutes les autres permissions sur not set.
  6. Enregistrez les permissions.

Une permission laissée sur not set est refusée : le rôle n'accorde donc rien d'autre que la lecture des ordinateurs.

Générer le jeton API

  1. Dans l'application Administration, allez dans Integration > Web Service Tokens.
  2. Lancez l'action Generate New Token.
  3. Renseignez les champs :
    • Name : un nom unique (ex. : OverView)
    • Expires at : la durée de vie du jeton. La valeur par défaut est de 30 jours ; le connecteur cesse de fonctionner à l'expiration du jeton, choisissez donc une durée plus longue (1 year ou Never Expires, selon votre politique de sécurité) ou renouvelez le jeton avant cette date.
    • User : la Person créée ci-dessus
  4. Copiez immédiatement le jeton affiché sur la page de résultat de l'action : Matrix42 ne le conserve pas et ne l'affiche plus ensuite.

Configurer le connecteur dans OverView

  1. Dans OverView, allez dans Data Sources Settings > Sources.
  2. Sélectionnez Matrix42 et cliquez sur Configure.
  3. Pour un serveur Matrix42 installé sur site, choisissez votre OutPost comme point de collecte.
  4. Renseignez l'URL du serveur et le Jeton API.
  5. Cliquez sur Save Configuration.

Permissions requises

La Person rattachée au jeton API doit disposer d'un accès en lecture au configuration item Computer. Le connecteur effectue uniquement des lectures : il ne crée, ne modifie et ne supprime rien dans Matrix42.

L'utilisateur assigné et la localisation de chaque ordinateur sont lus dans les fiches des personnes et des localisations. Pour les récupérer, le même rôle doit aussi disposer de la permission read sur les configuration items des personnes et des localisations.

Si la connexion renvoie une erreur d'accès alors que le rôle est en place, vérifiez que les web services Matrix42 ne sont pas réservés à d'autres utilisateurs par leur Audience (application Administration, Web Services > Public API).

Documentation officielle