File Exchange Service
Usługa wymiany plików Anveo EDI Connect umożliwia odbieranie i wysyłanie danych przez inne systemy. W tym celu adresowana jest usługa spoza Dynamics, która przetwarza dane. Usługa ta jest zwykle uruchamiana w instalacjach ServiceTier (OnPrem) lub na publicznie dostępnym serwerze (instalacje w chmurze). Do pracy z Anveo EDI Connect we własnej infrastrukturze oferujemy bezpłatne licencje na usługę.
Do korzystania z tej usługi wymagana jest wersja Anveo EDI Connect 5.3.0.4 lub nowsza.
Usługa może być używana ze wszystkich instalacji naszego modułu (OnPrem i Cloud) począwszy od Dynamics NAV 2013.
Przegląd
Usługa jest dostarczana jako pojedynczy plik aplikacji. Aplikację można uruchomić jako aplikację konsolową do celów testowania i debugowania. W przypadku działania produkcyjnego zalecamy zarejestrowanie aplikacji jako usługi. Usługa może być hostowana w dowolnym systemie, który jest dostępny z Dynamics. Jednak w przypadku wszystkich instalacji, w których masz dostęp do Dynamics ServiceTier, zdecydowanie zalecamy zainstalowanie go wraz z ServiceTier. Usługa nie obsługuje wielu instancji działających równolegle. Jeśli więc masz wiele ServiceTierów na różnych komputerach, powinieneś zainstalować usługę na jednym komputerze.
Jeśli usługa znajduje się na innej maszynie niż ServiceTier, dostęp musi być dozwolony poprzez konfigurację i zdecydowanie zalecamy użycie szyfrowanego połączenia Https w tym przypadku. Można to ustawić za pomocą konfiguracji.
Instalacja usługi
Skopiuj pliki AnveoFileExchangeService.exe i appsettings.json na ścieżkę na serwerze i upewnij się, że użytkownik, który ma uruchomić usługę, ma prawa dostępu do tego katalogu.
Aplikację można zainstalować za pomocą następującego polecenia (w konsoli lub Powershell) z uprawnieniami administratora:
sc.exe create "Anveo File Exchange Service" binpath="C:InstallationPathAnveoFileExchangeService.exe --contentRoot=C:InstallationPath"Zmień C:InstallationPath na ścieżkę, do której skopiowałeś aplikację.
Do celów testowych i debugowania AnveoFileExchangeService.exe może być również uruchamiany bezpośrednio.
Konfiguracja
Większość konfiguracji odbywa się w Microsoft Dynamics 365 Business Central. Istnieje kilka ustawień, które należy skonfigurować dla usługi. Ustawienia te można znaleźć w pliku appsettings.json dostarczanym wraz z usługą. Plik konfiguracyjny musi znajdować się w tym samym folderze co plik aplikacji.
Zmień tę wartość na długi tajny ciąg i wprowadź ten sam ciąg w Dynamics. Zalecamy utworzenie identyfikatora GUID i usunięcie wszystkich znaków specjalnych, ale wybór bezpiecznego ciągu znaków należy do użytkownika. W przypadku korzystania z protokołu Http sekret jest przesyłany w postaci zwykłego tekstu. Jeśli usługa nie jest zainstalowana w ServiceTier, należy użyć protokołu Https.
Czy usługa może uzyskać dostęp do wszystkich plików lokalnych na serwerze (przy użyciu konta użytkownika, który uruchamia usługę) i wykonywać pliki skryptów.
Upewnij się, że użytkownik uruchamiający usługę ma dostęp tylko do katalogów, które powinny być dostępne dla FES. Ustawienie tej opcji na true oznacza, że każdy, kto ma dostęp do kanałów komunikacyjnych Dynamics lub klucza API, może odczytywać i zapisywać pliki we wszystkich katalogach dostępnych dla usługi FES.
Potencjalne konsekwencje dla bezpieczeństwa są powodem, dla którego opcja ta jest domyślnie wyłączona.
Wartością domyślną jest „Ssh.NET”. Jeśli serwer używa metod uwierzytelniania, które nie są obsługiwane przez SSH.NET (takich jak rsa-sha2-256), możesz zmienić tę wartość na „WinSCP”, aby użyć jej do połączenia. Zdecydowanie zalecamy przetestowanie połączenia za pomocą interfejsu graficznego WinSCP (używamy WinSCP w wersji 6.1, do pobrania tutaj: https://winscp.net/eng/download.php), jeśli połączenie może zostać nawiązane pomyślnie. Jeśli chodzi o plik klucza, należy użyć pliku klucza .ppk. Do utworzenia takiego pliku można użyć programu „PuTTYgen”.
Ograniczenie dostępu do usługi do określonych adresów IP lub nazw DNS. (Więcej informacji tutaj)
Konfiguracja punktu końcowego usługi, takiego jak adres, port i to, czy używać Https czy Http. (Więcej informacji tutaj)
Następne kroki
Możesz teraz skonfigurować kanał komunikacji w Anveo EDI Connect.