File Exchange Service
Le service d’échange de fichiers Anvaigo 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’Anvaigo 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’Anvaigo 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 d’échange de fichiers Anvaigo est fourni sous la forme d’une archive ZIP contenant tous les composants nécessaires à l’exécution de l’application, y compris le moteur d’exécution .NET requis. En raison de ses dépendances, l’application n’est compatible qu’avec les systèmes Windows 64 bits.
Le service peut être lancé en tant qu’application console, ce qui est utile pour les tests et le débogage. Pour une utilisation en production, il est recommandé d’enregistrer l’application en tant que service Windows.
Le service peut être hébergé sur n’importe quel système accessible depuis Dynamics. Cependant, pour les installations où le ServiceTier Dynamics est disponible, il est fortement recommandé d’installer le service sur la même machine que le ServiceTier.
Notez que le service ne permet pas d’exécuter plusieurs instances en parallèle. Si vous avez plusieurs ServiceTiers sur différentes machines, le service ne doit être installé et exploité que sur une seule machine.
Si le service est hébergé sur une machine différente du ServiceTier, vous devez configurer l’accès en conséquence. Dans ce cas, il est fortement conseillé d’utiliser une connexion Https cryptée, qui peut être configurée dans les paramètres du service.
Installation du service
Extraire l’archive ZIP
Avant de décompresser le fichier ZIP, assurez-vous que Windows le reconnaît comme une source fiable. Cette étape est cruciale, car l’archive contient plusieurs fichiers DLL qui doivent être reconnus par le système d’exploitation après l’extraction.
Copier les fichiers dans le répertoire du serveur
Extraire et copier tout le contenu du fichier ZIP, y compris AnvaigoFileExchangeService.exe
, appsettings.json
et tous les autres fichiers inclus, dans un répertoire cible sur votre serveur.
Attribuer des droits d’accès au répertoire
Attribuer les droits d’accès appropriés au compte d’utilisateur qui exécutera le service. Cet utilisateur doit avoir un accès complet au répertoire cible pour que le service fonctionne correctement.
L’application peut être installée en tant que service Windows à l’aide de la commande suivante (dans la console ou Powershell) avec des privilèges d’administrateur :
sc.exe create "Anvaigo File Exchange Service" binpath="C:InstallationPathAnvaigoFileExchangeService.exe --contentRoot=C:InstallationPath"
Veuillez remplacer C:NInstallationNPath par le chemin dans lequel vous avez copié l’application.
A des fins de test et de débogage, AnvaigoFileExchangeService.exe peut être lancé directement. Dans ce mode autonome, l’application s’exécute tant que la fenêtre de la console reste ouverte et affiche les événements directement dans la console, ce qui est utile pour le dépannage. Notez que l’application ne peut pas être exécutée en mode autonome lorsque le service est actif. Vous devez arrêter le service Windows avant de démarrer l’application manuellement.
Configuration
La majeure partie de la configuration est effectuée dans Microsoft Dynamics 365 Business Central 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.
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.
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.
La bibliothèque SFTP par défaut utilisée par le service d’échange de fichiers Anvaigo est « Ssh.NET ». Si le serveur requiert des méthodes d’authentification non prises en charge par Ssh.NET, telles que rsa-sha2-256, vous pouvez passer à l’utilisation de « WinSCP » en modifiant les paramètres de configuration en conséquence.
Dans ce cas, nous recommandons vivement de tester la connexion à l’aide de l’interface graphique WinSCP, qui peut être téléchargée à partir de https://winscp.net/eng/download.php. Cela permet de vérifier que la connexion peut être établie avec succès avant de la configurer dans le service.
Lors de l’utilisation de l’authentification par clé, un .ppk
est nécessaire. Vous pouvez créer ce fichier à l’aide de l’outil « PuTTYgen ».
Limiter l’accès au service à certaines IP ou à certains noms DNS. (Pour en savoir plus, cliquez ici)
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 Anvaigo EDI Connect.