Bienvenue dans le guide de configuration pour l’intégration de Meraki avec Hector. À la fin de ce guide, vous serez en mesure de synchroniser automatiquement vos appareils Meraki avec les actifs dans Hector.
1. Connectez-vous à votre compte Hector
Vous devez être administrateur pour activer l’intégration avec Meraki.
2. Intégrations
Allez dans Paramètres, puis dans la section Intégrations vous trouverez Meraki dans l’onglet Inventaire.
Une fois dans les paramètres d’intégration, vous avez deux champs à compléter :
Pour l’URL de l’API, veuillez vous référer à la section Base URI dans le chapitre Getting Started de la documentation de l’API Meraki. Si vous avez un doute sur laquelle utiliser, essayez l’URL de base (https://api.meraki.com/api/v1) en cliquant sur Valider, un message d’erreur apparaîtra indiquant ce qui ne va pas.
La clé API est liée à un utilisateur et peut être trouvée dans Mon profil, sous la section Accès API.
Ou dans Organisation/API & Webhooks, dans l’onglet API keys and access.
Veuillez noter qu’une clé API est liée à un utilisateur, donc cet utilisateur doit avoir toutes les permissions nécessaires pour accéder aux réseaux et aux appareils que vous souhaitez importer dans Hector.
De plus, si vous révoquez la clé utilisée dans Hector, vous devrez la remplacer par une nouvelle pour que l’intégration continue de fonctionner.
3. Options
Une fois la clé API et l’URL saisies, cliquez sur Valider. Si tout est bon, vous serez redirigé dans un nouvel onglet où vous pourrez sélectionner les options souhaitées.
Destination initiale
Cette section correspond au Magasin et à la Catégorie par défaut vers lesquelles vos actifs seront dirigés.
Synchronisation
Ici, vous pouvez modifier la façon dont les actifs seront synchronisés dans Hector :
- Synchroniser les catégories : de nouvelles catégories seront créées selon les types de produits Meraki ou le type de système s’il s’agit d’un appareil dans un Systems Manager.
- Synchroniser l’emplacement : permet d’assigner automatiquement l’actif à un magasin en fonction des données présentes dans l’attribut choisi dans Assigner selon l’unité d’organisation. Pour une explication plus détaillée, voir la section Exemple de synchronisation avec un Magasin.
- Types de produits : choisissez les types de produits que vous souhaitez importer, les Appareils de Systems Manager incluent tous les appareils contenus dans un Systems Manager, les autres types correspondent aux appareils disponibles dans Meraki.
Champs
Dans le sélecteur d’attributs, vous pouvez choisir les champs supplémentaires à importer dans Hector comme attributs. Notez que les attributs seront automatiquement créés s’il s’agit de la première fois que cet attribut est utilisé dans une intégration (toutes les intégrations utilisent les mêmes attributs), et son nom sera défini selon la langue de votre instance, pas celle de votre utilisateur.
Le N° de série et l’Adresse MAC Wifi sont nos clés de synchronisation, donc ils ne peuvent pas être décochés.
Correspondance des champs
Quand un appareil Meraki est créé dans Hector, les champs suivants sont renseignés :
| Champs Meraki | Champs Hector | Notes |
|---|---|---|
| Réseau | Magasin | Fais correspondre un réseau avec un magasin si l’option Synchroniser l’emplacement est cochée. Sinon, l’actif est placé dans le magasin par défaut. |
| Type | Catégorie | Fais correspondre un type avec une catégorie si l’option Synchroniser les catégories est cochée. Sinon, l’actif sera placé dans la catégorie par défaut. |
| Modèle | Sous-catégorie | |
| Date de création | Date de création | |
| Nom | Titre | |
D’autres champs pourront être synchronisés suivant les attributs choisis dans l’onglet Champs.
Exemple de synchronisation avec un Magasin
Dans Synchronisation, j’ai choisi l’attribut meraki link pour faire le lien entre les réseaux et les magasins.
Dans Meraki, je vais copier le nom de mon réseau, ici, Hector.
Dans Hector, je vais dans le magasin où je veux que les appareils du réseau Hector soient placés, et je colle le nom du réseau dans mon attribut de liaison meraki link.
Désormais, vos appareils du réseau Hector se synchroniseront dans l’entrepôt Hector. Si le nom du réseau saisi dans l’attribut comporte une erreur, l’appareil sera placé dans l’entrepôt par défaut sélectionné lors des étapes précédentes.
Ceci conclut le guide d’intégration Meraki. Si vous avez des questions ou si vous souhaitez obtenir de l’aide pour l’intégration dans votre environnement, veuillez contacter notre équipe commerciale pour plus d’informations.