File Exchange Service
O serviço de troca de ficheiros Anvaigo 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 Anvaigo 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 Anvaigo 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 de troca de ficheiros Anvaigo é fornecido como um arquivo ZIP que contém todos os componentes necessários para executar a aplicação, incluindo o tempo de execução .NET necessário. Devido às suas dependências, a aplicação só é suportada em sistemas Windows de 64 bits.
O serviço pode ser lançado como uma aplicação de consola, o que é útil para testes e depuração. Para utilização em produção, recomenda-se que a aplicação seja registada como um serviço do Windows.
O serviço pode ser alojado em qualquer sistema que seja acessível a partir do Dynamics. No entanto, para instalações onde o Dynamics ServiceTier está disponível, é altamente recomendável instalar o serviço na mesma máquina que o ServiceTier.
Note-se que o serviço não suporta a execução de várias instâncias em paralelo. Se tiver vários ServiceTiers em máquinas diferentes, o serviço só deve ser instalado e operado numa única máquina.
Se o serviço estiver alojado numa máquina diferente da ServiceTier, é necessário configurar o acesso em conformidade. Nesses casos, é fortemente aconselhada a utilização de uma ligação Https encriptada, que pode ser configurada através das definições do serviço.
Os seguintes protocolos são suportados pelo Serviço de Troca de Ficheiros: POP3 e SMTP (OAuth2 é suportado para ambos), FTP, FTPS e SFTP. Além disso, é possível aceder ao sistema de ficheiros local (rede) do servidor.
Instalação do serviço
Extrair o arquivo ZIP
Antes de descompactar o arquivo ZIP, certifique-se de que o Windows o reconheça como uma fonte confiável. Este passo é crucial, uma vez que o arquivo contém vários ficheiros DLL em que o sistema operativo deve confiar após a extração.
Copiar ficheiros para o diretório do servidor
Extrair e copiar todo o conteúdo do ficheiro ZIP, incluindo AnvaigoFileExchangeService.exe, appsettings.jsone todos os outros ficheiros incluídos, para um diretório de destino no seu servidor.
Atribuir permissões de diretório
Conceda os direitos de acesso adequados à conta de utilizador que irá executar o serviço. Este utilizador deve ter acesso total ao diretório de destino para garantir que o serviço funciona corretamente.
A aplicação pode ser instalada como um serviço do Windows com o seguinte comando (na consola ou no Powershell) com privilégios de administrador:
sc.exe create "Anvaigo File Exchange Service" binpath="C:InstallationPathAnvaigoFileExchangeService.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 AnvaigoFileExchangeService.exe pode ser iniciado diretamente. Neste modo autónomo, a aplicação é executada enquanto a janela da consola permanecer aberta e envia os eventos de registo diretamente para a consola, o que é útil para a resolução de problemas. Note-se que a aplicação não pode ser executada em modo autónomo enquanto o serviço estiver ativo. É necessário parar o serviço do Windows antes de iniciar a aplicação manualmente.
Configuração
A maior parte da configuração é efectuada no Microsoft Dynamics 365 Business Central. 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.
Altere este valor para uma cadeia secreta longa e introduza a mesma cadeia no Dynamics. 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 ser utilizado o Http, o segredo é transferido em texto simples. Utilize Https quando o serviço não estiver instalado no ServiceTier.
Se o canal de comunicação no Dynamics estiver definido para arquivar o ficheiro, com esta opção activada, será adicionado um carimbo de data/hora ao nome do ficheiro no arquivo. O valor predefinido é false.
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. O valor predefinido é false.
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.
Se pretender executar scripts para obter ou enviar ficheiros do sistema de ficheiros, defina esta opção como false. O valor predefinido é true.
A biblioteca SFTP predefinida utilizada pelo serviço de troca de ficheiros Anvaigo é “Ssh.NET”. Se o servidor exigir métodos de autenticação não suportados pelo Ssh.NET, como o rsa-sha2-256, pode passar a utilizar o “WinSCP” alterando a definição de configuração em conformidade.
Nesses casos, recomendamos vivamente que teste a ligação utilizando o WinSCP GUI, que pode ser descarregado a partir de https://winscp.net/eng/download.php. Isto ajuda a verificar se a ligação pode ser estabelecida com êxito antes de a configurar no serviço.
Quando se utiliza a autenticação baseada em chaves, um .ppk é necessário. Pode criar este ficheiro utilizando a ferramenta “PuTTYgen”.
Ativar o modo de listagem lenta se as listagens de diretórios predefinidas falharem. Isto recupera informações para cada ficheiro individualmente e é significativamente mais lento. O valor predefinido é false.
Use o GnuTLS em vez da biblioteca TLS do Windows para FTPS. O GnuTLS suporta diferentes opções de encriptação e é necessário se o parceiro necessitar de curvas elípticas mais seguras. Esta definição aplica-se globalmente a todas as ligações. O valor predefinido é false.
Se colar o URL de ligação num browser, verá uma página de boas-vindas do serviço File Exchange. Se não pretender esse comportamento, defina-o como true. O valor predefinido é false.
Se pretender ativar o cabeçalho HSTS (HTTP Strict Transport Security), defina esta opção como true. O valor predefinido é false.
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 Anvaigo EDI Connect.