Connecter UniFi

L’intégration UniFi permet de choisir un site, de l’associer à un emplacement LogCentral existant ou créé dans l’assistant, puis de configurer l’envoi des journaux.

Avant de commencer

• Un Propriétaire de l’organisation LogCentral doit enregistrer la clé API UniFi. Les Propriétaires et Membres peuvent ensuite gérer les sites et leur configuration. Ce parcours n’est pas accessible au rôle Lecture seule.
• La clé doit donner accès au site dans Site Manager et à sa console via Cloud Connector. Un site visible dans la liste peut néanmoins refuser l’accès à sa configuration.
• Pour configurer l’envoi automatique, l’organisation doit avoir un abonnement ou un essai actif, et l’emplacement doit être actif avec les IP sources autorisées.
• La configuration automatique est actuellement validée pour UniFi Network 10.6.109. Sur une autre version, utilisez la configuration manuelle. Des réglages non reconnus ou Netconsole actif bloquent également l’automatisation.

Un site UniFi ne peut être associé qu’à un emplacement. Un emplacement déjà associé à Meraki ne peut pas être associé simultanément à UniFi.

1. Connecter le compte UniFi

1. Sélectionnez l’organisation LogCentral concernée et ouvrez Intégrations.
2. Dans la carte UniFi, cliquez sur Connecter UniFi.
3. Utilisez Créer une clé dans UniFi pour ouvrir les paramètres de clés API de Site Manager.
4. Saisissez la clé dans Clé API Site Manager, puis cliquez sur Enregistrer la clé.

La clé est conservée côté serveur et n’est pas réaffichée après l’enregistrement. La connexion ne modifie pas les réglages des consoles.

2. Choisir le site et son emplacement

1. Cliquez sur Gérer les sites UniFi et recherchez la console ou le site.
2. Choisissez le site à configurer. Vérifiez le nom de la console : plusieurs consoles peuvent avoir un site appelé « Default ».
3. Choisissez Emplacement existant ou Nouvel emplacement.
4. Pour un nouvel emplacement, vérifiez le nom proposé puis cliquez sur Créer et continuer. Les limites habituelles de votre forfait s’appliquent.
5. Vérifiez le site et l’emplacement sélectionnés, puis cliquez sur Associer le site.

La création laisse le nouvel emplacement inactif. Choisir un site ou un emplacement n’active pas l’envoi des logs. Si la création n’a pas pu être confirmée, recherchez d’abord l’emplacement dans la liste avant de réessayer.

Vous pouvez aussi gérer une association depuis la carte UniFi des détails de l’emplacement.

3. Préparer la réception

L’assistant affiche la Destination UniFi actuelle et le Collecteur de cet emplacement. La destination LogCentral est l’adresse IPv4 et le port UDP attribués à cet emplacement.

1. Vérifiez les adresses WAN publiques détectées et cliquez sur Autoriser ces adresses IP si elles correspondent aux sorties utilisées par les logs.
2. Si nécessaire, cliquez sur Activer cet emplacement.
3. Autorisez le trafic UDP sortant vers l’adresse et le port du collecteur sur votre pare-feu.

L’intégration n’autorise pas les adresses sans votre action. Après un changement d’IP ou un basculement WAN, vérifiez et autorisez les nouvelles adresses : il n’y a pas de synchronisation automatique des IP UniFi. Pour un VPN, un relais ou du CGNAT, vérifiez l’IP réellement utilisée et consultez le guide des IP autorisées.

4. Configurer l’envoi

1. Choisissez les Catégories de journaux. La sélection initiale couvre passerelle, points d’accès, switches, activité administrateur, événements équipements et événements clients.
2. Vérifiez la destination actuelle. UniFi utilise une seule destination distante dans ce parcours : la remplacer peut interrompre l’envoi vers un autre collecteur.
3. Si une confirmation de remplacement ou de bascule depuis le contrôleur est affichée, lisez-la et confirmez votre choix.
4. Cliquez sur Configurer le syslog.

Les catégories supplémentaires dépendent des événements produits par votre installation. La catégorie Règle de pare-feu par défaut nécessite aussi Passerelle.

Réglage UniFi vérifié signifie que LogCentral a relu les réglages enregistrés dans UniFi. Cela ne confirme pas encore la réception des logs.

Configuration manuelle

Si la configuration automatique n’est pas disponible, reprenez la destination affichée dans l’assistant ou dans la configuration de l’emplacement. Dans UniFi, ouvrez Integration → System Logging / SIEM, sélectionnez le serveur SIEM, renseignez l’adresse et le port UDP de l’emplacement et choisissez les catégories.

Les libellés peuvent varier selon la version UniFi. Consultez le guide officiel d’export des logs UniFi. Vérifiez les IP autorisées et la réception après toute configuration manuelle.

5. Vérifier un nouvel événement UniFi

Ouvrez les logs en direct de l’emplacement et repérez un événement UniFi récent, correspondant à une action identifiable sur le bon site. Si nécessaire, utilisez la recherche dans les logs du jour.

La Dernière activité de cet emplacement peut provenir d’une autre source. Elle ne prouve pas à elle seule la réception UniFi. Si aucun événement n’arrive, vérifiez la destination, le port, le protocole UDP, les IP de sortie, l’activation de l’emplacement et les catégories choisies.

Gérer une opération ou retirer l’intégration

Situation	Action
Résultat à vérifier après un délai dépassé	Attendez au moins une minute, puis cliquez sur Vérifier l’opération incertaine. Cette action relit les réglages sans renvoyer la configuration.
Aperçu expiré ou réglage différent	Cliquez sur Actualiser, puis vérifiez le site, la destination et les IP avant de confirmer à nouveau.
Revenir à l’ancienne destination	Utilisez Restaurer la destination précédente si une sauvegarde est disponible. Une modification faite entre-temps dans UniFi doit être vérifiée avant la restauration.
Retirer le lien	Cliquez sur Dissocier le site. Restaurez d’abord la destination précédente ou choisissez explicitement de conserver la destination actuelle dans UniFi.
Remplacer la clé	Un Propriétaire peut enregistrer une nouvelle clé dans les paramètres de connexion. Elle doit conserver l’accès à tous les sites associés.
Déconnecter UniFi	Dissociez tous les sites de l’organisation, puis cliquez sur Déconnecter. Cela retire la clé enregistrée dans LogCentral ; sa révocation dans UniFi est distincte.

Une restauration n’est possible que si LogCentral dispose des réglages précédents. Un site déjà configuré avant son association ne reçoit pas de sauvegarde historique.

La dissociation supprime le lien et la sauvegarde de restauration, mais conserve les IP autorisées et les logs déjà reçus. Si vous conservez la destination UniFi, les équipements peuvent continuer à envoyer leurs logs. Avant d’archiver ou de supprimer l’emplacement, restaurez ou dissociez le site : ces opérations ne modifient pas automatiquement UniFi.

Si la console refuse l’accès ou reste injoignable, vérifiez les droits de la clé et la connexion distante. Pour obtenir de l’aide, transmettez au support LogCentral le nom de l’emplacement, la version Network, le message affiché et l’heure du test. Ne transmettez pas votre clé API.