Freshservice
Intégrez Freshservice pour récupérer l'inventaire de votre CMDB
Le connecteur Freshservice permet de récupérer l'inventaire de votre CMDB Freshservice (assets, caractéristiques matérielles, utilisateurs et localisations) directement dans OverView.
Objectif
Le connecteur Freshservice permet de récupérer les informations suivantes :
- Inventaire des assets CMDB (postes de travail, serveurs, VM, équipements réseau, mobiles, imprimantes)
- Caractéristiques matérielles (numéro de série, constructeur, modèle, processeur, mémoire, espace disque)
- Informations réseau (nom d'hôte, domaine, adresse IP, adresse MAC)
- Système d'exploitation et version
- Utilisateurs associés aux assets (requesters et agents : nom, prénom, e-mail, fonction)
- Localisations (site, adresse, ville, pays, code postal)
- Métadonnées : département, groupe, asset tag, état de l'asset, criticité (dérivée de l'impact)
Prérequis
- Un compte Freshservice avec un rôle disposant d'un accès en lecture à la CMDB et aux utilisateurs
- La clé API (API Key) de ce compte
- Connectivité réseau entre OverView et votre instance Freshservice (
https://<votre-domaine>.freshservice.com)
Informations à fournir dans OverView
| Champ | Description |
|---|---|
| Domaine | Sous-domaine Freshservice (ex : acme pour acme.freshservice.com) |
| Clé API | Clé API du compte de service Freshservice |
| URL de l'API | URL de base personnalisée de l'API (optionnel — remplace l'URL construite à partir du domaine) |
Procédure
Étape 1 — Créer un compte de service (recommandé)
- Connectez-vous à votre instance Freshservice avec un compte administrateur.
- Allez dans Admin > User Management > Agents.
- Créez un agent dédié à l'intégration (par exemple
OverView Connector). - Attribuez-lui un rôle en lecture seule couvrant les assets, les utilisateurs et les objets de référence (voir Permissions requises).
Étape 2 — Récupérer la clé API
- Connectez-vous avec le compte de service créé à l'étape précédente.
- Cliquez sur votre avatar en haut à droite, puis sur Profile settings.
- Dans le panneau de droite, section Your API Key, cliquez sur View API Key puis copiez la clé.
La clé API est liée à l'agent connecté et hérite de ses permissions. Si le compte est désactivé ou si son rôle change, l'import échouera ou renverra des données incomplètes.
Étape 3 — Configurer le connecteur dans OverView
- Dans OverView, accédez à Data Sources Settings > Sources.
- Sélectionnez Freshservice et cliquez sur Configure.
- Renseignez les champs :
- Domain : votre sous-domaine, sans
.freshservice.com(ex :acme) - API Key : la clé copiée à l'étape 2
- API URL : à renseigner uniquement si votre instance utilise une URL d'API personnalisée
- Domain : votre sous-domaine, sans
- Cliquez sur Save Configuration.
Permissions requises
Le compte associé à la clé API doit disposer d'un accès en lecture aux endpoints suivants de l'API v2 :
| Endpoint | Usage |
|---|---|
/agents/me | Validation des identifiants |
/assets | Inventaire des assets (avec include=type_fields) |
/asset_types | Libellés des types d'assets |
/departments | Départements |
/locations | Localisations et adresses |
/vendors | Constructeurs |
/products | Modèles de produits |
/groups | Groupes |
/requesters | Utilisateurs (requesters) |
/agents | Utilisateurs (agents) |
Documentation officielle
Pour plus d'informations, consultez la documentation de l'API Freshservice v2.
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é à Freshservice.
Bucket : s3://freshservice/
Exemple : s3://freshservice/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.