Instalar

O processo de instalação e configuração do Network Connector é dividido em duas etapas:

1. Configuração do Network Connector Server
2. Instalação e configuração do Network Connector Agent

O Server precisa ser configurado apenas uma vez. Já o Agent deve ser instalado e configurado em todas as redes em que o senhasegura não possui acesso.

[VÍDEO] Instalação e configuração do Network Connector

Configurar Network Connector Server

A configuração do Network Connector Server é realizada nas instâncias do senhasegura através do comando orbit network-connector. Você pode digitar orbit network-connector --help para conhecer todas as opções disponíveis para este comando.

Ativar Network Connector Server

Requisitos

• Acesso com sudo no servidor senhasegura
• Liberação da porta TCP 51445 para permitir que os Agents possam se comunicar com o senhasegura

Para configurar o Network Connector Server, siga os passos abaixo:

1. Acesse cada instância senhasegura do cluster via terminal.
2. Digite o comando sudo orbit network-connector setup. Você receberá uma mensagem de confirmação.
3. Digite Y para prosseguir com a configuração e aguarde a mensagem de sucesso: senhasegura Network Connector Server is ready!.

IMPORTANTE

Para instalações em cluster, é necessário realizar a configuração do Network Connector Server em todos os nós. Para isso, basta repetir os passos acima em cada nó do cluster.

Possíveis mensagens de retorno

Confira a lista de possíveis mensanges que você poderá ver ao configurar o Network Connector Server.

Tipo	Mensagem
Sucesso	senhasegura Network Connector Server is ready! Use this fingerprint in senhasegura Network Connector Agents setup: "FINGERPRINT" In case you need it, instructions for starting senhasegura Network Connector Agents are available in our help center. See at https://d.senhasegura.io/skme2rugfyizbw9 NOTE: If this environment is in cluster mode, run "sudo orbit network-connector setup" on secondary nodes as well
Erro	Can't continue setup This node is a Secondary in cluster and senhasegura Network Connector Server needs to be initialized in Primary node Please run "sudo orbit network-connector setup" in Primary node first
Erro	Whoops, an error was found in application setup! Check if application database is running and file replication between nodes is working without errors
Erro	Whoops, an error was found! Unable to determine which fingerprint senhasegura Network Connector Agents needs to connect in this server, try again later
Erro	Whoops, Could not replicate settings to cluster nodes Check if all cluster nodes are available, file replication is working and try again

Cadastrar Network Connector Agents no senhasegura

Após ativar o Network Connector Server, acesse a interface web do senhasegura e siga os passos abaixo:

1. Acesse o menu Dispositivos ➔ Configurações ➔ Network Connector ➔ Connectors. Você encontrará um conector cadastrado.
2. Na coluna Ação, clique no ícone Alterar.
3. Clique na aba Agentes.
4. Adicione todos os agentes que pretende instalar, preenchendo os campos Nome e Porta. A porta precisa estar entre 30000 e 30999.
5. Por fim, clique no botão Salvar.

Obter Network Connector fingerprint

Para instalar os agentes, é necessário possuir o fingerprint gerado durante o processo de configuração do Network Connector Server. Para copiar o fingerprint, siga os passos abaixo:

1. Acesse o menu Dispositivos ➔ Configurações ➔ Network Connector ➔ Connectors.
2. Na coluna Ação, clique na opção Detalhes.
3. Ao abrir a janela, clique no ícone fingerprint.
4. Por fim, basta copiar o valor apresentado.

Instalar Network Connector Agent

Requisitos

• Conhecimento básico sobre Docker.
• Conhecimento básico sobre Docker compose.
• O Compose instalado deve ser o Compose standalone
• Servidor Linux (qualquer distribuição) com Docker instalado.

Instalar Agent

IMPORTANTE

O Network Connector Agent não deve ser instalado nas instâncias do senhasegura.

1. Provisione uma máquina Linux com Docker instalado na rede onde o senhasegura não possui acesso.
2. Crie um arquivo (vim docker-compose.yml) com as configurações do Agent conforme exemplo abaixo:

---
version: "3"

# Parameters of senhasegura Network Connector agent
x-network-connector-agent-variables: &network-connector-agent-variables
  SENHASEGURA_FINGERPRINT: "CHANGEME" # Fingerprint of Network Connector Server
  SENHASEGURA_AGENT_PORT: CHANGEME

# Common settings for any senhasegura Network Connector agent
x-common-settings: &common-settings
  image: "registry.senhasegura.io/network-connector/agent:latest"
  restart: unless-stopped
  networks:
    - senhasegura-network-connector

services:
  # Settings to connect in senhasegura primary instance
  senhasegura-network-connector-agent-primary:
    <<: *common-settings
    environment:
      <<: *network-connector-agent-variables
      SENHASEGURA_ADDRESS: CHANGEME
      SENHASEGURA_PORT: 51445

  # Settings to connect in senhasegura second instance
  senhasegura-network-connector-agent-secondary-001:
    <<: *common-settings
    environment:
      <<: *network-connector-agent-variables
      SENHASEGURA_ADDRESS: CHANGEME
      SENHASEGURA_PORT: 51445

  # Settings to connect in senhasegura third instance
  senhasegura-network-connector-agent-secondary-002:
    <<: *common-settings
    environment:
      <<: *network-connector-agent-variables
      SENHASEGURA_ADDRESS: CHANGEME
      SENHASEGURA_PORT: 51445

networks:
  senhasegura-network-connector:
    driver: bridge

Os seguintes campos devem ser alterados:

• SENHASEGURA_FINGERPRINT: Consulte a sessão Obter Network Connector fingerprint.
• SENHASEGURA_AGENT_PORT: Defina uma porta entre 30000 e 30999 para este Agent. Escolha uma que não esteja em uso.
• SENHASEGURA_ADDRESS: Endereço IP das instâncias.

Instação Standalone

Remova o seguinte trecho do arquivo caso sua instalação do senhasegura possua apenas uma instância:

# Settings to connect in senhasegura second instance
senhasegura-network-connector-agent-secondary-001:
  <<: *common-settings
  environment:
    <<: *network-connector-agent-variables
    SENHASEGURA_ADDRESS: CHANGEME
    SENHASEGURA_PORT: 51445

# Settings to connect in senhasegura third instance
senhasegura-network-connector-agent-secondary-002:
  <<: *common-settings
  environment:
    <<: *network-connector-agent-variables
    SENHASEGURA_ADDRESS: CHANGEME
    SENHASEGURA_PORT: 51445

Instalação em Cluster

Adicione o seguinte trecho, para cada instância, caso o senhasegura esteja instalado em cluster:

# Settings to connect in senhasegura second instance
senhasegura-network-connector-agent-secondary-001:
  <<: *common-settings
  environment:
    <<: *network-connector-agent-variables
    SENHASEGURA_ADDRESS: CHANGEME
    SENHASEGURA_PORT: 51445

IMPORTANTE

Altere o número da instância na linha senhasegura-network-connector-agent-secondary-001 de acordo com a quantidade de instâncias em seu cluster.

3. Por fim, execute o comando sudo docker-compose up -d para iniciar o container do Agent.

DICA

Você pode acompanhar os logs de execução do Agent utilizando o comando sudo docker-compose logs -f.