Instalar a appliance Edge (Docker ou systemd)

A appliance Edge é um agente que corre na sua rede e liga-se ao serviço só por ligações de saída HTTPS. Hoje serve o acesso privilegiado (sessões SSH gravadas). Corre como contentor Docker (Linux x86_64) ou como serviço systemd (Debian 12/13, Ubuntu 24.04).

Antes de começar

1. Na consola, crie a appliance e anote o URL Edge, a organização e o código de registo (ver Registar a appliance). O código vale 30 minutos, uma vez.
2. Crie o segredo do anfitrião: 32 bytes aleatórios que selam as chaves da appliance. Guarde-o fora da imagem e inclua-o nas cópias de segurança do volume; sem ele, a appliance tem de ser registada de novo.

sudo install -d -m 0700 /etc/authguard-edge
openssl rand -hex 32 | sudo tee /etc/authguard-edge/host.key >/dev/null
sudo chmod 0600 /etc/authguard-edge/host.key

Rede

Docker

Execute o contentor com o volume persistente, o segredo montado só de leitura, as variáveis AUTHGUARD_EDGE_URL, AUTHGUARD_EDGE_TENANT, AUTHGUARD_EDGE_ENROLMENT_CODE e AUTHGUARD_EDGE_PUBLIC_URL, as portas acima e o sistema de ficheiros só de leitura. O comando completo é o que a consola copia com «Copiar comando». Depois, docker logs authguard-edge mostra o código de confirmação.

systemd

Instale o binário authguard-edge, o utilizador de sistema, o ficheiro de ambiente e a unidade, e ative-a. O código de confirmação aparece em journalctl -u authguard-edge.

Atualizar

Obtenha a nova imagem e recrie o contentor com o mesmo volume e o mesmo segredo. Não é preciso um código novo.

Diagnóstico

docker exec authguard-edge authguard-edge diag mostra a versão, a custódia das chaves («Chaves em software (sem TPM)» em Docker) e o estado do agente.