Instalando OMNILINK - Passo a passo

O OMNILINK é um software que deve ser instalado por sua operadora. Para que sua instalação seja realizada, é necessário que sua empresa siga alguns passos, e atenda alguns pre-requisitos.

Abaixo vamos identificar todos os itens que são necessários, bem como um passo-a-passo para instalação dessa ferramenta.

Passo 1: verificando disponibilidade de hardware e configurações de segurança / redes:

O OMNILINK é instalado dentro de sua estrutura de servidores. Sua instalação exige um servidor (virtual ou física) com determinados requisitos de hardware e software.

Os requisitos em resumo são:

• Hardware (servidor) compatível, com especificações mínimas em conformidade com o requisitado pela Mobile Saúde;

• Sistema operacional suportado pela aplicação, em conformidade com o especificado pela Mobile Saúde;

• Docker instalado no servidor compatível;

• Certifique-se que possui acesso remoto a este computador, e que seu usuário seja capaz de executar comandos de terminal, copiar e colar comandos no terminal deste servidor;

• Liberação de portas para acesso externo (internet), também conforme especificação;

• Endereço IP externo que foi liberado no seu firewall;

• Servidor deve ter acesso a mesma rede do banco dxe dados da sua aplicação/

Para acessar a lista completa de requisitos, siga esse link: Requisitos de infra estrutura, rede e banco de dados

Revise se todos os itens aqui relacionados estão disponíveis. Caso não estejam, providencie a correção / ajuste antes de iniciar o procedimento de instalação.

Passo 2: obtendo com seu DBA os acessos do usuário do OMNILINK ao seu Banco de Dados:

Para se conectar ao seu banco de dados, o OMNILINK precisará de um usuário/senha de banco, e das configurações de conexão ao banco de dados. Crie um documento com as seguintes informações e deixe-as a mão ANTES de executar a instalação do OMNILINK:

• Fabricante do SGDB: (MySQL, Oracle, MSSQL, POSTGRES)

• Host

• Porta

• Database

• Schema

• User

• Pass

Passo 3: acessando o painel público do Mosia Omnichannel e gerando SCRIPT de instalação:

• Abra seu navegador e acesse o seguinte link para acessar o painel público: https://painel.mosiaomnichannel.com.br/

  • Informe a chave do cliente, login e senha. Caso não tenha, entre em contato com o adminstrador da conta (cliente) para receber uma chave de acesso.

• Uma vez autenticado, acesse a opção FERRAMENTARIA => OMNILINK. Escolha a opção “Nova configuração”. Na tela seguinte, informe os dados conforme orientações abaixo:

  • Nome: informe um nome para sua conexão. Indicamos usar HMG para conexões a bancos de homologação, ou PRD para instâncias de OMNILINK integradas a bancos de produção. Importante: uma vez que o conteiner esteja instalado, serão adicionados prefixos a esse nome, facilitando o entendimento.

  • Endereço: informe o IP e a porta EXTERNA onde o OMNILINK estará disponível. Você também pode usar um domínio ou subdomínio. Exemplo: 200.123.456.789:26801 para configurar uma instância de HMG de autenticação, ou minhaapideboletos.minhaoperadora.com.br:26806 para uma instância de produção boletos do OMNILINK.

  • Versão: escolha a versão mais atual disponível;

  • Módulo: selecione o módulo de OMNILINK que será instalado;

  • Chave de API (opcional): Na necessidade de criar uma camada a mais de segurança em sua aplicação, para saber mais clique aqui.

  • Modo debug: quando ativado, o OMNILINK gera logs no conteiner, para análise de eventuais problemas ou visualização das consultas em banco de dados executadas. Recomendamos que você ative somente em ambientes de HMG, por questões de performance e espaço. Se necessário ativar em PRD, lembre-se de desativa-lo (reinstalando o OMNILINK e configurando-o para DESATIVADO).

  • CONFIGURAÇÕES ADICIONAIS - são modificadas conforme módulo do OMNILINK. Siga as orientações em tela, conforme o módulo escolhido.

  • BANCO DE DADOS: Preencha as informações solicitadas em tela. Essas informações de banco de dados não são gravadas em nenhum lugar, são apenas utilizadas para geração do script automatizado de instalação e configuração do OMNILINK.

  • IMPORTANTE: Não pressione SALVAR ainda. Pressione INSTRUÇÕES DE INSTALAÇÃO.

    • Leia as instruções e role a tela até achar o botão “COPIAR”. Preencha-o.

  • Acesse o servidor via terminal SSH com um usuário com permissões de instalação, e execute o SCRIPT copiado anteriormente. O OMNILINK será executado automaticamente.

  • Após instalação do OMNILINK, volte ao painel e baixe a collection do POSTMAN para iniciar os testes de conexão a partir de seu computador.

    • Caso não tenha o postman instalado no seu computador, instale-o utilizando o link https://www.postman.com/downloads/

  • Salve a configuração da instância pressionando o botão SALVAR.

Passo 4: testando a conexão:

• Acesse o terminal linux do seu servidor e execute o comando:

A saída desse comando deve ser semelhante a essa:

• Abra o postman e importe a collection. Configure a variável de ambiente “host”;

  • Caso não tenha o postman, baixe-o em seu computador utilizando a URL:

• Procure pelo request Health-check, e execute-o. A saída deve ser semelhante a esta:

Passo 5: configurando as integrações:

1 - Acesse o configurador (como acessar o configurador? clique aqui)

2 - Configure as integrações utilizando a opção FUNCIONALIDADES => CONFIGURADOR DE FUNCIONALIDADES.

Pressione o botão EDITAR para editar as configurações de SANDBOX. Escolha as opções desejadas conforme a lista abaixo:

Open

Configurador de funcionalidades

• Autenticação: escolha a aba “Opções de login”, e localize as opções:

  • Login

  • Recuperar Senha

  • Trocar senha

  • Primeiro acesso

Ao pressionar o botão EDITAR, serão apresentados 4 passos (steps) definidos abaixo

• Step 1: Configuração de Autorização:

  • DEIXAR EM BRANCO, NÃO UTILIZAR PARA OMNILINK. Basta pressionar o botão “Próximo” para seguir a diante.

• Step 2: Validação:

  • URL do Webservice: utilize sempre o padrão URL do OMNILINK+porta + API disponibilizada. Segue lista de métodos do OMNILINK disponíveis atualmente:

    • Autenticação:

      • Login: {{host}}/authentication/login

      • Pre Load Data: {{host}}/form/preLoadData - necessário pressionar botão LOGIN para configurar essa integração - parte superior direita da tela

        • Importante: informe funcionalidade 16 (Atualização cadastral) no campo de funcionalidade

      • Recuperar Senha Identificação: {{host}}/authentication/recuperarSenhaIdentificacao

      • Recuperar Senha Nova Senha: {{host}}/authentication/recuperarSenhaNovaSenha

      • Trocar senha: {{host}}/authentication/trocarSenha - necessário pressionar botão LOGIN para configurar essa integração - parte superior direita da tela

      • Primeiro acesso: {{host}}/authentication/novoUsuario

      • Beneficiários: Acesso funcionalidade: {{host}}/authentication/grupoFamiliar

    • Extratos / Débitos / Declarações - necessário pressionar botão LOGIN para configurar essa integração - parte superior direita da tela

      • Extrato de utilização:

        • Extrato: {{host}}/extratoUtilizacao/extrato

      • Extrato de coparticipação:

        • Extrato: {{host}}/extratoCoparticipacao/extrato

      • Declarações:

        • Lista de declarações: {{host}}/declaracao/listarDeclaracoes

        • Detalhes de uma declaração: {{host}}/declaracao/declaracaoPdf

      • Débitos:

        • Lista de débitos: {{host}}/debitos/listaDebitos

        • Detalhe dos débitos: {{host}}/debitos/detalheDebito

        • Boleto em PDF: {{host}}/debitos/boletoPdf

        • Resumo da cobrança: {{host}}/debitos/resumoCobranca

        • Gerar boleto: {{host}}/debitos/gerarBoleto

  • Exemplo:

    • Você deseja configurar a opção de login. Seu IP externo é: 200.123.456.123 e a porta for 26801.

    • A URL de login deve ser preenchida com o seguinte conteúdo: http://200.123.456.123:26801/authentication/login

  • Pressione o botão “Adicionar Header” e insira 3 novos headers, com os seguintes conteúdos:

    • Header: ambiente / Valor: 1

    • Header: idOperadora / Valor: 1

    • Header: idConfigClienteApp / Valor: 1

  • Configure o timeout para 10

  • Informe os dados que o formulário requer no box da direita, logo acima do botão “Validar integração”.

  • Uma vez que os dados do formulário estiverem preenchidos, pressione o botão “VALIDAR INTEGRAÇÃO”. Nesse momento, a API do OMNILINK será consumida, e os resultados serão exibidos nos espaços “Retorno do Webservice” e “Retorno da Validação”.

• Step 3: Confirmação:

  • Analise os dados gerados e pressione PROXIMO.

• Step 4: Recibo:

  • Nessa etapa, é gerado um recibo que comprova a estrutura enviada, o retorno e os parâmetros de cabeçalho. Verifique o conteúdo e finalize o processo de configuração.

Passo 6: acessando o app SANDBOX:

• Baixe o app SANDBOX utilizando a URL

• Informe seu client key, usuário e senha. São as mesmas credenciais utilizadas para acessar o painel público.

• Na tela de login da sua operadora, informe um login válido (utilize o mesmo que foi utilizado para configurar o login, por exemplo).

• No momento do login, o usuário / senha informados serão repassados pelo app para o OMNILINK, que por sua vez fará as consultas nas suas views e devolverá o resultado para o app.

• Acesse demais funcionalidades do app que exijam integração realizada pelo OMNILINK (Boletos, extratos de utilização, extrato de coparticipação, declarações, ou mesmo crie um novo acesso, troque senha, etc). Fazendo isso vc estará testando todas as integrações disponíveis, e tendo certeza que todas as suas funções estão em perfeito funcionamento.