Accueil > Documentation > Outils > Agent > L’Agent Sycomore
Dernière mise à jour le 15 juillet 2020

L’Agent Sycomore

L’agent est un logiciel client qui gère 3 types d’opérations pour Sycomore :

  • La gestion des dépôts
  • La gestion des réceptions
  • Le traitement des conversions
  • La configuration de votre agent sera réalisée directement sur votre interface Sycomore.

Principe

A partir de la version 2.x, la configuration de l’agent est récupérée au démarrage du service d’agent automatique Sycomore.
La connexion à Sycomore doit être réalisée par un utilisateur technique qui n’aura pas le droit de se connecter sur l’interface Sycomore. La configuration ne pourra alors être modifiée que par un administrateur habilité.

Prérequis

Une plateforme Java de type JRE est nécessaire sur le "système/environnement client" utilisant l’agent. L’utilisation d’une version JRE-Java v8 est préconisée.
Pour son installation merci de consulter le site : http://java.com.
La mise en service peut être effectuée dans un environnement Windows ou Linux.

Dépôts et Conversions

Pour chaque type d’opérations, il est défini des répertoires d’entrée et de sortie. L’agent scrute les répertoires d’entrée en attente de fichiers à traiter. Dès qu’un fichier est détecté, il est transmis à Sycomore pour traitement.
Le résultat de l’opération est ensuite déposé dans le répertoire de sortie.

Réceptions

Le module de gestion des réceptions utilise quant à lui un répertoire où seront copiés les fichiers reçus, les relevés à récupérer sont directement configurés dans l’agent.

La version de Sycomore 20.06 reste compatible avec toutes les versions 1.x du service "Agent automatique" installé chez le client.

Configuration des Agents v1.x

La configuration est réalisée à partir du fichier agents-config.properties présent dans le dossier d’installation du service "Agent automatique Sycomore".

Si vous disposez d’une version 1.x, nous vous invitons à prendre contact avec notre support technique pour planifier avec eux la migration de votre contexte.
Vous pourrez alors bénéficier des nouvelles fonctions de configuration simplifiées.

Configuration des Agents > v2.x

Module fonctionnel ’Agent Sycomore’

L’activation de l’exploitation de l’agent Sycomore est réalisée par l’exploitant CEDRICOM.
Le module fonctionnel ’Agent Sycomore’ n’est pas activé par défaut pour les abonnements.

Habilitation d’administration des configuration Agent

Pour accéder au menu de configuration, il faut disposer d’une habilitation spécifique.
Cette habilitation peut être positionnée via l’écran de configuration d’un utilisateur côté abonné ou via l’écran d’affectation des habilitations sur un abonnement côté exploitant.
Cette habilitation peut être positionnée via web service via la constante ROLE_ADMIN_AGENT.
Ecran détail d’un utilisateur :

la gestion des configurations

Il est possible de créer plusieurs configurations d’installation ainsi que plusieurs configurations métier pour chacune d’elle.
Cela permet alors de gérer plus d’une configuration d’installation d’agent par abonnement et ainsi d’activer la gestion "multi-configuration" par un agent.
Au delà d’une gestion "multi-abonnement", c’est-à-dire des configurations récupérées par l’agent qui s’appliquent sur des abonnements différents,
l’agent est en fait "multi-configuration", ce qui inclut le multi-abonnement mais qui permet également d’avoir plusieurs configurations métier différentes pour un même abonnement.
Pour avoir une configuration d’agent multi-abonnement, il faut alors associer un utilisateur technique multi-abonnement à la configuration d’installation.
Cette configuration d’installation pourra alors contenir des configurations métier dans les abonnements auxquels l’utilisateur technique est associé.
Ainsi, pour créer une configuration métier dans un autre abonnement, il est nécessaire de changer d’abonnement courant.
De même, l’édition d’une configuration métier ne peut se faire que si l’abonnement courant correspond à l’abonnement associé.

Ecran listant les configurations d’installation

Accessible directement depuis le menu, il liste les configurations d’installation liées à l’abonnement courant,
c’est-à-dire celles qui sont associées à un utilisateur technique appartenant à l’abonnement courant.
Cet écran permet alors de créer une nouvelle configuration d’installation, de supprimer une configuration existante ou d’accéder à son écran de détail.

Configuration d’installation

Ajout/Suppression de configuration métier

Toutes ces données seront fournies aux clients afin qu’il puisse se connecter sur Sycomore pour récupéré toute la configuration de l’agent afin que le service puisse travailler.

Dans l’écran de détail d’une configuration d’installation, il est possible de créer une nouvelle configuration métier ou de supprimer une configuration métier existante.
Même si toutes les configurations métier appartenant à la configuration d’installation sont listées,
la suppression de l’une d’elles ou l’accès à son écran de détail ne sont possibles que si l’abonnement à laquelle elle est associée est l’abonnement courant.

Configuration de la connexion

3 paramètres essentiels seront fournis dans le fichier de configuration "properties" du service "Agent automatique Sycomore"
le nom de l’utilisateur technique qui servira à la connexion , son mot de passe crypté et le nom de la référence externe à prendre en charge sur Sycomore.
Les paramètres de connexion au Proxy du client et au serveur de notification seront également présents dans le fichier "properties" que le client devra copier dans le dossier d’installation de son "agent automatique Sycomore".

Configuration des notifications

Cette section, dans l’écran de détail d’une configuration d’installation, permet à l’utilisateur de configurer un serveur de notification afin d’être averti en cas d’erreur de traitement.
L’utilisateur à saisir dans cette partie n’est pas un utilisateur Sycomore mais un utilisateur du serveur SMTP de notifications.

Configuration du proxy

La section Proxy, dans l’écran de détail d’une configuration d’installation, permet de configurer l’agent si celui-ci doit se connecter à un proxy.
Liste des données constituant la configuration du proxy pour une instance d’agent :

  • Liste déroulante du mode :
    • Mode « Pas de proxy » : L’agent Sycomore n’applique aucune configuration de proxy
    • Mode « Système » : L’agent Sycomore applique la configuration de proxy définie au niveau du système
    • Mode « Surcharge » : L’agent Sycomore applique la configuration de proxy définie dans l’écran
      Les champs de configuration ci-dessous ne s’appliquent alors que pour le mode « Surcharge ».
      Les sections « HTTP » et « HTTPS » (visible seulement si le mode « Surcharge » est sélectionné) :
  • Host : Nom du serveur proxy (1 seule entrée possible)
  • Port : Numéro du port
  • Utilisateur : Adresse email d’authentification sur le serveur proxy
  • Mot de passe : Mot de passe de l’utilisateur sur le serveur proxy
  • Hosts sans proxy : Liste des noms de serveur pour lesquels, ne pas appliquer la configuration de proxy
    Le mode « Système » est sélectionné par défaut, c’est-à-dire que l’agent va récupérer la configuration du proxy présente sur l’OS où il est installé.

Configuration métier

Définition de groupes de répertoires de dépôts

Il est possible de définir, par FQA, des dossiers ’entrée’, ’encours’, ’archive’, ’erreur’ différents de ceux par défaut.
Pour cela, il faut définir un groupe de répertoires dans l’onglet "Dépôts".

  • Chaque groupe de répertoires est identifié par un identifiant pouvant contenir des lettres de ’a’ à ’z’, majuscules et minuscules et des chiffres.
  • Chacun des répertoires du groupe défini doit correspondre à un dossier différent et ne doit pas contenir de sous-dossier.
  • Ils doivent, de plus, n’être référencés qu’une seule fois sur l’ensemble de la configuration.
    L’identifiant du groupe de répertoires peut ensuite être associé à une règle de nommage de type Expression régulière ("regexp").

Onglet de configuration des conversions

Cet onglet permet de configurer les conversions des fichiers.
Les paramètres suivants sont à définir dans cet onglet :

  • La fréquence à laquelle les répertoires de dépôt des fichiers à convertir sont scannés
  • Répertoire de dépôt des fichiers à convertir en SCT
  • Répertoire de dépôt des fichiers à convertir en SCT avec création d’un dépôt
  • Répertoire de dépôt des fichiers à convertir en SDD
  • Répertoire de dépôt des fichiers à convertir en SDD avec création d’un dépôt
  • L’actualisation ou non de la base ’référentiel Mandats’ lors de la conversion du fichier CSV ou CFONB
  • La présence ou non de la RUM dans le libellé de l’opération
  • Répertoire des fichiers en cours de conversion
  • Répertoire des fichiers en cours de conversion avec création d’un dépôt
  • Répertoire d’archivage
  • Répertoire des conversions en erreur

Chiffrement des mots de passe

Désormais, les mots de passe utilisés dans la configuration de l’agent Sycomore sont chiffrés :

  • Les mots de passe de l’utilisateur pour la connexion à Sycomore (dans la configuration d’installation et les onglets "Dépôts", "Réceptions" et "Conversions" de la configuration métier)
  • Les mots de passe de l’utilisateur pour la connexion au serveur SMTP
  • Les mots de passe de l’utilisateur pour la connexion au serveur PROXY
    Les mots de passe sont chiffrés via un algorithme qui permet leur déchiffrement par l’agent, et uniquement par lui.
    Pour cette raison, seuls les utilisateurs techniques utilisés dans une configuration d’agent ont leur mot de passe chiffré de la sorte.
    Les mots de passe chiffrés des utilisateurs de connexion aux serveurs SMTP ou proxy sont stockés dans les configurations d’installation d’agent.
    Les mots de passe chiffrés des utilisateurs techniques sont stockés dans une colonne dédiée de la table COMPTE_UTILISATEUR.
    La taille des mots de passe chiffrés dépend directement de la taille du mot de passe en clair.
    La taille actuelle de la colonne permet de gérer des mots de passe en clair possédant entre 96 et 144 caractères maximum.
  • La borne minimum (96 caractères) correspond à un mot de passe ne possédant que des caractères encodés sur 3 octets en UTF-8.
  • La borne maximum (144 caractères) correspond à un mot de passe ne possédant que des caractères encodés sur 2 octets en UTF-8.

Installation et configuration du service

L’agent automatique est une application indépendante de Sycomore.
Celui-ci est installé dans l’environnement du client, par un intervenant informatique habilité par l’entité / la société.

Cedricom accompagne ses clients dans les phases d’installation et de configuration de l’agent automatique.
Merci de contacter notre support technique pour disposer de la documentation d’installation du service de l’agent dans votre contexte client.