Introduction
Regentra est une plateforme PSA et de conformité combinée pour les MSP. Son intégration Level importe les appareils que vous gérez dans Level vers Regentra en tant qu'actifs, afin qu'ils apparaissent dans l'inventaire des actifs de Regentra, dans les tickets et dans votre portail client.
La configuration est rapide et se déroule principalement dans Regentra. Dans Level, vous créez une clé API en lecture seule, et éventuellement un webhook afin que les modifications d'appareils parviennent à Regentra en quelques secondes plutôt qu'en attendant la prochaine synchronisation planifiée.
ℹ️ REMARQUE : Cette intégration a été créée et est maintenue par Regentra. Pour la partie Regentra de la configuration, consultez leur documentation : Intégration Level.io RMM.
⚙️ PRÉREQUIS
Accès administrateur Level. Les clés API et les webhooks sont réservés aux administrateurs.
Un compte Regentra avec accès à Paramètres → Intégrations.
Intégration Regentra
Créer une clé API dans Level
Regentra utilise une clé API Level pour lire votre inventaire d'appareils.
Dans Level, accédez à Paramètres → Clés API.
Cliquez sur + Créer une clé API.
Saisissez une Description tel que « Intégration Regentra ».
Sélectionnez Lecture seule. Regentra lit les données des appareils depuis Level et n'écrit rien en retour, une clé en lecture seule est donc suffisante.
Cliquez sur Créer la clé, puis utilisez le menu à trois points sur la nouvelle ligne et choisissez Copier la clé.
Voir Paramètres des clés API pour tous les détails sur la gestion des clés.
Connecter Regentra à Level
Dans Regentra, accédez à Paramètres → Intégrations → Level.io RMM.
Collez la clé que vous avez copiée dans le Clé API champ.
Cliquez sur Tester la connexion pour confirmer que Regentra peut accéder à l'API Level.
Enregistrez la configuration, puis cliquez sur Synchroniser maintenant pour exécuter la première importation.
Après la première importation, Regentra récupère votre inventaire complet d'appareils selon son propre calendrier. Regentra le documente comme ayant lieu toutes les six heures.
Ce qui est synchronisé
Chaque appareil Level devient un actif dans Regentra, avec ces champs renseignés depuis Level :
Level | Actif Regentra |
Nom d'hôte | Nom de l'appareil |
Numéro de série | Numéro de série |
Système d'exploitation | SE |
Fabricant | Fabricant |
Modèle | Modèle |
État en ligne | Statut en ligne/hors ligne |
La synchronisation est unidirectionnelle. Regentra lit depuis Level et n'écrit jamais en retour, donc rien de ce que vous modifiez dans Regentra ne change un appareil dans Level.
ℹ️ REMARQUE : Level ne collecte pas les dates de garantie matérielle, donc les champs de garantie dans Regentra restent des saisies manuelles.
Envoyer des mises à jour d'appareils en temps réel avec un webhook
La synchronisation planifiée suffit pour la plupart des équipes. Ajoutez un webhook si vous souhaitez que les nouveaux appareils, les modifications d'appareils et les suppressions parviennent immédiatement à Regentra.
Dans Regentra, ouvrez Paramètres → Intégrations → Level.io RMM et copiez l'URL du point de terminaison du webhook.
Dans Level, accédez à Paramètres → Webhooks et cliquez sur + Ajouter un webhook.
Collez le point de terminaison Regentra dans le URL champ.
Si Regentra vous a fourni un secret de signature pour ce point de terminaison, collez-le dans Secret. Sinon, laissez-le vide. Level n'ajoute que l'
X-Level-Signatureen-tête lorsqu'un secret est défini, et le point de terminaison récepteur doit être conçu pour le vérifier.Laissez le bouton Activé activé.
Sous Événements à envoyer, choisissez Sélectionner les types à envoyer et cochez Appareil créé, Appareil mis à jour, et Appareil supprimé.
Cliquez sur Ajouter un webhook.
Regentra confirme la réception du premier événement et affiche le webhook comme Actif de son côté.
Voir Paramètres des webhooks pour le format de la charge utile, le journal de livraison et le comportement de nouvelle tentative.
Tester l'intégration
Confirmez que l'intégration Level.io RMM dans Regentra affiche Connecté.
Vérifiez par sondage la liste des actifs de Regentra par rapport à votre liste d'appareils Level.
Si vous avez configuré le webhook, renommez un appareil dans Level, puis ouvrez Paramètres → Webhooks → Requêtes dans Level et recherchez une Appareil mis à jour livraison avec un code de statut 2xx.
Si une livraison a échoué, cliquez sur la ligne pour lire le message d'erreur et le corps de la réponse. Level effectue jusqu'à trois nouvelles tentatives de livraison automatiquement, et vous pouvez cliquer sur Relancer la requête une fois la cause corrigée. Les causes courantes sont une URL de point de terminaison mal saisie, ou un secret défini d'un côté mais pas de l'autre.
Si des actifs sont manquants mais que le test de connexion fonctionne, la clé API est la première chose à vérifier. Une clé supprimée ou renouvelée arrête immédiatement la synchronisation et la carte d'intégration de Regentra bascule sur Erreur.
Gestion continue
Renouveler la clé : créez une nouvelle clé API dans Level, collez-la dans Regentra, testez la connexion, puis supprimez l'ancienne clé. La suppression d'une clé prend effet immédiatement, alors procédez dans cet ordre.
Mettre en pause les mises à jour en temps réel : désactivez le webhook dans Level. La synchronisation planifiée continue de fonctionner.
Arrêter l'intégration : supprimez la clé API de Regentra, ou supprimez la clé dans Level.
Appareils supprimés : la suppression d'un appareil dans Level ne supprime pas son actif Regentra. Regentra conserve l'enregistrement pour l'historique et met à jour son statut.
⚠️ AVERTISSEMENT : Si vous connectez à la fois Level et NinjaOne à la même organisation Regentra, Regentra traite NinjaOne comme la source d'appareils prioritaire et retire la copie Level de tout appareil qui apparaît dans les deux. Consultez la documentation de Regentra sur Intégration NinjaOne RMM documentation.
FAQ
Dois-je activer Regentra sur la page Intégrations de Level ? Non. Paramètres → Intégrations dans Level couvre ConnectWise PSA, HaloPSA, Zest, Hudu et DeskDay. Regentra se connecte via l'API Level et, éventuellement, un webhook, donc il n'y a rien à activer là-bas.
La clé API doit-elle être en lecture seule ou en lecture et écriture ? Lecture seule. Regentra ne lit que les appareils depuis Level. Si un test de connexion ou une synchronisation échoue avec une erreur de permissions, consultez Regentra avant d'élargir la clé.
Le webhook est-il obligatoire ? Non. La synchronisation planifiée fonctionne sans lui. Le webhook ne fait qu'ajouter des mises à jour quasi instantanées pour les équipes qui ont besoin de données d'actifs actualisées entre les synchronisations.
Les alertes Level ouvrent-elles des tickets Regentra ? L'intégration Level de Regentra documente la synchronisation des appareils et des actifs, pas les alertes. Level peut envoyer des Alerte active et Alerte résolue événements vers n'importe quel point de terminaison, alors demandez à Regentra si leur point de terminaison les accepte avant d'ajouter ces types d'événements au webhook.
Pourquoi un appareil apparaît-il deux fois dans Regentra ? Regentra déduplique les appareils de Level par rapport aux appareils de Microsoft Entra ou Intune en faisant correspondre le numéro de série et le nom d'hôte. Un appareil sans numéro de série peut apparaître en double jusqu'à ce que vous les fusionniez. Consultez la documentation de Regentra sur Intégration Level.io RMM documentation.
Puis-je limiter les appareils Level qui sont synchronisés ? Le côté Level n'a pas de filtre. Une clé API en lecture seule peut lire tous les appareils de votre organisation Level, donc tout filtrage se fait dans Regentra.
Qui peut effectuer cette configuration ? Un administrateur Level, pour la clé API et le webhook, et un utilisateur Regentra ayant accès à Paramètres → Intégrations.