Guide d’intégration avec Fortinet

Bienvenue dans le guide de configuration de l’intégration de Fortinet avec Hector. À la fin de ce guide, vous serez en mesure de synchroniser automatiquement vos pare-feux, commutateurs et points d’accès Fortinet dans Hector en tant qu’actifs. L’intégration se connecte à votre appareil FortiManager via son API JSON-RPC.

1. Connexion à votre compte Hector

Vous devez être administrateur pour activer l’intégration Fortinet.

2. Intégrations

Rendez-vous dans les Paramètres ; dans la section Intégrations, vous trouverez l’intégration Fortinet dans l’onglet Inventaire.

Une fois dans les paramètres de l’intégration, l’onglet Authentification comporte trois champs à remplir :

• Url / adresse IP : l’adresse de votre appareil FortiManager, par exemple https://1.2.3.4.
• Jeton : un jeton d’API REST généré sur votre FortiGate (voir Générer un jeton d’API Fortinet ci-dessous).
• Adresse IP de Hector à autoriser : ce champ en lecture seule affiche l’adresse IP depuis laquelle Hector se connecte. Vous devez ajouter cette adresse IP aux hôtes de confiance (Trusted Hosts) de l’administrateur API sur le FortiGate, sans quoi la connexion sera refusée. Utilisez le bouton de copie situé à côté du champ.

Générer un jeton d’API Fortinet

Vous pouvez générer le jeton depuis le FortiGate, en utilisant soit l’interface graphique (GUI), soit la ligne de commande (CLI).

Méthode A : via l’interface graphique du FortiGate

1. Connectez-vous à votre pare-feu FortiGate en tant que super_admin.
2. Accédez à System > Administrators.
3. Cliquez sur Create New et sélectionnez REST API Admin.
4. Configurez l’utilisateur API :
   Username : donnez-lui un nom descriptif (par ex. api_hector).
   Administrator Profile : sélectionnez un profil disposant au minimum des permissions de lecture sur les appareils que vous souhaitez importer.
   Trusted Hosts (obligatoire) : saisissez l’adresse IP de Hector affichée dans les paramètres de l’intégration.
5. Cliquez sur OK.
6. Copiez le jeton affiché dans la fenêtre contextuelle.

Important : ce jeton n’est affiché qu’une seule fois. Copiez-le et conservez-le en lieu sûr. Si vous le perdez, vous devrez en générer un nouveau, ce qui invalidera l’ancien. Si vous révoquez le jeton utilisé dans Hector, vous devrez le remplacer par un nouveau pour que l’intégration continue de fonctionner.

Méthode B : via la ligne de commande du FortiGate

config system api-user
    edit "api_hector"
        set accprofile "super_admin"   <-- ou votre profil restreint personnalisé
        set vdom "root"
        config trusted-host
            edit 1
            set ip 192.168.1.50 255.255.255.255   <-- remplacez par l'IP de Hector indiquée dans les paramètres de l'intégration
            next
        end
    next
end

3. Options

Une fois que vous avez saisi l’Url et le Jeton, cliquez sur Valider. Si tout est correct, vous serez redirigé vers un autre onglet où vous pourrez sélectionner les options souhaitées.

Destination initiale

Cette partie correspond à l’entrepôt et à la catégorie par défaut vers lesquels vos actifs seront dirigés.

Synchronisation

Vous pouvez ici modifier la manière dont les actifs seront synchronisés dans Hector :

• Types d’appareils : choisissez les types d’appareils Fortinet à importer — Pare-feux, Commutateurs et Points d’accès.
• Synchroniser les catégories : de nouvelles catégories seront créées en fonction du type d’appareil (pare-feu, commutateur ou point d’accès). Si cette option est décochée, chaque appareil est placé dans la catégorie par défaut sélectionnée ci-dessus.

Champs

Dans le sélecteur d’attributs, vous pouvez choisir les champs supplémentaires importés dans Hector en tant qu’attributs. Notez que les attributs seront créés automatiquement s’il s’agit de la première fois que vous utilisez cet attribut dans une intégration (toutes les intégrations utilisent les mêmes attributs), et leur nom sera défini selon la langue de votre instance et non selon la préférence linguistique de votre utilisateur.

Le numéro de série est notre clé de synchronisation, il ne peut donc pas être décoché.

Fonctionnement de l’intégration

À quoi s’attendre lors de la synchronisation

Une fois la synchronisation activée, Hector commencera à se synchroniser avec FortiManager selon les paramètres de votre intégration une fois par jour, en soirée.

Correspondance des champs

Lorsqu’un appareil Fortinet est créé dans Hector, les champs suivants sont renseignés :

Champ Fortinet	Champ Hector	Notes
Type d’appareil	Catégorie	Associe un type d’appareil (pare-feu, commutateur, point d’accès) à une catégorie uniquement si l’option Synchroniser les catégories est cochée. Sinon, l’actif est placé dans la catégorie par défaut.
Modèle	Article
Nom	Titre
Numéro de série	—	Utilisé comme clé de synchronisation, il est donc toujours importé.

Les autres champs seront renseignés selon les attributs que vous avez choisis dans l’onglet Champs.

---

Ceci conclut le guide d’intégration de Fortinet. Si vous avez des questions ou souhaitez de l’aide pour l’intégration dans votre environnement, n’hésitez pas à contacter notre équipe commerciale pour plus d’informations.