O Manual de Transferência de Arquivos apresenta a ferramenta WebEDI que será utilizada entre FGC/IMS e as Instituições Financeiras para troca de arquivos. Manual de Transferência de Arquivos WebEDI Versão 2.0
Manual de Transferência de Arquivos - WebEDI Elaborado por: IMS Tecnologia e Serviços LTDA Este documento contém informações confidenciais e de propriedade da IMS nenhuma parte deste documento pode ser reproduzida ou utilizada por qualquer meio, eletrônico ou mecânico, incluindo fotocópia e microfilme, sem permissão por escrito da IMS, sendo passível de ação judicial, exceto em casos de uso interno e declarado pela empresa. IMS Tecnologia e Serviços LTDA Todos os Direitos Reservados http://www.imstech.com.br/ Data Versão Descrição Autor 20/09/2012 1.0 Elaboração da Primeira Versão do Manual Aline Lemos 26/10/2012 2.0 Versão Final do Manual para Entrada em Produção Aline Lemos 1
SUMÁRIO 1. INTRODUÇÃO... 3 2. WebEDI... 4 2.1. Aplicação WebEDI... 4 2.2. Pré-requisitos de Funcionamento do Software... 5 2.3. Instalação... 6 2.4. Informações Técnicas... 7 2.5. Testando o Funcionamento do Software... 7 2.6. Configurando um Servidor Proxy... 8 2.7. Conhecendo o Software Menus e Barra de Ferramentas... 10 2.8. Enviando Arquivos... 12 2.9. Recebendo Arquivos... 13 2.10. Atualizando o Cache de Informações... 14 2.11. Agendando Tarefas... 15 3. INFORMAÇÕES GERAIS... 17 2
1. INTRODUÇÃO O Manual de Transferência de Arquivos tem a finalidade de descrever os procedimentos que as Instituições Financeiras (IF) devem seguir para configurar e efetuar a troca (envio e recepção) de arquivos com o FGC via WebEDI. 3
2. WebEDI 2.1. Aplicação WebEDI A aplicação de WebEDI permite que a troca de arquivos entre o FGC/IMS e seus parceiros de negócio, seja realizada de uma maneira mais segura e controlada. A aplicação é desenvolvida na plataforma Microsoft e roda em qualquer estação que tenha instalado o Windows XP, Windows 2000 e Windows 2003, Windows Vista e Windows 7, com o Framework.NET 2.0. O WebEDI monitora desde o envio do arquivo até sua gravação no diretório do destinatário, gerando logs com data/ hora e status para cada uma das atividades realizadas (envio e recepção de arquivos). Para que a aplicação funcione é necessário que a estação em que ela esteja instalada tenha acesso à internet liberada para os endereços - webedi.ecomm.com.br e criptoedi.ecomm.com.br, na porta 443. Ressaltamos que não é necessária a abertura de nenhuma porta específica para o funcionamento do aplicativo e também que os arquivos não são transferidos por FTP e sim por um túnel criptografado. Visando garantir a segurança e integridade dos arquivos enviados, a aplicação possui as seguintes características: Criptografia com certificado de segurança SSL (Secure Socket Layer) de 128 bits Blow Fish com chave forte de 1024 bits para enviar as informações de autenticação e parceiros; Utilização de um túnel criptografado para fazer a transferência dos arquivos. Esta transferência é feita a partir de troca de chaves de segurança entre a aplicação e o servidor. Abaixo as especificações: o Chaves: diffie-hellman-group-exchange-sha1, diffie-hellmangroup1-sha1 4
o Cipher: 3des-cbc, aes128-cbc o MAC: hmac-md5 o Public Key: 2048 bits Fechada à conexão o arquivo é enviado pelo túnel criptografado, que utiliza o que há de mais forte hoje no mercado em relação aos Ciphers. São eles: 3DES, Blowfish, AES e Arcfour (RC4[TM] da RSA). IMPORTANTE - Após o arquivo chegar aos servidores da WebEDI, o arquivo fica criptografado pelo modelo EFS (Encrypted File System) com certificado de segurança. Os Status dos arquivos também podem ser acompanhados pelo portal Web do sistema, que também se utiliza da tecnologia de segurança SSL para acesso. RESUMO DOS RECURSOS: Sistema de transferência segura de arquivos via túnel criptografado; Automatização dos processos de envio e retorno (Windows Service); Compactação total dos arquivos trafegados (4% a mais que a média de mercado); Trilha de auditoria; Portal Web com acesso criptografado via SSL (Secure Socket Layer); Dezenas de combinações de relatórios analíticos; Chave de ativação única para cada software de transferência de arquivos; Utilização apenas das portas padrão para segurança (443); 2.2. Pré-requisitos de Funcionamento do Software Esta versão do WebEDI 5.0, foi feita utilizando a plataforma.net (versão 4.0) da Microsoft. Esta versão, roda somente em sistemas operacionais Windows. Abaixo, temos a lista do Sistemas suportados: Windows XP SP3 5
Windows Server 2003 SP2 Windows Vista SP1 ou posterior Windows Server 2008 (sem suporte na função Server Core) Windows 7 Windows Server 2008 R2 (sem suporte na função Server Core) Windows 7 SP1 Windows Server 2008 R2 SP1 Necessária arquitetura com suporte: X86 X64 Ia64 (não há suporte para alguns recursos ia64, por exemplo, o WPF) Todos os sistemas acima precisam contemplar os seguintes requisitos de Hardware: Processador: Pentium 1 GHz ou superior Memória: 512 MB ou superior Disco (HD): X86 850 MB Livres X64 2 GB Livres 2.3. Instalação Para instalar, acesse o endereço: http://release.ecomm.com.br e utilize o usuário e senha fornecidos pela IMS. 6
2.4. Informações Técnicas O WebEDI é muito simples de ser configurado em sua rede. Ele não precisa de nenhuma porta especial para funcionar. Basta a estação possuir o acesso HTTPS (443) liberados e ele já está funcionando. Veja abaixo as necessidades de conectividade: Endereço Web Porta webedi.ecomm.com.br * SSL (443) criptoedi.ecomm.com.br * SSL (443) Para verificar se o software está funcionando corretamente, você pode verificar o item Testando Funcionamento do Software. Nesta função serão exibidos todos os detalhes das conexões. * A máquina na qual o software for instalado, deve conseguir resolver nomes na Internet (DNS) para o correto funcionamento da aplicação. 2.5. Testando o Funcionamento do Software O software WebEDI, possui um sistema de "auto-diagnóstico", onde ele aponta os problemas de conexão e criptografia que podem interferir na transmissão das informações. Para acessar a ferramenta deve-se utilizar o menu principal da aplicação em "Configurações > Testar funcionamento do Software". Em seguida será exibida a tela abaixo, onde os testes são realizados: 7
Para que as transferências possam ser efetuadas com sucesso, a tela deve exibir um resultado igual ao mostrado acima. Caso algum dos serviços falhe, verifique os requisitos técnicos e de conectividade, para verificar se você tem realmente acesso a todos os serviços necessários. Para facilitar a visualização do problema, pode-se também, consultar o arquivo de log. Aqui é possível obter informações mais detalhadas. Obs.: * A máquina na qual o software for instalado deve conseguir resolver nomes na Internet (DNS) para o correto funcionamento da aplicação. ** Caso seja necessário um prazo maior, favor entrar em contato com a IMS para verificar a disponibilidade. 2.6. Configurando um Servidor Proxy A conexão no WebEDI, pode ser feita como uma conexão direta, ou via um servidor de acesso a Internet, um servidor Proxy/Firewall. 8
Para acessar as opções de configuração de conexão com a Internet, deve-se utilizar o menu principal em "Configurações > Opções de Conexão". Em seguida será exibida a tela abaixo, onde podemos verificar as opções disponíveis: Como padrão, o WebEDI, vem configurado para acessar a internet diretamente, ou seja, sem servidores de acesso. No item 1 da figura você pode optar por deixar desta maneira ou configurar um servidor Proxy. Para configurar o Proxy, deve-se selecionar a opção "Utilizar servidor PROXY" e então preencher os dados de acesso no formulário (figura item 2): Caso seu servidor Proxy, se utilize do protocolo de autenticação NTML da Microsoft, o checkbox do item 3, deve ser acionado, pois o acesso ao serviço de 9
criptografia, não dá suporte a esta tecnologia. Neste caso, obrigatoriamente, o endereço criptoedi.ecomm.com.br na porta 443, deve possuir uma saída direta para a Internet. Após feitas as configurações, deve-se fazer o teste de funcionamento do software. 2.7. Conhecendo o Software Menus e Barra de Ferramentas O WebEDI possui uma interface simples e "auto-explicativa". Abaixo, está relacionado os itens do menu superior e da barra de ferramentas, explicando cada item. Itens do Menu Principal: 1. Arquivos: Enviar e Receber arquivos > Faz o envio e recepção dos arquivos de uma só vez (Atalho CTRL + SHIFT + T); Enviar Arquivos > Faz apenas os envios, não recebe nada (Atalho CTRL + E); Receber Arquivos > Faz apenas a recepção de arquivos, não envia nada (Atalho CTRL + R); Minimizar a Aplicação > Esconde a aplicação (que continua rodando), mantendo apenas o ícone na barra de tarefas do Windows; Encerrar a Aplicação > Fecha o aplicativo. Caso o windows service esteja funcionando, o mesmo não é afetado e continua funcionando. (Atalho: ALT + F4). 10
2. Configurações: Testar Funcionamento do Software > Verifica se o software possui acesso a todos os serviços necessário para o correto funcionamento; Opções Avançadas > Abre as opções de configuração avançadas. Habilitar o cache de informações > Habilita a gravação de informações na máquina, para que as consultas sejam feitas de maneira mais rápida. Configurações Gerais do Software > Permite que o usuário escolha o tipo de transmissão (túnel criptografado ou HTTPS) e também a rotatividade dos arquivos de Log e Cache. Opções de Conexão > Permite que o usuário escolha o tipo de conexão com a Internet. Direta, ou via Proxy. (Atalho: Não possui). Verificar atualizações do Software > Aciona o software "ecomm Live Update" que vai buscar por atualizações do software no site da IMS Web Services. Atualizar o Cache de Informações > Faz a atualização do Cache do EDI na máquina do cliente. Esta opção faz com que as informações estejam sempre atualizadas. 3. Agendamentos: Agendamento Padrão > Aqui o usuário vai determinar de quanto em quanto tempo o software deverá realizar as tarefas escolhidas. Padrão Windows Service > Configurações para o tipo de agendamento Windows Service. Verificar Configurações > Mostra o status do Windows Service, se está instalado, se está rodando ou parado. Pode-se instalar ou desinstalar o serviço por aqui. 4. Relatórios: Geral > Mostra um relatório com alguns tipos de filtro como data, parceiros, status. É possível exportar as informações para um Excel ou PDF. Arquivos Enviados > Envia para o site do EDI para um relatório mais detalhado. 11
Arquivos Recebidos > Envia para o site do EDI para um relatório mais detalhado. (Atalho: Não possui). 5. Ajuda: Ajuda > Mostra este arquivo de ajuda. Ajuda On-line > Envia para o site do EDI para um relatório mais detalhado. Site ecomm WebEDI > Envia para o site do EDI para um relatório mais detalhado. Informações sobre o registro > Mostra as informações de registro do software (Usuário, chave de ativação). 2.8. Enviando Arquivos Para fazer o envio de arquivos você deve possuir seus dados já cadastrados junto a IMS. Feito isso, basta você utilizar a opção Enviar Arquivos no menu (ou utilizar o atalho CTRL + E). Em seguida será exibida a tela abaixo, onde os envios serão monitorados: 12
Após o envio dos arquivos, será exibido um sumário das transferências, com o total de arquivos enviados e também, total com erros e com sucesso. Caso algum arquivo da fila, gere algum erro, o mesmo não vai interromper as transferências. Para uma visão mais detalhada do problema, pode-ser consultar os arquivos de Log ou utilizar o atalho (CTRL + L). Os arquivos enviados ficam no Datacenter da IMS criptografados até que seu destinatário o receba, pelo prazo de 15 dias**. Na figura acima podemos verificar os dados da transferência criptografada. Obs.: * A máquina na qual o software for instalado, deve conseguir resolver nomes na Internet (DNS) para o correto funcionamento da aplicação. ** - Caso seja necessário um prazo maior, favor entrar em contato com a IMS para verificar a disponibilidade. 2.9. Recebendo Arquivos Para fazer a recepção de arquivos você deve possuir seus dados já cadastrados junto a IMS. Feito isso, basta você utilizar a opção Receber Arquivos no menu (ou utilizar o atalho CTRL + R). Em seguida será exibida a tela abaixo, onde os recebimentos serão monitorados: 13
Os arquivos serão automaticamente colocados na pasta escolhida no cadastro junto a IMS e também já estarão descriptografados e em caso de uso de compactação, descompactados. Caso algum arquivo da fila, gere algum erro, o mesmo não vai interromper as transferências. Para uma visão mais detalhada do problema, pode-se consultar os arquivos de Log ou utilizar o atalho (CTRL + L). Os arquivos enviados ficam no Datacenter da IMS criptografados até que seu destinatário o receba, pelo prazo de 15 dias**. Na figura acima podemos verificar os dados da transferência criptografada. Obs.: * A máquina na qual o software for instalado, deve conseguir resolver nomes na Internet (DNS) para o correto funcionamento da aplicação. ** Caso seja necessário um prazo maior, favor entrar em contato com a IMS para verificar a disponibilidade. 2.10. Atualizando o Cache de Informações No WebEDI, é possível armazenar as informações sobre transferências em um sistema de Cache. Assim o software pode ser muito mais rápido e preciso em suas transações. Para acessar a ferramenta de atualização, deve-se utilizar o menu principal em: "Configurações > Atualizar o Cache de Informações". Em seguida será exibida a tela abaixo: 14
Para atualizar a cache, basta clicar em atualizar. Caso não seja possível atualizar o cache, devem ser verificadas as configurações de conexão e testar o funcionamento do software, para garantir que todos os serviços estão acessíveis. Caso o erro persista, pode-se consultar os arquivos de Log ou utilizar o atalho (CTRL + L), para obter uma visão mais detalhada do problema. 2.11. Agendando Tarefas O agendamento de tarefas permite que o usuário, cadastre um intervalo de tempo, para que o software faça a pesquisa por envio / recepção de arquivos automaticamente, sem intervenção de um operador. Para acessar esta função, deve-se utilizar o menu "Agendamentos > Agendamento Padrão". Em seguida será exibida a tela abaixo, onde são exibidos os dados dos agendamentos: 15
O agendamento, pode ser feito em um intervalo de tempo pré-determinado (Ex. de 10 em 10 minutos) ou pode-se programar dia e hora exatos para a execução**. As ações também podem ser escolhidas entre somente enviar, somente receber ou enviar e receber. Para executar tarefas nos sistemas Windows, deve ser instalado o Windows Service. Após instalado o Windows Services, a aplicação pode ser até finalizada, que o agendamento vai continuar. **Para que as tarefas ocorram exatamente no horário determinado, deve-se verificar se a configuração do relógio do sistema (Windows) está com o horário correto. 16
3. INFORMAÇÕES GERAIS Para esclarecimento de dúvida enviar e-mail para suporte@imstech.com.br ou entrar em contato pelo telefone (11) 3646-4200. 17