Instalação em um único servidor

Não recomendamos este tipo de configuração para ambientes produtivos.

Procedimento de Instalação

Neste procedimento ilustraremos o processo de configuração do Virtual Appliance em dois servidores de Authfy Risk

Importação do Virtual Appliance

Este procedimento será necessário em todas as novas instalações e se aplica para o cenário com dois servidores (Master e Réplica) delineado neste documento.

Após ter efetuado a importação do Virtual Appliance e iniciado o mesmo, efetue os procedimentos a seguir:

Primeiro Acesso

Durante o primeiro acesso o usuário será vapp e a senha vapp , no entanto, a senha será expirada, sendo obrigatória a troca da mesma no primeiro acesso.

1. Acesse a console do Virtual Appliance com o usuário vapp e a senha vapp e troque a senha no primeiro login

Configuração de Rede do Virtual Appliance

Para configurar a interface de rede efetue:

1. Na console, edite o arquivo: /etc/network/interfaces

    vi /etc/network/interfaces
   

   • Para configurar como DHCP utilize como referência a configuração abaixo para a interface eth0 :

      auto lo
     
        iface lo inet loopback
     
      auto eth0
     
        iface eth0 inet dhcp
     

   • Para configurar como estático , utilize como referência a configuração abaixo para a interface eth0:

      auto lo
     
        iface lo inet loopback
     
      auto eth0
     
        iface eth0 inet static
        address 192.168.0.151
        netmask 255.255.255.0
        gateway 192.168.0.1
     
      # DNS: A seguir um exemplo, utilizando os servidores de DNS do Google de como deverá ficar a configuração:
        dns-nameservers 8.8.8.8 4.4.4.2
        dns-search acme.com
     

2. Reiniciar o Virtual Appliance, utilizando o comando vapp reboot

Utilitário de Configuração do Virtual Appliance

Parar configurar e administrar o Virtual Appliance basta utilizar o utilitário de sistema vapp.

Parar entender todas as possibilidades de uso do utilitário use o seguinte comando: vapp help

Setup do Virtual Appliance

No console do servidor ou através de acesso remoto utilizando SSH, efetue os procedimentos enumerados a seguir:

1. Utilize o comando:

    vapp setup
   

2. Selecione a opção 1) vApp Admin Password e configure a senha de administrador para os serviços do Authfy Risk

3. Cadastre a Master Key utilizando a opção 2) Master Key, essa chave deverá possuir 16 caracteres.

   Observação: Master Key
   Todos os processos que envolvem dados sensíveis no Virtual Appliance são protegidos através de criptografia, para este processo utiliza-se a Master Key.

   
   

   Pontos Importantes:
   a. A Master Key deve ser armazenada de maneira segura, como num Cofre de Senhas Digital
   b. Para configurar outros Nós Réplicas do Authfy Risk é necessário colocar a respectiva Master Key
   c. Processo de restauração de ambiente não funcionará sem a Master Key

   
   

   A Master Key é uma das informações mais importantes, requer atenção e a devida salva-guarda, recomendamos colocar em um cofre de senhas digital ou fisíco. Uma vez perdida a Master Key não é possível recuperá-la.

4. Selecione a opção 3) Database e em seguida selecione a opção 2) Internal MySQL Database

5. Em Database Password : coloque a senha para acesso ao banco

6. Selecionar 5) Exit

Inicializando o Virtual Appliance

Para Realizar a inicialização do serviço do Authfy Risk, efetue os procedimentos enumerados a seguir:

1. Para inicializar o serviço do Authfy Risk, utilize o comando a seguir:

    vapp start
   

2. Para verificar se todos os processos inicializaram corretamente, utilize o comando a seguir:

    vapp status
   

3. Para efetuar os testes acesse via Browser: https://[IP ou Hostname (FQDN)]/apidocs ou https://[IP ou Hostname (FQDN)]

   Neste momento toda a configuração foi finalizada.

   Caso apresente algum erro, avalie os logs dos serviços com os seguintes passos.

4. Visualizando os logs de inicialização

     vapp logs
   

5. Visualizando o conteúdo do arquivo de logs

     tail -f /var/log/vapp/app.log