Livraison SFTP

La livraison SFTP pousse les résultats de classification vers un serveur que vous contrôlez, sous forme de fichiers. À mesure que chaque classification d’un flow se termine, Gaard se connecte à votre serveur SFTP/FTP et y dépose soit la vidéo annotée, soit les images d’instantanés. C’est le mode de livraison adapté aux consommateurs basés sur des fichiers (systèmes de gestion vidéo, archives de preuves et tâches par lots) qui ingèrent du média plutôt que du JSON.

Pour comparer ce mode à l’interrogation et aux webhooks, voir Choisir un mode de livraison.

Prérequis

• Un rôle admin dans le tenant.
• Un flow auquel rattacher l’intégration. Voir Flows.
• Un serveur SFTP ou FTP joignable depuis Gaard, avec des identifiants (un nom d’utilisateur et un mot de passe, ou une clé privée SSH pour SFTP).

Ajouter une intégration de livraison SFTP

La livraison SFTP correspond à l’intégration SFTP/FTP Outbound, configurée par flow.

1. Dans l’application web, ouvrez Settings → Platform → Integrations.

2. Sous Add a new integration, sélectionnez SFTP/FTP Outbound.

3. Choisissez le Flow dont vous voulez livrer les résultats.

4. Saisissez un Name pour l’intégration.

5. Définissez le File Protocol : FTP ou SFTP.

6. Saisissez le Host et le Port. Le port vaut 21 par défaut ; réglez-le sur votre port SFTP (généralement 22) lorsque le protocole est SFTP.

7. Saisissez le Username et le Password. Lorsque le protocole est SFTP, vous pouvez fournir une Private Key au lieu d’un mot de passe.

8. Choisissez ce qui est envoyé avec Send Snapshots (voir Ce qui arrive sur votre serveur ci-dessous).

9. Activez éventuellement Clean up SFTP folder after 15 minutes pour que Gaard supprime les fichiers livrés 15 minutes après leur écriture.

10. Sélectionnez Test pour vérifier la connexion, puis enregistrez.

Note

Le champ Private Key n’apparaît que lorsque le protocole est SFTP. Les connexions FTP s’authentifient avec un nom d’utilisateur et un mot de passe.

Si vous devez livrer les mêmes résultats vers plusieurs serveurs, ajoutez une intégration SFTP/FTP Outbound par destination.

Ce qui arrive sur votre serveur

Ce que Gaard écrit dépend de l’option Send Snapshots :

Send Snapshots	Fichiers écrits
Désactivé (par défaut)	L’extrait highlight de la classification, écrit sous forme d’un unique fichier .mp4.
Activé	Les instantanés JPEG (.jpg / .jpeg) de l’alerte, écrits sous forme de fichiers image individuels.

Les fichiers sont écrits dans le répertoire de travail où arrive votre compte lors de la connexion. La livraison se produit automatiquement pour chaque classification terminée du flow : il n’y a pas de fenêtre de traitement par lots planifiée séparée.

Attention

La livraison de fichiers se fait au mieux (best-effort). Un transfert échoué est journalisé mais pas réessayé. Si vous avez besoin du résultat JSON structuré plutôt que de fichiers média, utilisez plutôt l’interrogation ou les webhooks.

Tester la connexion

Le bouton Test ouvre une connexion avec les identifiants du formulaire et confirme que Gaard peut joindre le serveur et lire son répertoire de travail. La vérification expire après quelques secondes ; un test en échec pointe donc vers un hôte injoignable, un mauvais port ou des identifiants incorrects. Corrigez-les avant d’enregistrer.

Suivre l’état de la livraison

Chaque intégration de la liste porte un indicateur d’état :

État	Signification
active	L’intégration fonctionne normalement.
paused	Vous avez mis l’intégration en pause (voir ci-dessous).
error	La dernière connexion a échoué : le message d’erreur est affiché sur la ligne.

Récupération SFTP entrante et mise en pause persistante

Gaard peut aussi travailler dans l’autre sens : l’intégration SFTP/FTP récupère des fichiers depuis un serveur SFTP/FTP, les regroupe en alertes et les classifie. Contrairement à la livraison sortante (qui se déclenche une fois par classification) la récupération entrante fait tourner un observateur (watcher) qui interroge le serveur en continu.

Parce que cet observateur est une connexion active, vous pouvez le mettre en pause et le reprendre :

1. Dans Settings → Platform → Integrations, ouvrez le menu de la ligne de l’intégration SFTP/FTP.

2. Sélectionnez Stop pour mettre la récupération en pause, ou Start pour la reprendre.

La pause est persistante : une intégration en pause le reste après un redémarrage jusqu’à ce que vous la redémarriez, et son état affiche paused. C’est la façon sûre de mettre une connexion de récupération hors ligne pour maintenance sans supprimer sa configuration.

Le réglage global de la récupération entrante (l’intervalle d’interrogation, la manière dont les fichiers sont regroupés en alertes et la gestion de l’âge des fichiers) se trouve dans Settings → Platform → Configuration → SFTP Integration.

Étapes suivantes

Choisir un mode de livraison Comparer la livraison SFTP avec l'interrogation et les webhooks.

Webhooks Recevoir le résultat JSON via un rappel HTTP.

Plateformes d'alarme Connecter Azursoft, Evalink, Prysm ou un récepteur SIA DC-09.

Flows Comment les flows encadrent intégrations, jetons et webhooks.