L’intégration Lansweeper vous permet d’importer automatiquement des appareils de tout type — postes de travail, serveurs, équipements réseau, appareils mobiles et plus encore — depuis votre environnement Lansweeper directement dans Hector. Une fois configurée, Hector se connecte à l’API infonuagique de Lansweeper selon un horaire défini et crée ou met à jour les actifs pour qu’ils correspondent à ce que Lansweeper a détecté. Ce guide vous explique comment générer votre jeton d’API dans Lansweeper et configurer l’intégration dans Hector.
Avant de commencer
- Un compte Lansweeper Cloud (Sites) comportant au moins un site avec des actifs analysés.
- La permission de créer une application personnelle dans votre compte Lansweeper (outils pour développeurs).
- Un accès administrateur à Paramètres > Intégrations dans Hector.
Étape 1 — Générer un jeton d’API Lansweeper
- Connectez-vous à votre compte Lansweeper à l’adresse app.lansweeper.com.
- Ouvrez le menu du compte dans le coin supérieur droit et accédez aux outils pour développeurs.
- Sélectionnez Applications personnelles, puis cliquez sur Ajouter une application personnelle.
- Donnez un nom à l’application (par exemple, Intégration Hector) et créez-la.
- Copiez le jeton généré (aussi appelé code d’identité) et conservez-le en lieu sûr — vous le collerez dans Hector à l’étape 3. Pour des raisons de sécurité, Lansweeper n’affiche le jeton complet qu’une seule fois.
Étape 2 — Autoriser vos sites
Lorsque vous créez l’application personnelle, Lansweeper vous demande à quels sites elle peut accéder. Assurez-vous que chaque site dont vous souhaitez importer les actifs dans Hector est autorisé. Hector découvre automatiquement tous les sites autorisés pour votre jeton et importe les actifs de chacun d’eux — il n’y a rien à saisir manuellement.
Étape 3 — Configurer l’intégration dans Hector
- Dans Hector, accédez à Paramètres > Intégrations et ouvrez Lansweeper.
- Activez le bouton Activé.
- Dans l’onglet Authentification, laissez l’URL de l’API à sa valeur par défaut (
https://api.lansweeper.com/api/v2/graphql) pour Lansweeper Cloud, puis collez votre jeton dans le champ Jeton. - Cliquez sur Valider. Hector confirme le jeton et la présence d’au moins un site autorisé.
- Dans l’onglet Configuration > Options, choisissez la réserve de destination et la catégorie par défaut des actifs importés.
- Dans l’onglet Synchronisation, activez au besoin Synchroniser la catégorie pour créer automatiquement une catégorie par type d’actif Lansweeper (Windows, Linux, écran, routeur, etc.).
- Dans l’onglet Champs, utilisez le sélecteur d’attributs pour choisir les champs à importer sur vos actifs.
- Cliquez sur Enregistrer.
Champs synchronisés
| Attribut Hector | Source Lansweeper |
|---|---|
| Nom de l’appareil | Nom de l’actif |
| Numéro de série | Numéro de série |
| Système d’exploitation | Libellé du SE |
| Version du système d’exploitation | Version du SE |
| Version du micrologiciel | Version du micrologiciel |
| Adresse MAC Ethernet | Adresse MAC |
| Adresse IP | Adresse IP |
| Nom du réseau | Nom de domaine complet (FQDN) |
| Nom d’utilisateur | Dernier utilisateur connecté |
| Domaine | Domaine |
| Fabricant | Fabricant |
| Type d’appareil | Type d’actif |
| Modèle | Modèle |
| Commentaire | Description |
Fonctionnement de la synchronisation
- La synchronisation s’exécute automatiquement une fois par jour. Vous pouvez aussi la déclencher manuellement depuis la page de l’intégration.
- Les actifs sont appariés selon leur identité Lansweeper : un appareil qui change de nom ou de numéro de série est donc mis à jour plutôt que dupliqué.
- Les nouveaux actifs Lansweeper sont créés dans la réserve et la catégorie que vous avez sélectionnées; les actifs existants correspondants sont mis à jour sur place.
- Seuls les champs sélectionnés dans le sélecteur d’attributs sont écrits — tout champ non sélectionné n’est jamais modifié par l’intégration.
Dépannage
- Échec de la validation / « Aucun site autorisé » : vérifiez que le jeton est exact et que votre application personnelle a accès à au moins un site dans Lansweeper.
- Jeton refusé : régénérez le jeton de l’application personnelle dans Lansweeper et collez la nouvelle valeur, car les jetons peuvent être révoqués ou expirer.
- Certains appareils sont manquants : assurez-vous que ces actifs ont été analysés et qu’ils figurent dans un site Lansweeper autorisé; les actifs des sites non autorisés ne sont pas importés.
- Les actifs sont classés dans la mauvaise catégorie : vérifiez la catégorie par défaut dans l’onglet Options, ou activez Synchroniser la catégorie pour refléter les types d’actifs de Lansweeper.
Voilà qui conclut le guide d’intégration de Lansweeper. Si vous avez des questions ou si vous avez besoin d’aide pour l’intégrer à votre environnement, n’hésitez pas à contacter notre équipe commerciale pour plus d’informations.