Connecter Cisco Meraki
Ici, aucune clé n'est à créer ni à saisir : Cisco Meraki se connecte par autorisation OAuth 2.0. Vous êtes envoyé chez Meraki, vous autorisez Alerion, puis vous revenez dans Alerion. Alerion lit vos organisations, réseaux et équipements Meraki en lecture seule.
Prérequis
- Un compte administrateur de l'organisation Meraki à connecter. La page officielle ne précise pas le rôle exact nécessaire pour autoriser une intégration ; elle indique en revanche que seul un administrateur de l'organisation peut la retirer du tableau de bord.
- La documentation Meraki précise que l'OAuth est pour l'instant pris en charge uniquement
dans le cluster
meraki.com. Si votre organisation est hébergée ailleurs, la connexion peut ne pas être possible ; la page ne détaille pas ce cas. - Une offre Alerion qui comprend le connecteur (Business ou supérieure).
Autoriser Alerion pas à pas
- Dans Alerion, ouvrez Paramètres → Connecteurs puis cliquez sur Connecter sur la carte Cisco Meraki. Alerion affiche d'abord ce qu'il va lire.
- Vous êtes redirigé vers la page d'autorisation de Meraki (
as.meraki.com). Autorisez la demande ; la page officielle ne décrit pas l'écran de consentement lui-même, relisez donc les droits demandés avant de valider. - Meraki vous renvoie vers Alerion avec un code d'autorisation (valable 10 minutes selon la page officielle). Alerion l'échange contre un jeton d'accès (valable 60 minutes, renouvelé automatiquement) : vous n'avez rien à copier.
- Si votre espace Alerion comporte plusieurs organisations Meraki, choisissez celle à connecter.
Droits demandés (tous en lecture)
Lire la liste de vos organisations, réseaux et équipements (noms, modèles, numéros de série, firmware) ; l'état en ligne ou hors ligne et la topologie ; l'état et l'échéance des licences ; la haute disponibilité et l'état des liens Internet des pare-feu MX ; les commutateurs MS et les bornes Wi-Fi MR (modèle, nom, firmware, état). Alerion ne lit ni caméras, ni capteurs, ni terminaux, et n'écrit rien.
Valeur de chaque champ du formulaire Alerion
Il n'y a pas de formulaire : la seule saisie est l'autorisation chez Meraki.
Vérification
De retour dans Alerion, la carte Meraki passe à « connecté » et la fiche de la connexion indique la date de la dernière synchronisation.
Retirer l'accès
Côté Meraki (administrateur de l'organisation uniquement) : Organization → Integrations, onglet My integrations, ouvrez l'intégration puis cliquez sur Remove en haut à droite. Le jeton de renouvellement est révoqué ; le jeton d'accès peut continuer à fonctionner jusqu'à 10 minutes. Côté Alerion, vous pouvez aussi déconnecter le connecteur depuis la fiche de la connexion.
Erreurs courantes
- Autorisation refusée ou abandonnée : relancez Connecter.
- Lien expiré : le code d'autorisation n'est valable que 10 minutes, recommencez.
- Organisation déjà connectée à un autre espace Alerion : Alerion refuse de lier deux fois la même organisation ; déconnectez-la d'abord de l'autre espace.
Sources
- Cisco Meraki, « OAuth overview » (flux d'autorisation, durées, révocation) : https://developer.cisco.com/meraki/api-v1/oauth-overview/
- Cisco Meraki, « Authorization » (accès OAuth par application et clés d'API) : https://developer.cisco.com/meraki/api-v1/authorization/