`

Apus Client

1
Manual do Produto
002.C.02
Apus Client

Versão: 4.0.15
Publicação: Julho/2020
Abrangência: Bancos e Empresas
Responsável: Produtos

2
ÍNDICE

1. O que é o Apus Client ................................................................................................ 04

2. Onde conseguir o instalador .................................................................................... 04

3. Pré-requisitos ............................................................................................................. 04

4. Como funciona ........................................................................................................... 05

4.1. Conexão e validação de usuário ................................................................. 05

4.2. Download de documentos ........................................................................05

4.3. Upload de documentos ........................................................................... 05

4.4. Recebimento de confirmação.................................................................. 05

4.5. Processos de verificação de backup....................................................... 06

5. Tipos de Instalação .................................................................................................... 06

6. Instalação básica........................................................................................................ 07

7. Instalação/Configuração Proxy ................................................................................ 09

8. Configuração Accesstage ......................................................................................... 10

9. Integração com processos externos ....................................................................... 10

10.Utilização do Apus Client ......................................................................................... 10

11. Acesso as configurações do Apus Client............................................................. 11

11.1. Conexão ........................................................................................................ 12

11.2. Usuário .......................................................................................................... 12

11.3. Log Apus Client ............................................................................................ 13

12. Agendamento do Apus Client................................................................................. 13

13. Configuração em modo texto ( Unix ) .................................................................... 14

14. Instalação em ambiente Unix-like .......................................................................... 14

3
1. O que é o Apus Client:

O Apus Client é um aplicativo oferecido pela Accesstage, a todos os seus clientes, para
o estabelecimento da troca de documentos através de sua estrutura. Como todo
processo de EDI, o cliente deve ter uma forma de estabelecer uma conexão segura,
tanto no que diz respeito ao sigilo dos documentos transacionados, quanto à garantia de
envio e recebimentos destes documentos.

A garantia de envio e recebimento de documentos é garantida com a utilização da

tecnologia de JMS (Java Message Store) amplamente utilizada pelo mercador brasileiro
nas trocas de documentos. Esta tecnologia nos garante uma série de funcionalidades
que habilita o Apus Client a controlar a troca de documentos de forma transacional.
Adicionalmente a isto, o Apus Client ainda agrega funcionalidades de integrar processos
externos ao tratamento dos documentos recebidos ou aos documentos destinados ao
envio.

A camada de comunicação do Apus Client com os servidores da Accesstage se dá por

intermédio de protocolo HTTPS (porta 443), o que já determina a utilização da camada
SSL que provê criptografia às informações trafegadas, garantindo seu sigilo.

2. Onde conseguir o instalador:

O instalador do Apus Client normalmente será enviado ao cliente quando os serviços da

Accesstage tiverem sido configurados e prontos para entrar em produção, sendo
enviado diretamente para o e-mail indicado pelo cliente, contudo, cabe lembrar que este
instalador tem aproximadamente 2MB e pode ser recusado por alguns serviços de e-
mail devido ao seu tamanho, ou características, assim, este instalador poderá também
ser conseguido através de download diretamente de nosso site, ou enviado em CD-ROM
se o cliente assim o solicitar.

3. Pré-requisitos:

Java JRE:

- Java Sun 1.4 ou superior

- IBM JRE 1.4 ou superior

Sistema operacional:

- Windows XP SP3
- Windows 2003
- Windows 2008
- Windows 7
- Windows 8
- Windows 10
- RedHat Linux
- Debian Linux
- Ubuntu Linux

4
 - AIX
- Outros ambientes capacitados a executar Java com os requisitos necessários

Hardware mínimo:

- Processador: Arquitetura x86 com velocidade 1GHz ou superior

- Memória RAM: 512MB
- Espaço em disco: 1GB
*esteja atento aos requisitos mínimos do sistema operacional em uso.

4. Como funciona:

Basicamente, o Apus Client obedece a seguinte seqüência de processos para a troca

de documentos na estrutura da Accesstage:

4.1. Conexão e validação de usuário

O Apus Client verifica na configuração qual a forma de estabelecer a conexão entre o
cliente e a Accesstage e efetua a conexão usando os dados de usuário presentes no
Apus Client após sua instalação e configuração.

Estas configurações encontram-se no encriptadas no arquivo “apusclient.cfg”, no

diretório onde o Apus Client estiver instalado, e são geridas pelo próprio Apus Client em
sua tela de configuração, que será vista posteriormente.

Após a validação do usuário ter sido verificada, dados adicionais de configuração são
atualizados no Apus Client.

4.2. Download de documentos

O passo seguinte é o download dos documentos pertinentes àquele usuário validado na
conexão.

O processo de download é gerido de forma centralizada na Accesstage, e todos os

dados necessários ao processo de disponibilização dos documentos estão contidos na
própria mensagem.

4.3. Upload de documentos

O processo de upload se inicia imediatamente após o termino do processo de download
dos documentos, e as informações necessárias a este processo foram recebidas quando
da validação do usuário.

4.4. Recebimento de confirmação

Ao final do upload, o Apus Client irá verificar a existência de mensagens de confirmação
dos documentos enviados. Estes documentos são enviados para controle de todos os
documentos submetidos e se seu processo foi efetivado com sucesso.

5
 4.5. Processo de verificação de backup
Finalmente, são verificados todos os arquivos de backup de forma a deletar os arquivos
mais antigos – conforme regra definida em configuração do Apus Client.

5. Tipos de instalação

A instalação do Apus Client poderá ser realizada de três maneiras, de acordo com as
características da rede do usuário:

- Instalação Básica (Siga os procedimentos do Item 6): Realiza-se a instalação

básica, quando a comunicação é feita através da PORTA 443 ( porta padrão para
o protocolo HTTPS ), para tal, deve ser liberado este acesso aos servidores da
Accesstage, caso exista firewall na estrutura.
O destino sempre será “www.accesstage.com.br”, entretanto pode ser resolvido para
vários endereços IP's, de acordo com a estrutura da Accesstage que atenderá a
requisição.

Uma mesma transferência pode iniciar em uma estrutura e ser finalizada em outra,
assim, todos os endereços com os quais a Accesstage trabalha devem ser liberados.
No momento em que este manual foi redigido, estes endereços seriam:

189.2.61.101

187.50.25.101

200.225.81.34
Deve-ser contatado nosso departamento de suporte para confirmação dos endereços e
para validação em caso de problemas.

- Instalação Proxy (Siga os procedimentos do item7): Realiza-se a instalação com

Proxy, para os casos onde não é permitido a conexão direta com a PORTA 443
(HTTPS) dos servidores da Accesstage, e que se utilize um serviço de proxy na
empresa para controle de acesso.
Atualmente o Apus Client tem suporte a servidores de proxy tanto sem autenticação
quanto com diversas formas de autenticação, incluindo NTLM ( padrão Microsoft,
amplamente utilizado ).

6. Instalação Básica:

Novamente salientamos que na instalação básica, a comunicação se dará com destino

a PORTA 443 (HTTPS). Devido a isto, algumas configurações básicas de sua infra-
estrutura de rede devem ser necessárias de forma a habilitar o Apus Client a se
comunicar com a Accesstage através desta porta, a saber:

- Firewall: a PORTA 443 (HTTPS) deve ser liberada como “Destination Port”
para o equipamento que estará executando o Apus Client e, de forma a

6
 melhorar o nível de segurança para esta configuração, esta porta pode ser
configurada para acessar somente o endereço ”www.accesstage.com.br” (
189.2.61.101, 187.50.25.101, 200.225.81.34 )
Mesmo que seu acesso a Internet seja através de uma conexão discada, ou rede celular,
pode haver um firewall instalado em sua estação, e esta verificação deve ser realizada.

O processo de instalação básica desta versão do Apus Client é extremamente simples

e intuitivo. Ao executar o instalador, basicamente apenas dois passos são suficientes
para finalizar a instalação em sua máquina. Assim que você tiver o instalador em sua
máquina, execute-o e observe os passos abaixo:
Escolha o botão “Instalação Imediata”

7
Todo o processo de instalação será executado em sua versão padrão (recomendável),
instalando todos os componentes necessários a sua utilização. Este instalador simplifica
enormemente o processo de instalação de alguns componentes que antes deviam ser
instalados através de outros instaladores. Nesta versão, todos os pacotes de
componentes foram integrados em um único instalador. Ao término do processo de
instalação, você receberá a mensagem de que a instalação do Apus Client foi concluído
com sucesso e você terá um botão “Obrigado!” para finalizar o processo de instalação.

8
7. Instalação/Configuração Proxy:

Em versões anteriores, fazia-se necessária a instalação de produtos adicionais para o

suporte a serviço de “proxy”, o que atualmente é integrado ao próprio Apus Client, assim,
para os casos onde a Infra-estrutura da rede não permita liberar a PORTA 443 (HTTPS)
para a conexão, e será necessário a utilização de um serviço de “proxy” para fazer a
interface entre o Apus Client e os servidores da Accesstage, realize as configurações no
próprio aplicativo, em sua tela de configuração:

Caso seja habilitada a opção de “Autenticação NTLM”, serão solicitados campos

adicionais que podem se fazer necessários a esta configuração:

9
8. Configuração Accesstage:

A configuração de informações a serem trafegadas pelo Apus Client é feita através de

arquivos específicos que são administrados de forma centralizada na Accesstage,
através de seu serviço de Help Desk. Isto é feito de forma a otimizar o processo de
configuração e administração de usuários, garantindo a segurança e confiabilidade dos
dados trafegados.

Esta configuração é enviada quando da validação do cliente nos servidores da

Accesstage e uma sessão de trabalho é estabelecida.

Existe a possibilidade desta configuração contar com uma persistência, não sendo
enviada a toda conexão, mas sim, em tempos pré-determinados, devendo isto ser
verificado com a equipe de atendimento da Accesstage.

9. Integração com processos externos:

O Apus Client permite que sejam configurados processos externos a serem executados
para o tratamento dos documentos que estão sendo recebidos, bem para os documentos
que estão sendo preparados para envio.

No processo de upload de documentos temos um pré-processamento (realizado antes

do transporte/upload do documento para a Accesstage). Após o envio do documento no
processo de upload, temos mais um pós-processamento possível.

No processo de download de documentos temos apenas um pós-processamento

(realizados após o transporte/download do documento da Accesstage).

Esta facilidade de integração a processos externos visa facilitar a integração do Apus

Client ao sistema interno do cliente e ainda garantir uma expansibilidade de suas
funções com um mínimo de impacto através da adição de processos externos.

10. Utilização do Apus Client:

Após a instalação, o Apus Client está disponível para utilização em:

Iniciar > Programas > Accesstage > Apus Client

Uma vez iniciado, o Apus Client apresentará a tela de login no aplicativo. O usuário e a
senha padrão para o Apus Client é apus e apus.

10
A tela principal de trabalho do Apus Client está reproduzida abaixo:

Sua operação básica, depois que todas as configurações forem feitas, é basicamente o
processo de Sincronismo – que pode ser feito a qualquer momento, clicando sobre o
botão “Sincronizar Agora” ou de acordo com a configuração de “Agendamento”.

11. Acesso as configurações do Apus Client:

Mesmo após ter efetuado a configuração básica do Apus Client, você ainda tem acesso
a uma série de configurações que podem ser alteradas (e que em alguns casos devem
ser alteradas) de forma a adequar a utilização do Apus Client. Nas páginas seguintes
temos uma descrição básica de cada uma das opções destas configurações.

A forma de acessar estas configurações é através de: Sincronismo > Configuração.

11
Assim teremos acesso as opções de configuração como segue:

11.1. Conexão

Nesta tela configura-se a conexão através de “proxy”, conforme já exposto no item 7.

11.2. Usuário

Nesta tela poderá se configurar os usuários e senhas de login do aplicativo e do cliente

junto ao sistema da Accesstage (Remoto). Se a configuração tiver sido feita
corretamente, estes dados já devem estar setados de forma correta.
O usuário e senha Local podem ser alterados a qualquer momento, de acordo com as
necessidades do cliente.

O usuário e senha Remoto podem ser alterados, na tela principal existe a opção de troca
de senha remota, entretanto são os dados necessários para o Apus Client se logar na
infra-estrutura da Accesstage, e a inconsistência entre as informações podem impedir a
conexão.

12
 11.3. Log Apus Client:

Estas configurações definem como será gerado o arquivo de log do Apus Client, ou seja,
se de forma detalhada ( DEBUG ) e quantos dias de log serão armazenados.

O arquivo de log é de extrema importância para o departamento de atendimento da

Accesstage quando da necessidade de auxiliar o cliente na solução de problemas de
conectividade, e pode ser o ponto de ligação com o sistema de monitoração e/ou de
gestão de ambiente do cliente.

Produtos como HP OpenView, Tivoli, Nagios, entre outros podem ser configurados a ler
o arquivo de log do Apus Client e dar suporte a equipe de gestão de ambiente do cliente.

12. Agendamento do Apus Client:

O agendamento do Apus Client deve seguir o suporte do sistema operacional, assim,

utiliza-se o “Agendador de Tarefas” no caso do ambiente Windows, e o serviço “cron” no
caso de ambiente Unix-like.

Na instalação para ambiente Windows, existe um arquivo do tipo “bat”, que pode ser
utilizado em qualquer versão, desde que se utilize os caminhos padrão de instalação,
com o nome “startApus.bat”:

13
Para ambiente “Unix-like”, teremos o arquivo “startApus.sh”, com a mesma
funcionalidade.

13. Configuração em modo texto:

Quando se utiliza ambiente sem suporte gráfico, como o acesso remoto a um servidor
Unix-like, como Linux, Aix, HP-UX, a configuração poderá ser realizada pela equipe de
atendimento da Accesstage e enviada para o cliente, ou realizada em outro ambiente e
o arquivo transportando para o servidor.

O arquivo que possue as configurações necessárias possue a nomenclatura

“apusclient.cfg”, e tem suas informações gravadas de forma encriptada, garantindo seu
sigilo.

14. Instalação Unix:

O Apus Client é multiplaforma, baseado em Java, assim, pode ser utilizado em ambiente
Unix-like, como Linux, Aix, entre outros, e temos um pacote específico para instalação
nestes ambientes, que é um arquivo compactado, com formato “zip”, que deve ser
descompactado no diretório de trabalho do usuário com o qual será executado, com o
comando “unzip ApusJavaUnix.zip”.

14
Pode ser necessária a alteração do arquivo “startApus.sh” para que reflita a instalação
do servidor onde irá ser executado o Apus Client, tendo como ponto principal a variável
de ambiente “JAVA_HOME”, que definirá o local onde a instalação do Java estará, caso
não possa ser determinada automaticamente.

O parâmetro “-sync” pode ser passado ao script, fazendo com que este ignore a
presença de qualquer suporte a ambiente gráfico (Xwindows, Gnome, KDE, etc.), e seja
executado em modo texto.

Todos os direitos deste manual e/ou informações pertencem à Accesstage Tecnologia Ltda. Reprodução deste ou parte deste sob
autorização expressa. Manual exclusivamente informativo.