File Exchange Service
O serviço de troca de ficheiros Anveo EDI Connect permite que os dados sejam recebidos e enviados por outros sistemas. Para o efeito, é contactado um serviço externo à Dynamics, que processa os dados. Este serviço é normalmente executado nas instalações ServiceTier (OnPrem) ou num servidor acessível ao público (instalações Cloud). Para o funcionamento com Anveo EDI Connect na sua própria infraestrutura, oferecemos licenças gratuitas para o serviço.
Para utilizar este serviço, é necessária a versão 5.3.0.4 ou superior do Anveo EDI Connect.
O serviço pode ser utilizado em todas as instalações do nosso módulo (OnPrem e Cloud) a partir do Dynamics NAV 2013.
Visão geral
O serviço é fornecido como um único ficheiro de aplicação. A aplicação pode ser lançada como uma aplicação de consola para fins de teste e depuração. Para o funcionamento em produção, recomendamos que a aplicação seja registada como um serviço. O serviço pode ser alojado em qualquer sistema que seja acessível a partir do Dynamics. No entanto, para todas as instalações em que tem acesso ao Dynamics ServiceTier, recomendamos vivamente que o instale juntamente com o ServiceTier. O serviço não suporta múltiplas instâncias a funcionar em paralelo. Assim, se tiver vários ServiceTiers em máquinas diferentes, deve instalar o serviço numa única máquina.
Se o serviço estiver localizado numa máquina diferente da ServiceTier, o acesso tem de ser permitido através da configuração e, neste caso, aconselhamos vivamente a utilização de uma ligação Https encriptada. Isto pode ser definido através da configuração.
Instalação do serviço
Copie os ficheiros AnveoFileExchangeService.exe e appsettings.json para um caminho no seu servidor e certifique-se de que o utilizador que deve executar o serviço tem direitos de acesso a esse diretório.
A aplicação pode ser instalada com o seguinte comando (na consola ou no Powershell) com privilégios de administrador:
sc.exe create "Anveo File Exchange Service" binpath="C:InstallationPathAnveoFileExchangeService.exe --contentRoot=C:InstallationPath"Altere C:InstallationPath para o caminho para o qual copiou a aplicação.
Para efeitos de teste e depuração, o AnveoFileExchangeService.exe também pode ser iniciado diretamente.
Configuração
A maior parte da configuração é efectuada no Microsoft Dynamics NAV 2015. Existem algumas definições que têm de ser configuradas para o serviço. Pode encontrar estas definições no ficheiro appsettings.json que é fornecido com o serviço. O ficheiro de configuração tem de estar na mesma pasta que o ficheiro da aplicação.
Alterar este valor para uma cadeia secreta longa e introduzir a mesma cadeia na Dinâmica. Recomendamos a criação de um GUID e a remoção de todos os caracteres especiais, mas cabe-lhe a si escolher uma cadeia de caracteres segura. No caso de se utilizar Http, o segredo é transferido em texto simples. Utilize Https quando o serviço não estiver instalado no ServiceTier.
Se o serviço pode aceder a todos os ficheiros locais no servidor (utilizando a conta de utilizador que executa o serviço) e executar ficheiros de script.
Certifique-se de que o utilizador que executa o serviço só pode aceder aos diretórios que devem ser acessíveis ao FES. Definir esta opção como verdadeira significa que qualquer pessoa que tenha acesso aos canais de comunicação Dynamics ou à chave API pode ler e escrever ficheiros em todas as diretorias acessíveis ao serviço FES.
As potenciais implicações de segurança são a razão pela qual esta opção está desactivada por defeito.
O valor predefinido é “Ssh.NET”. Se o servidor utilizar métodos de autenticação que não são suportados pelo SSH.NET (como o rsa-sha2-256), pode alterar este valor para “WinSCP”, de modo a utilizá-lo para a ligação. Recomendamos vivamente que teste a ligação com a GUI do WinSCP (utilizamos a versão 6.1 do WinSCP, descarregada aqui: https://winscp.net/eng/download.php) se a ligação puder ser estabelecida com êxito. Relativamente ao ficheiro de chaves, tem de ser utilizado um ficheiro de chaves .ppk. O programa “PuTTYgen” pode ser utilizado para criar esse ficheiro.
Limitar o acesso ao serviço a determinados IPs ou nomes DNS. (Saiba mais aqui)
A configuração do ponto de extremidade do serviço, como o endereço, a porta e a utilização de Https ou Http. (Saiba mais aqui)
Próximos passos
Pode agora configurar o canal de comunicação no Anveo EDI Connect.