Connecteur RG System

Catégorie : Matériel · Type : import (inbound) · Cible : parc informatique (dsi_hw)

Le connecteur RG System (RG System Suite, RMM by Septeo) importe automatiquement le parc d'agents supervisés — postes, serveurs, mobiles — d'un nœud client RG System dans le parc informatique d'Isi-APP. C'est le même principe que le connecteur Microsoft Intune : une récupération compare l'inventaire RG System à votre parc, puis vous validez chaque changement avant qu'il ne soit écrit.

Ce que fait le connecteur

• Récupère les agents (machines) supervisés sur un nœud RG System (compte MSP → nœud client).
• Compare cet inventaire à votre parc et présente les changements à valider : créations, modifications (avec le détail des champs qui changent) et archivages (agents disparus de RG System). Rien n'est écrit dans votre parc sans votre confirmation.
• Évite les doublons avec le parc existant : un agent dont le numéro de série correspond à une machine déjà présente (importée par OCS ou saisie à la main) est rattaché à cette machine au lieu d'en créer une nouvelle.

Pré-requis

• Le module Informatique doit être souscrit par votre structure.
• L'installation et le paramétrage du connecteur sont réservés aux administrateurs (accès au Store — voir README.md pour le détail des profils autorisés).
• Un jeton d'API RG System, créé dans le dashboard RG System, depuis My Profile → API Token. Sa création exige la clé API du compte (« API Key »), que seul le support RG fournit à un administrateur ou gestionnaire de compte — prévoyez ce délai avant de configurer le connecteur.
• L'identifiant du nœud client à importer, visible dans l'URL du dashboard RG System une fois ce nœud sélectionné.

Configuration de l'instance

Dans Store → Mes connecteurs → RG System → Configurer :

Le jeton n'est jamais réaffiché : un champ laissé vide conserve la valeur enregistrée. Il n'y a aucune URL à saisir : l'adresse de l'API RG System est fixe.

ℹ️ L'entité de rattachement n'est PAS configurée sur le connecteur. Comme pour Intune, aucune entité par défaut : elle se choisit obligatoirement (adresse en option) au moment de valider les créations.

Configuration rapide (modale)

Depuis la page de l'instance, le bouton « Configuration rapide » ouvre une modale permettant de saisir/modifier directement le nœud et le jeton d'API, sans passer par la page de configuration complète. Un bouton « Tester la connexion » y valide immédiatement le jeton (appel authentifié à l'API RG System) et affiche le résultat.

Extraction & validation

Depuis la fiche de l'instance, bouton « Récupération & validation RG System » → page dédiée :

1. Récupérer & comparer : lance la récupération de l'inventaire (en tâche de fond, suivi en direct). À la fin, les compteurs s'affichent (X à créer, Y à modifier, Z à archiver).
2. Valider : trois onglets (Créations / Modifications / Archivages). Les agents sont présentés sous forme de cartes qui reprennent tout le pedigree RG : machine (modèle, processeur, mémoire, disque, clé Windows), système (OS, date d'installation), réseau (domaine, nom DNS, IP privée et publique, MAC), dernier utilisateur, sécurité (antivirus, Windows Update, sauvegarde RG, maintenance en cours), agent (version, plateforme, nœud, date d'installation, tags, commentaire RG) et activité (dernier démarrage, dernière connexion, dernière communication, dernière déconnexion, en heure locale). Les champs vides ne sont pas affichés. Chaque carte porte aussi un badge de type coloré (portable, poste fixe, smartphone, tablette, serveur) et un indicateur de connexion (agent connecté / déconnecté). Une barre de recherche (nom, n° de série, identifiant d'agent) et un filtre par type permettent de cibler rapidement. Pour chaque carte vous pouvez appliquer ou ignorer ; ou agir en masse (tout sélectionner, appliquer la sélection). Les modifications affichent le détail avant → après.
3. Sur l'onglet Créations, vous devez choisir une entité de rattachement (obligatoire) et, en option, une adresse (filtrée selon l'entité) ; l'application est bloquée tant qu'aucune entité n'est sélectionnée. Un lien vers la fiche matériel est proposé sur les modifications et archivages déjà rattachés à une machine existante.
4. Sur l'onglet Archivages, l'application demande une confirmation explicite avant d'archiver — aussi bien pour la sélection que pour le bouton d'une carte : archiver retire la machine du parc actif, un mis-clic ne doit pas suffire. Les onglets Créations et Modifications gardent le clic direct.

La récupération peut aussi être planifiée (onglet « Automatisation ») : elle prépare les changements à valider, mais n'applique rien automatiquement — la validation reste manuelle. Une récupération planifiée est ignorée si une extraction est déjà en cours sur l'instance.

Ce qui est importé

Le connecteur renseigne directement, quand l'agent les fournit : le nom, le n° de série, la clé produit Windows, le fabricant, le modèle, le processeur, la mémoire (RAM) et le stockage. Le type (poste fixe / portable / smartphone / tablette / serveur) n'est posé que lorsque RG System permet de trancher — il n'écrase jamais un type déjà renseigné par ailleurs.

Le fabricant est un champ obligatoire de la fiche matériel : la marque remontée par l'agent est rapprochée du référentiel des fabricants (« Dell Inc. » devient DELL, « Cisco Meraki MR44 » devient CISCO MERAKI). Quand la marque n'y figure pas, la fiche est créée avec « .. AUTRE MARQUE .. » — à corriger si besoin, mais la fiche reste enregistrable.

Fiches déjà importées sans fabricant : au prochain « Récupérer & comparer », elles apparaissent dans l'onglet Modifications avec le fabricant à renseigner (la marque reconnue, ou « .. AUTRE MARQUE .. ») ; il suffit d'appliquer la modification pour les débloquer. En revanche, sur une machine qui a déjà un fabricant, une marque non reconnue ne remplace jamais celle qui est en place.

Toutes les autres informations utiles sont regroupées dans le commentaire de la fiche matériel : constructeur, OS (nom + version), domaine, adresses IP (privée et publique), adresse MAC, dernier utilisateur connecté, antivirus, état Windows Update (critique / optionnel, avec le nombre de correctifs), version et type d'agent, dernier démarrage, état de connexion, nœud et identifiant d'agent RG System. La dernière connexion de l'agent alimente par ailleurs la date de « dernier inventaire » de la fiche.

Règles métier visibles

• Jamais de suppression : archivage. Un agent disparu de RG System voit sa fiche archivée (réversible), jamais supprimée définitivement.
• Pas de résurrection : une fiche archivée manuellement par un administrateur n'est jamais recréée, même si l'agent est toujours actif dans RG System.
• Cohabitation avec OCS : une machine déjà connue par son numéro de série (importée par OCS ou saisie à la main) est mise à jour, jamais dupliquée.
• Garde-fous : un inventaire vide ou manifestement tronqué, un changement de nœud sur l'instance, ou une proportion d'archivages anormalement élevée suspendent les archivages — l'écran de récupération l'annonce (état « Erreur » et message explicatif), sans bloquer les créations et modifications déjà identifiées.
• Modifications ciblées : seules les informations d'inventaire sont mises à jour ; l'entité, l'adresse et l'utilisateur principal réglés à la main sont préservés.
• Utilisateur : à la création, si le dernier utilisateur connecté sur l'agent correspond (par identifiant de connexion) à un unique utilisateur Isi-APP de votre structure, il est rattaché comme utilisateur principal. Sinon, l'information reste dans le commentaire.

État en direct d'une machine

En complément de l'import périodique ci-dessus, deux écrans affichent l'état instantané d'une machine supervisée par RG System. Rien n'y est jamais écrit, ni dans votre parc ni chez RG System : c'est de la lecture seule.

Onglet « RG System » de la fiche matériel

Quand une machine est rattachée à un agent RG System et que le connecteur est actif pour votre structure, la fiche du matériel affiche un onglet « RG System », à côté de l'onglet « Informations ». Cet onglet ne se charge qu'à son ouverture : tant que vous ne cliquez pas dessus, aucune information n'est demandée à RG System.

Vous y trouvez :

• Connexion : connecté / déconnecté / inconnu, avec la date du dernier contact et de la dernière connexion, la version de l'agent, le nœud, la plateforme, les adresses IP privée et publique, et des indicateurs « en maintenance » / « redémarrage en attente » ;
• Incidents : les alertes ouvertes remontées par la supervision, par élément surveillé (disque, service…) ;
• Windows Update : statut global, nombre de correctifs critiques et optionnels, et le détail des correctifs en attente ;
• Sécurité : état du module Cybersécurité et antivirus détecté sur la machine ;
• Services Windows, dans une liste filtrable et cherchable par nom — par défaut, seuls les services surveillés et à l'arrêt sont affichés, la seule situation qui appelle une action de votre part ;
• Vulnérabilités : nombre de vulnérabilités connues et date du dernier scan ;
• Processus en cours sur la machine.

Un bouton « Actualiser » force une relecture immédiate plutôt que d'attendre le prochain rafraîchissement automatique ; il est limité à une fois par minute par machine.

Si RG System ne répond pas (ou seulement pour une partie des informations), une alerte le signale à la place de la section concernée — le reste de l'onglet et de la fiche restent utilisables.

Pastille « RG System » dans les listes Matériels

Quand votre structure a un connecteur RG System actif, une colonne « RG System » apparaît dans les listes de matériels (masquable comme les autres colonnes). Elle affiche, pour chaque machine rattachée à un agent :

• une pastille de connexion (connecté / déconnecté / inconnu) ;
• le nombre d'incidents en cours, s'il y en a ;
• un repère si un correctif Windows critique est en attente.

Une machine non rattachée à RG System affiche un simple tiret. Cette colonne se calcule en un seul appel par instance RG System active toutes les 15 minutes — jamais un appel par ligne du tableau. Elle est absente si aucun connecteur RG System n'est actif pour votre structure, et n'est jamais incluse dans un export : c'est un état instantané, pas une donnée de votre parc.

Limites de la lecture en direct

• Ce sont des valeurs instantanées : ni historique, ni graphique d'évolution.
• Sur un nœud RG System de plus de 1000 agents, la pastille de certaines machines peut être absente (l'API RG System ne renvoie qu'un nombre borné d'agents par nœud pour cet écran).
• Quand RG System est lent ou injoignable, l'onglet abandonne au bout d'une dizaine de secondes : les sections déjà obtenues s'affichent, les autres portent « Lecture interrompue ». C'est volontaire — mieux vaut un onglet partiel tout de suite qu'une page qui tourne une minute puis échoue. Un second affichage, ou le bouton « Actualiser », retente les sections manquantes.

Alertes RG System

En complément de l'import du parc et de la lecture en direct ci-dessus, le connecteur rapatrie également les alertes de supervision RG System (les « tickets » RG : disque saturé, agent muet, service tombé…) et les conserve dans Isi-APP, avec leur historique. Contrairement à la lecture en direct, ces alertes sont stockées : vous les retrouvez même après leur fermeture côté RG.

Où les consulter

• Page Matériels → « Alertes RG System » (bouton dans l'en-tête de la liste Matériels, avec un badge indiquant le nombre d'alertes en cours) : vue d'ensemble, toutes machines confondues.
• Sur la fiche d'une machine, un bloc « Alertes » en tête de l'onglet « RG System » reprend les alertes en cours de cette machine, ainsi que ses dernières alertes fermées (20 au maximum ; l'historique complet reste accessible depuis l'écran ci-dessus).

Les deux écrans sont en lecture seule : les alertes se gèrent depuis la console RG System, jamais depuis Isi-APP.

Ce que vous y trouvez

Pour chaque alerte : sa criticité (critique / moyenne / faible), son état (ouverte / acquittée / fermée), la machine concernée (avec un lien vers sa fiche), le plugin RG et l'objet surveillé à l'origine de l'alerte (un disque, un service…), un message détaillé, et ses dates (ouverture, acquittement, fermeture). Un lien vers la console RG System est proposé quand RG le fournit.

L'écran « Alertes RG System » propose une recherche (titre, message, objet, nom de machine), des filtres (criticité, état, période d'ouverture) et un export, au même format que les autres tableaux de l'application.

Cadence de synchronisation

Les alertes sont relues toutes les 15 minutes. Une alerte nouvellement ouverte côté RG apparaît donc dans Isi-APP au plus tard un quart d'heure après.

Règles visibles

• Une alerte disparue de la liste active de RG System passe « Fermée » : la date de fermeture affichée est alors celle de cette détection, pas nécessairement le moment exact où l'incident a été résolu côté RG.
• Une alerte acquittée ne se ferme jamais par cette règle de disparition : elle reste affichée tant que RG System ne la sert pas explicitement comme fermée. Acquitter n'est pas résoudre.
• Des garde-fous suspendent les fermetures automatiques quand la lecture RG paraît incomplète ou anormale (connexion en échec, réponse tronquée, réponse qui contredit son propre filtre, ou proportion d'alertes qui se fermeraient d'un coup jugée excessive). Dans ce cas, aucune alerte n'est fermée à tort : elles restent affichées comme avant, jusqu'à ce qu'une synchronisation normale reprenne.
• Rétention : une alerte fermée depuis plus de 90 jours est archivée (durée réglable en configuration applicative, pas depuis un écran). Une alerte encore ouverte ou acquittée n'est jamais archivée, quelle que soit son ancienneté.

Limites

• Aucun ticket RG réel n'a pu être observé au moment de la conception de cette fonctionnalité : la correspondance des champs d'une alerte est une hypothèse, à confirmer et ajuster dès la première alerte réelle rencontrée. Un champ non reconnu s'affiche en « Inconnu » plutôt que d'être deviné.
• Aucune notification (mail, centre de notifications) n'est envoyée à l'ouverture d'une alerte : la consultation reste manuelle, sur les deux écrans ci-dessus.
• Aucun acquittement ni aucune fermeture ne peut être fait depuis Isi-APP : ces actions se font exclusivement dans la console RG System.
• Historique figé si le connecteur est désactivé : les alertes déjà rapatriées restent consultables, mais ne sont plus tenues à jour. Un bandeau sur la fiche matériel le signale dans ce cas.

Actions à distance

En complément de la lecture (import, état en direct, alertes), le connecteur permet de déclencher quelques actions sur une machine supervisée. C'est la seule fonctionnalité de ce connecteur qui écrit vers RG System : les autres écrans restent en lecture seule.

Qui peut lancer une action

Réservé aux profils administrateurs et internes de votre structure (Isi-APP admin, DSI/RSI, Commercial, Chef de projet, RH, Administrateur global) — jamais aux sous-traitants, dont l'accès au parc reste un accès de lecture délégué par le client. Il faut de surcroît disposer du droit de modification sur le module Matériels : un profil autorisé mais placé en lecture seule sur ce module par son entité mère ne voit pas ces actions.

Où les lancer

Depuis la fiche d'une machine rattachée à RG System, onglet « RG System », panneau « Actions » — entre les alertes de supervision et l'état en direct de la machine.

Les six actions

Chaque action demande une confirmation qui nomme explicitement la machine visée (et le service concerné, le cas échéant) : jamais un bouton qui agit sans rappeler sa cible.

Le journal

Un journal, sous les boutons d'action, conserve les dernières demandes de la machine : qui les a lancées, quand, quoi, et leur statut. Le bouton « Vérifier les statuts » relit auprès de RG System les demandes encore en attente (limité à deux relectures par minute et par personne).

Comprendre un statut

• Envoyée : RG System a accepté la demande de redémarrage ou d'action sur un service ; son exécution reste à confirmer. Elle devient ensuite Confirmée (RG rapporte un succès), Échouée (RG rapporte un échec), ou Non confirmée si RG ne s'est jamais prononcé dans le délai imparti — ce n'est pas un échec, seulement l'aveu qu'on ne sait pas.
• Acceptée par RG System : concerne le réveil réseau, la maintenance et les correctifs. RG a pris la demande, mais rien ne permet à Isi-APP de vérifier ensuite si elle s'est bien exécutée.
• Refusée : rien n'est parti — droit insuffisant, quota dépassé, machine déjà occupée par une autre action, ou paramètres incomplets (service non sélectionné, adresse MAC ou relais manquant…).

Mode assistance

Si un assistant ISI agit au nom d'un client (mode assistance), le journal nomme les deux personnes : celle au nom de qui l'action est enregistrée, et l'assistant qui l'a réellement déclenchée.

Limites

• Une seule action à la fois par machine : une deuxième demande sur la même machine est refusée tant que la précédente n'est pas terminée.
• 5 actions par minute et par personne, tous types confondus.
• Pas de sélection multiple : chaque action se lance sur une machine à la fois.
• Pas de script personnalisé : seules les six actions ci-dessus sont proposées.
• Les réponses réelles de RG System à une action n'ont pas pu être observées avant la mise en service : les statuts « Acceptée » sont à confirmer à l'usage, au fil des premières actions réellement lancées.

Rétention du journal

Une demande terminée (Confirmée, Échouée, Acceptée, Refusée ou Non confirmée) est conservée 365 jours avant d'être archivée. Une demande encore « Envoyée » n'est jamais archivée.

Limites actuelles

• Pas d'inventaire logiciel (applications installées).
• Pas de suivi des garanties constructeur.
• Une instance = un nœud : pour importer plusieurs nœuds clients, il faut une instance par nœud.
• Le jeton d'API a une date de fin (visible dans le dashboard RG System) : à son expiration, le test de connexion échoue et un nouveau jeton doit être créé et enregistré.
• Alertes : mapping à confirmer sur un premier ticket réel, pas de notification, pas d'acquittement/fermeture depuis Isi-APP (cf. « Alertes RG System » ci-dessus).
• Actions à distance : une machine à la fois, 5 actions par minute et par personne, pas de sélection multiple ni de script personnalisé ; les statuts « Acceptée » (réveil réseau, maintenance, correctifs) restent à confirmer sur les premières actions réelles, RG System n'ayant jamais pu être observé en train de répondre à une action avant la mise en service. La prise en main à distance (contrôle de l'écran) n'est pas disponible.

FAQ

Le connecteur peut-il supprimer des machines de mon parc ? Non : une machine disparue de RG System est archivée, jamais supprimée. Vous pouvez toujours la retrouver et la désarchiver.

Puis-je utiliser RG System et OCS sur le même parc ? Oui : une machine reconnue par son numéro de série n'est jamais dupliquée, quelle que soit la source qui l'a créée en premier.

Pourquoi mes archivages n'apparaissent-ils plus après un changement de nœud ? C'est volontaire : le connecteur suspend les archivages tant que les correspondances de l'ancien nœud n'ont pas été réinitialisées, pour éviter d'archiver tout un parc par erreur.

Le test de connexion échoue, que vérifier ? Le jeton d'API (valeur et date de fin dans le dashboard RG System) et l'identifiant du nœud.

Puis-je acquitter ou fermer une alerte depuis Isi-APP ? Non : ces actions se font uniquement dans la console RG System. Isi-APP n'en est qu'un miroir en lecture seule, mis à jour toutes les 15 minutes.

Pourquoi une de mes alertes fermées a-t-elle réapparu ? Une alerte n'est rouverte que si RG System la sert lui-même à nouveau comme active. Si elle a disparu de la liste RG puis y est revenue, Isi-APP la rouvre au passage suivant.

Puis-je lancer une action sur plusieurs machines à la fois ? Non : chaque action (redémarrage, service, réveil, maintenance, correctifs) se lance sur une seule machine, et une seule à la fois par machine.

Que signifie un statut « Acceptée par RG System » ? Pour le réveil réseau, la maintenance et les correctifs : RG System a pris la demande, mais rien ne permet à Isi-APP de vérifier ensuite qu'elle s'est bien exécutée sur la machine.

Pourquoi une action reste-t-elle « Non confirmée » ? Parce que RG System n'a pas répondu dans le délai prévu. Ce n'est pas un échec constaté : c'est l'aveu qu'Isi-APP ne sait pas dire ce qu'il s'est passé.

Puis-je prendre la main à distance sur l'écran d'une machine depuis Isi-APP ? Pas pour le moment : seules les six actions listées ci-dessus sont disponibles.