Meridian RMM — intégration Home Assistant

Superviser votre parc Meridian RMM depuis Home Assistant : agents en ligne / au repos / hors ligne, mises à jour en attente, redémarrages requis et incidents d'alerte ouverts, exposés en entités pour vos cartes et automatisations.

L'intégration est en lecture seule : elle interroge l'API d'intégration de Meridian (/api/v1/integration) avec un jeton dédié et n'exécute aucune action sur le parc.

Prérequis

• Un serveur Meridian (meridian-ws) joignable depuis Home Assistant.

• Un jeton d'API Meridian (commence par meri_), créé depuis la console : Organisation → Jetons d'API, ou via l'API :

  curl -X POST https://<hôte>/api/v1/tenants/<tenant_id>/api-tokens \
    -H "Cookie: meridian_session=<cookie>" \
    -H "Content-Type: application/json" \
    -d '{"label": "Home Assistant"}'
  

  Le secret en clair n'est affiché qu'une fois — conservez-le.

Installation

Via HACS (dépôt personnalisé)

1. HACS → Intégrations → menu ⋮ → Dépôts personnalisés.
2. Ajoutez https://github.com/StormWare/meridian-hass (catégorie Integration).
3. Installez « Meridian RMM », puis redémarrez Home Assistant.

Manuelle

Copiez custom_components/meridian/ dans le dossier config/custom_components/ de votre installation, puis redémarrez Home Assistant.

Configuration

Paramètres → Appareils et services → Ajouter une intégration → Meridian RMM. Saisissez :

• URL du serveur — p. ex. https://meridian.example.com
• Jeton d'API — le secret meri_…

Le jeton est lié à un tenant : l'intégration crée un appareil « tenant » par connexion. L'intervalle d'interrogation (60 s par défaut) se règle dans les Options de l'intégration.

Entités

Appareil tenant (résumé du parc) :

Entité	Description
Agents au total / en ligne / au repos / hors ligne	Effectifs par connectivité
Mises à jour en attente	Postes avec des MAJ OS en attente
Mises à jour de sécurité	Postes avec des MAJ de sécurité
Redémarrages en attente	Postes nécessitant un redémarrage
Incidents ouverts / non acquittés	Incidents d'alerte actifs
Incidents critiques / d'avertissement / d'information	Répartition par sévérité

Un appareil par endpoint :

• Connectivité (binary_sensor, classe connectivity) — actif tant que le poste n'est pas hors ligne. L'état précis (online / idle / offline) et l'OS, le type, la dernière vue, les MAJ disponibles et le redémarrage en attente sont exposés en attributs.

Licence

Voir le dépôt principal Meridian.