Segurança
O appliance roda em um hardware e em uma rede que você opera. A IronFlock fornece o software e seus padrões; o quão bem o appliance está protegido também depende do modo que você escolhe, da rede ao redor dele e do host em que ele roda. Esta página é o checklist para essa parte.
O que cada modo protege
O appliance opera em um de três modos, descritos em HTTPS e certificados. Eles diferem no que é criptografado e verificado:
| HTTP simples (padrão) | HTTPS com uma CA autoassinada | HTTPS com o seu certificado corporativo | |
|---|---|---|---|
| Navegador para o appliance | Sem criptografia | HTTPS | HTTPS |
| Cookies de login | Não marcados como seguros | Seguros | Seguros |
Conexão do dispositivo (porta 18080) | Sem criptografia | Sem criptografia | HTTPS na 443 |
| Imagens de apps e atualizações do agente para os dispositivos | Sem criptografia | Sem criptografia | HTTPS na 443 |
| Túnel de acesso remoto dos dispositivos | Criptografado, servidor não verificado | Criptografado, servidor não verificado | Criptografado e verificado |
| Passkeys e chaves de segurança | Somente a partir do próprio appliance | Sim | Sim |
Use HTTPS com o seu certificado corporativo sempre que o appliance compartilhar uma rede com outros sistemas. É o único modo em que os dispositivos conectados verificam com quem estão falando. Os outros dois modos são adequados a um segmento de rede que apenas o appliance, seus dispositivos e seus operadores conseguem alcançar.
O que permanece sem criptografia
Mesmo com HTTPS, parte do tráfego não é criptografada. Planeje a sua rede levando isso em conta:
- A conexão do dispositivo na porta
18080é publicada em todas as interfaces de rede, em todos os modos. O próprio agente de dispositivo do appliance e os apps que rodam no appliance se conectam a ela e, no modo simples e com uma CA autoassinada, também todos os dispositivos conectados. - Os túneis de acesso remoto para o appliance (porta
7000) são criptografados no modo simples e com uma CA autoassinada, mas os dispositivos não conseguem verificar o certificado do appliance. Alguém com acesso ao caminho de rede poderia se passar pelo servidor de túneis do appliance. Os agentes de dispositivo registram um aviso quando se conectam dessa forma. - As conexões entre os serviços dentro do appliance, como as conexões com os seus bancos de dados, não são criptografadas. Elas não saem do host.
- Os dados em repouso não são criptografados pelo appliance. Use a criptografia do sistema operacional ou do disco do host se o appliance armazenar dados sensíveis ou puder sair das suas instalações.
Checklist de hardening
- Escolha o modo adequado à sua rede (veja O que cada modo protege).
- Restrinja quem pode alcançar as portas do appliance. A instalação não abre nada no seu firewall, e o Docker publica as portas do appliance contornando as regras de entrada habituais do firewall do host (
ufw,firewalld). Filtre na chainDOCKER-USERou no firewall da sua rede: a instalação deixa um modelo em/opt/ironflock/docker-user-firewall.sh.example. Libere as portas dos dispositivos (18080,15001,15002,7000,30000–30049) somente a partir das redes dos seus dispositivos — veja Dispositivos conectando-se ao appliance. - Mantenha o sistema operacional do host atualizado e limite quem tem uma conta nele. Qualquer pessoa com acesso root ao host pode ler todos os segredos do appliance.
- Use chaves SSH em vez de senhas para o acesso administrativo ao host.
- Configure a sincronização de horário — veja Sincronização de horário (NTP).
- Altere a senha de administrador após o primeiro login e configure um segundo fator para a conta de administrador.
- Exija um segundo fator de todos assim que todas as contas tiverem um (veja Contas e acesso).
- Proteja com um segundo fator a conta do ironflock.com que é dona da instância: ela tem acesso de administrador ao appliance a partir da nuvem.
- Desligue a conexão à cloud se ninguém precisar trabalhar no appliance a partir do ironflock.com (veja Conexão à cloud).
- Instale apenas apps em que você confia. Os apps rodam no appliance e nos seus dispositivos com amplo acesso ao host, incluindo os arquivos de configuração do appliance.
- Mantenha o appliance atualizado (veja Atualizações).
- Verifique o
ironflockantes da primeira instalação (veja Verificar oironflockantes da primeira instalação).
Contas e acesso
- Conta de administrador: cada appliance recebe a sua própria senha de administrador na instalação; o
ironflock appliance installa exibe uma única vez. Se ela for perdida, defina uma nova conforme descrito em Operação local — isso também encerra todas as sessões de administrador. - Novos usuários só podem se cadastrar com um convite de um projeto no appliance. Sem convite, o cadastro é recusado, também via login social.
- Segundo fator: os usuários podem configurar um app autenticador (TOTP), passkeys ou chaves de segurança, e códigos de recuperação. Passkeys e chaves de segurança exigem HTTPS. A opção
--2fadoironflock appliance installou doironflock appliance configuredefine a política, e ela se mantém entre atualizações:available— os usuários podem configurar um segundo fator, mas ele nunca é solicitado.effective(padrão) — os usuários que têm um segundo fator precisam usá-lo.required— todos os usuários precisam usar um segundo fator. Antes, certifique-se de que todas as contas tenham um: um usuário sem segundo fator não consegue mais fazer login.
- As sessões duram 24 horas.
- Acesso a partir do ironflock.com: a conta do ironflock.com que criou a Instance Key está vinculada à conta de administrador do appliance. Os usuários que você convida vinculam as suas próprias contas do ironflock.com — veja Vinculando contas. Um usuário pode remover esse vínculo a qualquer momento. Para interromper todo o acesso a partir do ironflock.com, o administrador desliga a conexão à cloud.
Segredos no host
O ironflock appliance install gera os segredos do appliance uma única vez, na instalação, e os mantém entre atualizações. Eles ficam em /opt/ironflock/:
| Arquivo | Conteúdo | Acesso |
|---|---|---|
.env | Senhas e chaves de todos os serviços, a senha inicial de administrador, credenciais de proxy e de SMTP | Somente root (0600) |
license.env | A Instance Key, e o que a validação da licença guarda junto com ela | Root e os serviços do IronFlock (0640) |
certs/ | O certificado HTTPS e sua chave; com uma CA autoassinada, também a chave da CA | Chaves privadas somente root (0600) |
registry-token-certs/ | A chave que assina os tokens de download de imagens de apps | Somente o serviço de registro (0600) |
.env.prev, rotation.log | O .env anterior à última rotação; qual segredo foi rotacionado e quando, sem os valores | Somente root (0600) |
A instalação também faz o login do Docker no registro da IronFlock com a sua Instance Key, então a configuração do Docker do root também a contém.
Inclua esses arquivos nos seus backups e proteja os backups como o próprio appliance. Nunca exclua o .env nem deixe uma instalação gerá-lo novamente: os bancos de dados e os dados criptografados dependem dos seus valores. Para substituir um segredo, faça a rotação dele.
O que você mesmo pode substituir:
- Senha de administrador: no perfil, ou com
sudo ironflock appliance reset-admin-password(veja Operação local). - Certificado HTTPS: o seu próprio certificado com
sudo ironflock appliance configure --tls-cert <file> --tls-key <file>(veja HTTPS e certificados). Um certificado da CA própria do appliance se renova sozinho: uma verificação semanal assina um novo quando faltam menos de 30 dias. - Instance Key: na seção de licença do perfil de administrador, ou com
sudo ironflock appliance configure --license-file <file>, em que o arquivo contém a nova chave. A nova chave precisa abrir o registro da IronFlock antes de ser gravada. - Credenciais de SMTP: em
.enve, em seguida, reinicie comsudo ironflock appliance restart. - Proxy: com
sudo ironflock appliance configure(veja Atrás de um Proxy Corporativo). - Segredos internos dos serviços:
sudo ironflock appliance rotate <NAME>, veja abaixo.
Rotação de um segredo interno
sudo ironflock appliance rotate <NAME> dá um novo valor a um segredo do .env enquanto o appliance roda. O novo valor vai primeiro para onde o antigo está guardado (uma role do banco de dados, o arquivo de dispositivo do agente, o par de chaves de token do registro) e depois para o .env. Apenas os serviços que leem o segredo são recriados, e o comando verifica se eles estão saudáveis. O .env anterior à alteração fica guardado como .env.prev, e o rotation.log lista cada rotação, nunca um valor. ironflock appliance rotate --help lista os nomes que ele consegue rotacionar. Veja ironflock appliance rotate.
Execute as rotações via SSH ou no console do appliance, não no terminal do próprio dispositivo do appliance no IronFlock: uma rotação que reinicia os serviços dos quais esse terminal depende o interrompe.
| Segredos | O que uma rotação faz |
|---|---|
WAMP_SECRET_SVC_*, WAMP_SYSTEM_SECRET e os outros segredos de serviço | Os serviços que o usam reiniciam; as suas conexões voltam em segundos. |
KRATOS_SECRETS_COOKIE | Novos logins usam a nova chave; as sessões iniciadas antes continuam válidas, porque a chave anterior é mantida até a próxima rotação. |
POSTGRES_PASSWORD, PGPASSWORD_*, DATASERVICE_PASSWORD | A role do banco de dados recebe a nova senha e, em seguida, os seus serviços reiniciam. Pergunta antes; --yes responde. |
REGISTRY_TOKEN_KEY | Os tokens de download de imagens de apps são assinados com uma nova chave; os tokens assinados antes continuam válidos até a próxima rotação. Pergunta antes; --yes responde. |
APPLIANCE_DEVICE_SECRET | O próprio dispositivo do appliance recebe uma nova credencial; o seu agente reinicia e volta a ficar online em até um minuto. Pergunta antes; --yes responde. |
FILE_CRED_KEY | Os apps mantêm seus arquivos; o acesso deles ao armazenamento passa para a nova chave. Para as credenciais S3 diretas dos apps, escolha --keep-direct-access ou --revoke-direct-access. As credenciais mantidas continuam funcionando, para uma rotação planejada: quem conhece a chave anterior ainda pode derivá-las, por isso as configurações de armazenamento de cada app as marcam para substituição, e sudo ironflock appliance revoke-direct-access remove depois as que restarem. As credenciais revogadas deixam de funcionar e são removidas na hora, por exemplo após suspeita de vazamento. Pergunta antes (--yes responde) e exige a versão 1.6.23 ou posterior do appliance. |
APPLIANCE_ADMIN_PASSWORD | Uma nova senha inicial de administrador, o mesmo que ironflock appliance reset-admin-password. |
Faça a rotação de FLEETDB_SECRET_KEYS, KRATOS_SECRETS_CIPHER e das duas chaves OBJECTSTORE_ADMIN_* somente junto com a equipe da IronFlock: os dados armazenados com elas dependem delas. A Instance Key é alterada no perfil de administrador ou com ironflock appliance configure, não com rotate.
Conexões de saída e telemetria
Os destinos aos quais o appliance se conecta estão listados em Configuração de firewall; todas essas conexões são criptografadas.
- A validação da licença envia a chave de licença, uma impressão digital do hardware e os tokens de acesso das conexões do appliance com a App Store online.
- O assistente de IA envia os prompts pelo gateway de LLM da IronFlock, a menos que você configure um gateway próprio.
- Sem telemetria. O appliance não envia análises de uso: nem a UI do appliance nem os seus serviços relatam o uso à IronFlock ou a terceiros.
- A partir do navegador do usuário: os blocos de mapa são carregados do Mapbox, e a entrada por voz usa o serviço de reconhecimento de fala Deepgram. Essas conexões são feitas pelo navegador, não pelo appliance.
Atualizações
- As atualizações do appliance são iniciadas pelo administrador (veja Manutenção) e assinadas pela IronFlock. O
ironflockverifica a lista de versões disponíveis e o manifesto de release da nova versão com a chave de release do appliance que ele traz, e em seguida cada arquivo da nova versão e cada imagem de contêiner com esse manifesto. Um arquivo alterado ou não assinado, ou qualquer imagem diferente da publicada, interrompe a atualização antes que algo mude no appliance. Uma atualização nunca leva o appliance de volta a uma versão anterior por conta própria e, se uma atualização falhar, o appliance volta à versão que rodava antes. - As atualizações do agente de dispositivo são assinadas. Cada agente verifica a assinatura antes de aplicar uma atualização e reverte se a nova versão não iniciar — veja Atualizações do agente de dispositivo.
- O sistema operacional do host é sua responsabilidade, incluindo o Docker.
Verificar o ironflock antes da primeira instalação
O appliance verifica cada atualização por conta própria: o ironflock verifica cada versão do appliance com a chave de release do appliance da IronFlock que ele traz, antes de instalá-la. O que você aceita por confiança é o script de instalação do ironflock, que roda como root. Verifique-o antes que ele rode, conforme descrito em Verificar o script de instalação antes: o gpg deve informar uma assinatura válida da chave IronFlock Bootstrap com a impressão digital F6C9 4D96 CE31 5377 ACA7 C8EA 4990 5433 7321 2788. O script, por sua vez, verifica o ironflock com essa chave antes de instalá-lo. As duas chaves estão listadas em Chaves de Assinatura.
Backup e restauração
Para fazer o backup do appliance inteiro, pare-o com sudo ironflock appliance stop e copie:
- a pasta
/opt/ironflock/, incluindo.env,license.env,certs/eregistry-token-certs/; - os volumes Docker do appliance (
docker volume ls), que contêm os bancos de dados, os arquivos, a App Store local e os arquivos dos usuários.
Depois, inicie-o de novo com sudo ironflock appliance start. Mantenha o .env junto com os volumes do mesmo momento: os dados criptografados nos volumes só podem ser lidos com as chaves desse .env.
Os segredos sozinhos podem ser salvos enquanto o appliance roda:
sudo ironflock appliance backup -o /root/appliance-secrets.tar.gzO arquivo compactado contém .env, license.env, a CA, as chaves de token do registro, o registro de segredos e rotation.log; somente o root pode ler o arquivo. Uma FLEETDB_SECRET_KEYS ou FILE_CRED_KEY perdida não pode ser recuperada de nenhuma outra forma: criptografe o arquivo compactado e guarde-o junto com os backups dos volumes.
Para colocar os segredos de volta em um appliance instalado, restaure com --force enquanto ele roda e, em seguida, reinicie-o para que todos os serviços leiam os arquivos restaurados:
sudo ironflock appliance restore appliance-secrets.tar.gz --force
sudo ironflock appliance restartO .env do appliance anterior à restauração fica guardado como .env.prev. Em uma máquina nova, instale o ironflock, execute sudo ironflock appliance restore appliance-secrets.tar.gz e depois instale o appliance normalmente, com a Instance Key e as opções usadas antes, por exemplo --tls. Veja ironflock appliance backup e ironflock appliance restore.
Desativação
-
Transfira ou libere a licença enquanto o appliance ainda estiver online — veja Mover sua licença para um novo hardware.
-
Remova o software:
sudo ironflock appliance remove --purge sudo ironflock agent removeO
ironflock appliance remove --purgeremove os serviços, os contêineres e a rede do appliance, o login do Docker no registro da IronFlock, as alterações que a instalação fez no host e, com--purge, também os seus dados: o diretório de instalação/opt/ironflockcom.envelicense.env, os volumes Docker e as imagens. Em seguida, oironflock agent removeremove o agente de dispositivo do próprio appliance. Cada comando lista o que remove e pergunta antes;--yesresponde. O Docker em si continua instalado, assim como oironflockem/usr/local/bin. Vejaironflock appliance removeeironflock agent remove. -
Se o hardware sair das suas instalações, apague o disco — os comandos acima excluem os arquivos, mas não os sobrescrevem.
Configurações que enfraquecem a segurança
Algumas configurações existem apenas para solução de problemas. Não as defina em produção:
AGENT_UPDATE_ALLOW_UNSIGNED— permite que um agente de dispositivo aplique atualizações não assinadas. Só funciona comountil=<time>, no máximo 24 horas à frente, e depois expira sozinho.TUNNEL_AUTHZ_ENFORCE=false— permite que os dispositivos abram túneis sem comprovar a sua identidade.?tls.rejectUnauthorized=falseemSMTP_CONNECTION_URI— aceita qualquer certificado do seu servidor de e-mail.--2fa available— segundos fatores nunca são solicitados.