File Exchange Service
Met de Anveo EDI Connect-service voor bestandsuitwisseling kunnen gegevens worden ontvangen en verzonden door andere systemen. Hiervoor wordt een service buiten Dynamics aangesproken, die de gegevens verwerkt. Deze service wordt meestal uitgevoerd op de ServiceTier (OnPrem) installaties of op een publiek toegankelijke server (Cloud installaties). Voor gebruik met Anveo EDI Connect op je eigen infrastructuur bieden we gratis licenties voor de service.
Om deze service te gebruiken heb je Anveo EDI Connect versie 5.3.0.4 of hoger nodig.
De service kan worden gebruikt vanaf alle installaties van onze module (OnPrem en Cloud) vanaf Dynamics NAV 2013.
Overzicht
De service wordt geleverd als een enkel applicatiebestand. De toepassing kan worden gestart als een consoletoepassing voor test- en debuggingdoeleinden. Voor productiegebruik raden we aan om de applicatie als een service te registreren. De service kan worden gehost op elk systeem dat toegankelijk is vanuit Dynamics. Echter, voor alle installaties waar je toegang hebt tot de Dynamics ServiceTier, raden we sterk aan om het naast de ServiceTier te installeren. De service ondersteunt niet dat meerdere instanties parallel draaien. Dus als je meerdere ServiceTiers op verschillende machines hebt, moet je de service op één machine installeren.
Als de service zich op een andere machine bevindt dan de ServiceTier, moet toegang worden toegestaan via configuratie en we raden sterk aan om in dit geval een versleutelde https-verbinding te gebruiken. Dit kan worden ingesteld via de configuratie.
Installatie van de service
Kopieer de bestanden AnveoFileExchangeService.exe en appsettings.json naar een pad op uw server en zorg ervoor dat de gebruiker die de service moet uitvoeren toegangsrechten heeft tot die map.
De applicatie kan worden geïnstalleerd met het volgende commando (in de console of Powershell) met beheerdersrechten:
sc.exe create "Anveo File Exchange Service" binpath="C:InstallationPathAnveoFileExchangeService.exe --contentRoot=C:InstallationPath"Verander C:¦Installatie in het pad waar je de applicatie naartoe hebt gekopieerd.
Voor test- en debuggingdoeleinden kan de AnveoFileExchangeService.exe ook rechtstreeks worden gestart.
Configuratie
Het grootste deel van de configuratie wordt gedaan in Microsoft Dynamics NAV 2015. Er zijn een paar instellingen die moeten worden geconfigureerd voor de service. Je kunt deze instellingen vinden in het appsettings.json bestand dat met de service wordt meegeleverd. Het configuratiebestand moet in dezelfde map staan als het applicatiebestand.
Verander deze waarde in een lange geheime tekenreeks en voer dezelfde tekenreeks in Dynamics in. We raden aan om een GUID te maken en alle speciale tekens te verwijderen, maar het is aan jou om een veilige string te kiezen. Als Http wordt gebruikt, wordt het geheim in platte tekst verzonden. Gebruik Https als de service niet is geïnstalleerd op de ServiceTier.
Of de service toegang heeft tot alle lokale bestanden op de server (met de gebruikersaccount waarop de service draait) en scriptbestanden kan uitvoeren.
Zorg ervoor dat de gebruiker die de service uitvoert alleen toegang heeft tot de mappen die toegankelijk moeten zijn voor het FES. Deze optie op true zetten betekent dat iedereen die toegang heeft tot de Dynamics communicatiekanalen of de API-sleutel bestanden kan lezen en schrijven in alle mappen die toegankelijk zijn voor de FES dienst.
De potentiële veiligheidsimplicaties zijn de reden dat deze optie standaard is uitgeschakeld.
De standaardwaarde is “Ssh.NET”. Als de server authenticatiemethodes gebruikt die niet worden ondersteund door SSH.NET (zoals rsa-sha2-256), kun je deze waarde veranderen in “WinSCP” om dat te gebruiken voor de verbinding. We raden sterk aan om de verbinding te testen met de WinSCP GUI (we gebruiken WinSCP versie 6.1, hier te downloaden: https://winscp.net/eng/download.php) als de verbinding met succes tot stand kan worden gebracht. Voor het sleutelbestand moet een .ppk-sleutelbestand worden gebruikt. Het programma “PuTTYgen” kan gebruikt worden om zo’n bestand te maken.
De toegang tot de service beperken tot bepaalde IP’s of DNS-namen. (Lees hier meer)
De configuratie van het service-eindpunt, zoals het adres, de poort en of Https of Http moet worden gebruikt. (Lees hier meer)
Volgende stappen
Je kunt nu het communicatiekanaal instellen in Anveo EDI Connect.