Anveo EDI Connect / Config / Échange de données / File Exchange Service
C'est une traduction automatique. Le message original est disponible en Anglais.

File Exchange Service

Le service d’échange de fichiers Anveo EDI Connect permet de recevoir et d’envoyer des données par d’autres systèmes. À cette fin, un service extérieur à Dynamics est chargé de traiter les données. Ce service est généralement exécuté sur le ServiceTier (installations OnPrem) ou sur un serveur accessible au public (installations Cloud). Pour l’exploitation d’Anveo EDI Connect sur votre propre infrastructure, nous offrons des licences gratuites pour le service.

Pour utiliser ce service, vous devez disposer de la version 5.3.0.4 d’Anveo EDI Connect ou d’une version supérieure.

Le service peut être utilisé à partir de toutes les installations de notre module (OnPrem et Cloud) à partir de Dynamics NAV 2013.

Vue d’ensemble

Le service est fourni sous la forme d’un fichier d’application unique. L’application peut être lancée en tant qu’application console à des fins de test et de débogage. Pour un fonctionnement en production, nous recommandons que l’application soit enregistrée en tant que service. Le service peut être hébergé sur n’importe quel système accessible depuis Dynamics. Cependant, pour toutes les installations où vous avez accès au ServiceTier Dynamics, nous recommandons fortement de l’installer en même temps que le ServiceTier. Le service ne prend pas en charge plusieurs instances fonctionnant en parallèle. Par conséquent, si vous avez plusieurs ServiceTiers sur différentes machines, vous devez installer le service sur une seule machine.
Si le service est situé sur une machine différente du ServiceTier, l’accès doit être autorisé via la configuration et nous conseillons fortement d’utiliser une connexion Https cryptée dans ce cas. Cela peut se faire par le biais de la configuration.

Installation du service

Copiez les fichiers AnveoFileExchangeService.exe et appsettings.json dans un répertoire de votre serveur et assurez-vous que l’utilisateur qui doit exécuter le service a les droits d’accès à ce répertoire.

L’application peut être installée à l’aide de la commande suivante (dans la console ou Powershell) avec des privilèges d’administrateur :

sc.exe create "Anveo File Exchange Service" binpath="C:InstallationPathAnveoFileExchangeService.exe --contentRoot=C:InstallationPath"
Service d’installation

Veuillez remplacer C:NInstallationNPath par le chemin dans lequel vous avez copié l’application.

A des fins de test et de débogage, AnveoFileExchangeService.exe peut également être démarré directement.

Configuration

La majeure partie de la configuration est effectuée dans Microsoft Dynamics NAV 2013R2 Quelques paramètres doivent être configurés pour le service. Vous trouverez ces paramètres dans le fichier appsettings.json fourni avec le service. Le fichier de configuration doit se trouver dans le même dossier que le fichier d’application.

ApiKey

Chnagez cette valeur en une longue chaîne secrète et entrez la même chaîne dans Dynamics. Nous recommandons de créer un GUID et de supprimer tous les caractères spéciaux, mais c’est à vous de choisir une chaîne sécurisée. En cas d’utilisation du protocole Http, le secret est transféré en texte clair. Veuillez utiliser Https lorsque le service n’est pas installé sur le ServiceTier.

AllowLocalFilesystemAccess

Si le service peut accéder à tous les fichiers locaux du serveur (en utilisant le compte d’utilisateur qui exécute le service) et exécuter des fichiers de script.

Veillez à ce que l’utilisateur qui exécute le service ne puisse accéder qu’aux répertoires auxquels la FES doit avoir accès. Si cette option est réglée sur « true », toute personne ayant accès aux canaux de communication Dynamics ou à la clé API peut lire et écrire des fichiers dans tous les répertoires accessibles au service FES.

Les implications potentielles en matière de sécurité sont la raison pour laquelle cette option est désactivée par défaut.

SshDefaultLibrary

La valeur par défaut est « Ssh.NET ». Si le serveur utilise des méthodes d’authentification qui ne sont pas prises en charge par SSH.NET (comme rsa-sha2-256), vous pouvez remplacer cette valeur par « WinSCP » afin d’utiliser cette méthode pour la connexion. Nous recommandons vivement de tester la connexion avec l’interface graphique WinSCP (nous utilisons WinSCP version 6.1, téléchargeable ici : https://winscp.net/eng/download.php) si la connexion peut être établie avec succès. En ce qui concerne le fichier clé, il faut utiliser un fichier clé .ppk. Le programme « PuTTYgen » peut être utilisé pour créer un tel fichier.

AllowedHosts

Limiter l’accès au service à certaines IP ou à certains noms DNS. (Pour en savoir plus, cliquez ici)

Kestrel

La configuration du point de terminaison du service, comme l’adresse, le port et l’utilisation de Https ou Http. (Pour en savoir plus, cliquez ici)

Prochaines étapes

Vous pouvez maintenant configurer le canal de communication dans Anveo EDI Connect.

FAQ