Connecter Cato Networks
Ce guide explique comment créer la clé d'API Cato demandée par le formulaire d'Alerion (Paramètres → Connecteurs → Cato Networks). Alerion lit vos sites, Sockets et liens Internet en lecture seule.
Prérequis
- Le rôle Editor dans la console de gestion Cato (CMA) : selon la documentation Cato, seuls les Editors peuvent créer ou gérer des clés d'API de service.
- Un Service Principal auquel rattacher la clé : un existant (par exemple celui créé automatiquement, « Automation Service Principal ») ou un nouveau, créé sous Account → Administrators.
- Une offre Alerion qui comprend le connecteur (Business ou supérieure).
Créer la clé en lecture seule pas à pas
Étapes tirées de la page officielle « Generating API Keys for the Cato API » (voir Sources) :
- Dans le menu de navigation, cliquez sur Resources → Service API Keys.
- Cliquez sur New : le panneau Create API Key s'ouvre.
- Sélectionnez le Service Principal associé à la clé.
- Saisissez un Key Name (simple libellé, non utilisé pour l'authentification).
- Cochez Downgrade to View pour limiter la clé aux appels de lecture (View).
- Facultatif : sous Allow access from IPs, choisissez Specific IP list et saisissez les adresses IP ou la plage CIDR autorisées (par défaut : Any IP). L'adresse IP sortante d'Alerion n'est pas publiée dans ce guide : demandez-la au support Alerion avant de restreindre la clé.
- Facultatif : une date d'expiration (Expires at). Cato la recommande pour les clés Edit ; elle est facultative pour une clé View.
- Cliquez sur Apply : une fenêtre affiche la nouvelle clé. Copiez-la et conservez-la en lieu sûr. Une fois la fenêtre fermée, la valeur de la clé n'est plus accessible.
- Cliquez sur OK.
Valeur de chaque champ du formulaire Alerion
| Champ Alerion | Valeur à saisir |
|---|---|
| Numéro de compte Cato | L'Account ID (« identifiant unique Cato de votre compte »), visible sous Account → Account Info. Le formulaire d'Alerion indique aussi qu'il apparaît dans l'adresse de la console, par exemple 26 dans …/26/topology ; cette précision ne figure pas dans la documentation Cato. |
| Clé d'API Cato en lecture seule | La clé créée ci-dessus, avec Downgrade to View. |
La clé est chiffrée par Alerion, n'est jamais affichée de nouveau et n'est jamais écrite dans les journaux.
Vérification
À la validation, Alerion contrôle, avant de stocker quoi que ce soit, que la clé lit les données et que sa lecture seule est prouvée. Une clé qui permettrait d'écrire est refusée. Rien n'est enregistré en cas d'échec. Une fois connecté, la fiche de la connexion indique la date de la dernière synchronisation.
Erreurs courantes
- Clé refusée : vérifiez que le numéro de compte est bien l'Account ID et que la clé n'a pas été tronquée à la copie.
- Clé non en lecture seule : recréez-la en cochant Downgrade to View.
- Clé restreinte par IP : si l'adresse IP sortante d'Alerion n'est pas dans la liste, Cato refuse les appels ; repassez à Any IP ou ajoutez l'adresse fournie par le support.
- Clé perdue : la valeur n'est plus accessible, créez-en une nouvelle.
Sources
- Cato Networks, « Generating API Keys for the Cato API » : https://knowledge.catonetworks.com/docs/generating-api-keys-for-the-cato-api
- Cato Networks, « Viewing the Account Info » (Account ID) : https://knowledge.catonetworks.com/docs/viewing-the-account-info