EasyVista
Intégrez EasyVista pour récupérer l'inventaire des assets IT
Le connecteur EasyVista permet de récupérer les données de gestion d'actifs informatiques, les tickets ITSM et les informations utilisateur de votre plateforme EasyVista directement dans OverView.
Objectif
Le connecteur EasyVista permet de récupérer les informations suivantes :
- Inventaire des assets IT (matériel, postes de travail, serveurs, équipements réseau)
- Caractéristiques des assets (adresse IP, adresse MAC, OS, RAM, disque, processeur)
- Localisation des assets et utilisateur associé
Prérequis
- Accès administrateur EasyVista (pour activer le module Access Tokens)
- Connectivité réseau entre OverView et votre endpoint API EasyVista
Informations à fournir dans OverView
| Champ | Description |
|---|---|
| URL du service | URL de base de votre API EasyVista (ex : https://api.easyvista.com) |
| Compte | Identifiant du compte, ex. 50004 (production) |
| Jeton Bearer | Jeton d'accès natif EasyVista — méthode recommandée |
| Identifiant client | Identifiant client OAuth 2.0 — alternatif au Bearer Token |
| Secret client | Secret client OAuth 2.0 |
| URL de la passerelle d'authentification | URL du serveur d'autorisation OAuth (ex : https://login.microsoftonline.com) |
| ID du locataire | Identifiant de tenant Azure AD |
| Clé d'abonnement | Clé d'abonnement Azure API Management (optionnel) |
| Version de l'API | Version de l'API à utiliser |
Paramètres
Ces paramètres sont facultatifs. Conservez leur valeur par défaut sauf besoin particulier.
| Paramètre | Description | Défaut |
|---|---|---|
| Catégories exclues | Les actifs dont la catégorie correspond à l'une de ces valeurs ne sont pas importés. Laisser vide pour tout importer. Une valeur correspond à n'importe quel niveau de l'arborescence du catalogue : un chemin complet (Matériels/IT/Videos/Ecrans) comme un seul niveau (Ecrans) fonctionne, sans tenir compte de la casse. Les catégories disponibles sont listées dans Références > Catalogues > Catalogue des matériels. | — |
Procédure
Générer un Bearer Token (Recommandé)
Le jeton d'accès natif EasyVista (Service Manager Access Token) est la méthode d'authentification recommandée. Elle offre un niveau de sécurité supérieur à l'authentification Basic et ne nécessite pas d'infrastructure OAuth.
Étape 1 — Activer le module Access Tokens
Nécessite un accès administrateur EasyVista.
- Allez dans Administration > Access Management > User Profiles.
- Sélectionnez le profil utilisateur qui gérera le jeton.
- Activez l'entrée de menu Administration > Access Management > Access Tokens.
Étape 2 — Générer le jeton
- Allez dans Administration > Access Management > Access Tokens.
- Cliquez sur + New.
- Saisissez un nom pour le jeton et sélectionnez l'utilisateur autorisé, puis cliquez sur Generate.
- La valeur du jeton est automatiquement copiée dans le presse-papiers. Collez-la immédiatement dans un éditeur de texte — elle ne sera plus affichée une fois la boîte de dialogue fermée. Le jeton reste valide jusqu'à sa révocation explicite.
Étape 3 — Configurer le connecteur dans OverView
- Dans OverView, allez à Data Sources Settings > Sources.
- Sélectionnez EasyVista et cliquez sur Configure.
- Renseignez les champs URL et Bearer Token.
- Cliquez sur Save Configuration.
Alternative : OAuth 2.0 Client Credentials
Si votre instance EasyVista est configurée avec Azure AD et qu'OAuth 2.0 est disponible, contactez le support OverSOC pour mettre en place cette méthode d'authentification. Vous devrez fournir votre Client ID, Client Secret, l'URL de l'Auth Gateway et le Tenant ID.
Permissions requises
L'utilisateur associé au jeton doit disposer d'un accès en lecture aux :
- Catalogue des assets (endpoint
/assets) - Caractéristiques des assets (endpoint
/asset-characteristics)
Documentation officielle
Pour plus d'informations, consultez la documentation EasyVista REST Web Service.
Alternative : import par fichiers via DropPoint
L'accès API décrit plus haut est la méthode recommandée pour ce connecteur. Lorsqu'il n'est pas disponible (réseau cloisonné, version ou licence sans API, export déjà produit par ailleurs), OverView accepte des exports de fichiers, à déposer dans le bucket dédié à EasyVista.
Bucket : s3://easyvista/
Exemple : s3://easyvista/export.csv
La procédure est décrite dans le guide OverView DropPoint : génération des credentials, configuration du client, puis envoi des fichiers depuis l'interface web OverView, l'AWS CLI ou un SDK. Les exemples y sont préremplis avec ce bucket lorsque vous suivez ce lien.