File Exchange Service
Mit dem Anveo EDI Connect-Dateiaustauschdienst können Daten von anderen Systemen empfangen und gesendet werden. Zu diesem Zweck wird ein Dienst außerhalb von Dynamics angesprochen, der die Daten verarbeitet. Dieser Dienst wird in der Regel auf dem ServiceTier (OnPrem-Installationen) oder auf einem öffentlich zugänglichen Server (Cloud-Installationen) ausgeführt. Für den Betrieb mit Anveo EDI Connect auf Ihrer eigenen Infrastruktur bieten wir Ihnen kostenlose Lizenzen für den Dienst an.
Um diesen Dienst zu nutzen, benötigen Sie Anveo EDI Connect Version 5.3.0.4 oder höher.
Der Service kann von allen Installationen unseres Moduls (OnPrem und Cloud) ab Dynamics NAV 2013 genutzt werden.
Übersicht
Der Dienst wird als eine einzige Anwendungsdatei geliefert. Die Anwendung kann zu Test- und Debugging-Zwecken als Konsolenanwendung gestartet werden. Für den Produktionsbetrieb empfehlen wir, die Anwendung als Dienst zu registrieren. Der Dienst kann auf jedem System gehostet werden, das von Dynamics aus zugänglich ist. Für alle Installationen, bei denen Sie Zugriff auf das Dynamics ServiceTier haben, empfehlen wir jedoch dringend, es zusammen mit dem ServiceTier zu installieren. Der Dienst unterstützt nicht die parallele Ausführung mehrerer Instanzen. Wenn Sie also mehrere ServiceTiers auf verschiedenen Rechnern haben, sollten Sie den Dienst auf einem einzigen Rechner installieren.
Befindet sich der Dienst auf einem anderen Rechner als das ServiceTier, muss der Zugriff über die Konfiguration erlaubt werden. Wir empfehlen in diesem Fall dringend die Verwendung einer verschlüsselten Https-Verbindung. Dies kann über die Konfiguration eingestellt werden.
Installation des Dienstes
Kopieren Sie die Dateien AnveoFileExchangeService.exe und appsettings.json in einen Pfad auf Ihrem Server und stellen Sie sicher, dass der Benutzer, der den Dienst ausführen soll, Zugriffsrechte auf dieses Verzeichnis hat.
Die Anwendung kann mit dem folgenden Befehl (in der Konsole oder Powershell) mit Administratorrechten installiert werden:
Bitte ändern Sie C:InstallationPfad in den Pfad, in den Sie die Anwendung kopiert haben.
Zu Test- und Debuggingzwecken kann die AnveoFileExchangeService.exe auch direkt gestartet werden.
Konfiguration
Der größte Teil der Konfiguration wird in Microsoft Dynamics NAV 2013R2 vorgenommen. Es gibt einige Einstellungen, die für den Dienst konfiguriert werden müssen. Sie finden diese Einstellungen in der Datei appsettings.json, die mit dem Dienst geliefert wird. Die Konfigurationsdatei muss sich in demselben Ordner wie die Anwendungsdatei befinden.
Ändern Sie diesen Wert in eine lange geheime Zeichenfolge und geben Sie dieselbe Zeichenfolge in Dynamics ein. Wir empfehlen, eine GUID zu erstellen und alle Sonderzeichen zu entfernen, aber es bleibt Ihnen überlassen, eine sichere Zeichenfolge zu wählen. Bei der Verwendung von Http wird das Geheimnis im Klartext übertragen. Bitte verwenden Sie Https, wenn der Dienst nicht auf dem ServiceTier installiert ist.
Ob der Dienst auf alle lokalen Dateien auf dem Server zugreifen kann (unter Verwendung des Benutzerkontos, unter dem der Dienst ausgeführt wird) und Skriptdateien ausführen kann.
Bitte stellen Sie sicher, dass der Benutzer, der den Dienst ausführt, nur auf die Verzeichnisse zugreifen kann, die für das FES zugänglich sein sollen. Die Einstellung dieser Option auf true bedeutet, dass jeder, der Zugriff auf die Dynamics-Kommunikationskanäle oder den API-Schlüssel hat, Dateien in allen Verzeichnissen, auf die der FES-Dienst Zugriff hat, lesen und schreiben kann.
Der Grund, warum diese Option standardmäßig deaktiviert ist, sind die potenziellen Auswirkungen auf die Sicherheit.
Der Standardwert ist „Ssh.NET“. Wenn der Server Authentifizierungsmethoden verwendet, die von SSH.NET nicht unterstützt werden (z. B. rsa-sha2-256), können Sie diesen Wert in „WinSCP“ ändern, um diese für die Verbindung zu verwenden. Wir empfehlen dringend, die Verbindung mit der WinSCP GUI zu testen (wir verwenden WinSCP Version 6.1, Download hier: https://winscp.net/eng/download.php), wenn die Verbindung erfolgreich hergestellt werden kann. Was die Schlüsseldatei betrifft, so muss eine .ppk-Schlüsseldatei verwendet werden. Das Programm „PuTTYgen“ kann verwendet werden, um eine solche Datei zu erstellen.
Beschränken Sie den Zugriff auf den Dienst auf bestimmte IPs oder DNS-Namen. (Hier erfahren Sie mehr)
Die Konfiguration des Dienst-Endpunkts, wie Adresse, Port und ob Https oder Http verwendet werden soll. (Hier erfahren Sie mehr)
Nächste Schritte
Sie können nun den Kommunikationskanal in Anveo EDI Connect einrichten.