Operação

Operação local

Se você não quiser manter o appliance conectado à internet, sempre pode usar um navegador na mesma rede local e acessar o endereço IP ou hostname do appliance:

http://<appliance-host>

Faça login como usuário admin:

• Usuário: admin
• Senha: a senha inicial de admin gerada para o seu appliance

O instalador exibe essa senha no final da instalação. Ela também fica armazenada como APPLIANCE_ADMIN_PASSWORD em /opt/ironflock/.env no host do appliance, um arquivo que somente o root pode ler:

sudo grep '^APPLIANCE_ADMIN_PASSWORD=' /opt/ironflock/.env

Altere a senha após o seu primeiro login.

Esqueceu a senha de admin? Execute isto no host do appliance para definir uma nova; o comando exibe a nova senha:

curl -fsSL https://instance-registry.ironflock.com/dl/appliance/install_ironflock.sh \
  | sudo bash -s -- --reset-admin-password

Appliances mais antigos: um appliance instalado antes de o instalador gerar a senha de admin começa com a senha ironflock. O primeiro login com ela pede que você defina uma nova senha.

UIs web dos apps

Quando um app em um dispositivo conectado expõe uma interface web, o appliance a torna acessível através do seu túnel embutido. De fábrica, isso não exige nada da TI corporativa — cada UI de app é publicada por HTTP simples em uma porta atribuída automaticamente do endereço do appliance (http://<appliance-host>:<port>), e a IronFlock UI mostra o link. O acesso continua protegido pelo login do appliance.

Para URLs https:// confiáveis em uma rede corporativa compartilhada — usando um certificado wildcard da sua CA ou um proxy reverso que termina o TLS — veja UIs de apps e HTTPS.

Vinculando contas

Crie contas de usuário locais para sua equipe convidando-os por e-mail nas configurações do seu projeto no appliance. O e-mail de convite contém tudo o que o convidado precisa:

• Um link de conexão pessoal — ao abri-lo em ironflock.com, a conta do ironflock.com do convidado é conectada ao appliance. Se ele ainda não tiver uma conta no ironflock.com, primeiro cria uma usando o endereço de e-mail convidado (a conexão só é concedida quando os dois endereços de e-mail coincidem). Uma vez conectado, o appliance aparece no seu seletor de projetos do ironflock.com e ele já pode trabalhar remotamente de imediato — sem chaves manuais, sem necessidade de cadastro local.
• Um link de cadastro local — opcional: concluir o cadastro local permite, adicionalmente, fazer login diretamente na interface do appliance (http://<appliance-host>).

Alguns pontos importantes:

• Usuários locais existentes não precisam de um novo convite do proprietário do projeto. Na interface do appliance, eles abrem seu Perfil e clicam em Enviar o link de conexão por e-mail na seção Conectar ao ironflock.com.
• Reenvio: convidar o mesmo endereço de e-mail novamente (ou clicar de novo no botão do perfil) emite um novo link de conexão. Apenas o link do e-mail mais recente é válido.
• Se o appliance não conseguir enviar e-mails — por exemplo, em uma rede corporativa restrita que bloqueia o relay de e-mail — o link de conexão é exibido diretamente na interface: quem convida o copia e o entrega por qualquer canal. O link deve ser aberto em um navegador com acesso à internet.
• Desconectando: um usuário pode remover a conexão a qualquer momento no ironflock.com em Perfil → Instâncias → Instâncias Conectadas. Reabrir o link de conexão mais recente a restaura.

O proprietário da instância — o usuário que criou a Instance Key em ironflock.com — é conectado automaticamente à conta local de admin da instância; nenhum convite é necessário para o proprietário.

Sincronizando apps da loja online

O Appliance inclui uma local App Store — um catálogo privado de apps e registro de containers que serve apps para dispositivos na rede local. Você pode popular essa loja local sincronizando apps da IronFlock Store pública online, desde que o Appliance tenha uma conexão à internet disponível no momento da sincronização. Nenhuma conexão permanente à internet é necessária; uma conexão temporária é suficiente para baixar os apps de que você precisa.

Pré-requisitos

• Uma conta na plataforma pública ironflock.com.
• Sua conta do appliance está conectada à sua conta do ironflock.com (veja Vinculando contas). A conta de admin do proprietário da instância é conectada automaticamente.

Como funciona a sincronização de apps

┌────────────────────┐                       ┌────────────────────┐
│  Online IronFlock  │  ◄──── account ─────► │  Appliance         │
│  Store (cloud)     │      connection       │  local Store       │
└────────────────────┘                       └────────────────────┘
         │                                            │
   apps available to                          sync button shown
   the connected account                      instead of install

1. Abra a local App Store — Quando o Appliance tiver uma conexão ativa à internet, a App Store mostrará todos os apps disponíveis para a sua conta conectada do ironflock.com na plataforma online.
2. Sincronize os apps de que você precisa — Em vez de um botão Install, cada app mostra um botão Sync. Clicando nele, o app é baixado — incluindo suas imagens de container e metadados — da loja online para a loja local.
3. Adicione dispositivos — Uma vez sincronizado, o app está totalmente disponível na sua loja local e você pode adicionar dispositivos a ele normalmente, sem necessidade de conexão à internet.

Fluxo de atualização

Quando uma nova versão de um app sincronizado for publicada na loja online, um botão Sync aparecerá novamente para aquele app. Conecte o Appliance à internet brevemente, sincronize a versão atualizada e então distribua-a para seus dispositivos pelo fluxo padrão de atualização de apps.

Este design dá a você controle total sobre o que entra na sua rede — nada é baixado automaticamente, e a conexão à internet é necessária apenas durante a etapa de sincronização.

Remetente de e-mail personalizado (SMTP)

Por padrão, todos os e-mails da plataforma — verificação de conta, recuperação de senha, convites e notificações de alarme — são enviados através do proxy SMTP em nuvem da IronFlock e aparecem como [email protected]. Para que os e-mails apareçam como enviados pela sua própria empresa, aponte o appliance para o seu próprio servidor SMTP.

No host do appliance, edite o arquivo de ambiente gerado pelo instalador em /opt/ironflock/.env e defina as seguintes variáveis:

SMTP_CONNECTION_URI=smtps://USERNAME:[email protected]:465/
SMTP_FROM_ADDRESS=[email protected]
SMTP_FROM_NAME=Your Company

• Use smtps:// para TLS implícito (normalmente porta 465), ou smtp:// com STARTTLS (porta 587).
• Codifique em URL os caracteres especiais no usuário ou na senha (por exemplo, @ → %40).
• SMTP_FROM_ADDRESS e SMTP_FROM_NAME são o que os destinatários veem no cabeçalho De de cada e-mail da plataforma.

Aplique as alterações reiniciando a stack:

sudo systemctl restart ironflock.service

Após o reinício, todos os e-mails de autenticação, notificações da plataforma e e-mails de alarme são enviados pelo seu servidor SMTP com o endereço e o nome de remetente da sua empresa.

Se SMTP_CONNECTION_URI não estiver definido, o appliance continua roteando os e-mails através do proxy SMTP em nuvem da IronFlock autenticado com sua chave de licença — não é necessária configuração adicional, mas os e-mails terão a marca IronFlock.

Manutenção

Para atualizar o sistema IronFlock no seu appliance, o admin pode usar o botão de atualização na seção de licença do seu perfil sempre que uma nova versão estiver disponível. O appliance precisa de conexão à internet para baixar a atualização. O IronFlock reinicia automaticamente quando a atualização termina.

As atualizações do sistema operacional Linux são de sua responsabilidade.

Ciclo de vida da licença

Sua licença está vinculada a um único Appliance físico. A mesma licença não pode executar uma segunda instância IronFlock em hardware diferente ao mesmo tempo. Na operação do dia a dia, o Appliance funciona offline — dados de produção, dashboards, gerenciamento de apps e controle dos dispositivos de borda permanecem todos localmente no equipamento.

Quando o Appliance precisa de internet

A conexão com a internet só é necessária nestes momentos:

• Instalação inicial e atualizações do Appliance — necessária de qualquer forma para baixar o software dos servidores de distribuição do IronFlock; a licença é ativada nessa mesma etapa.
• Reverificação periódica da licença — depende do seu plano:
  • Licença mensal: uma vez a cada 30 dias.
  • Licença anual: uma vez a cada 365 dias.
  • Licença perpétua: sem reverificação periódica — a internet só é necessária na instalação e nas atualizações.
• Transferência de licença para um novo hardware (veja abaixo).
• Serviço AI Multi Agent — somente enquanto estiver sendo usado ativamente.

Período de tolerância e bloqueio

Se uma reverificação periódica não conseguir alcançar a nuvem (falha de rede, erro transitório na nuvem), o Appliance entra em um período de tolerância de 7 dias. Durante esse período, o Appliance continua funcionando normalmente e tenta novamente de forma automática.

Se sete dias completos se passarem sem uma reverificação bem-sucedida, o Appliance se bloqueia: a maioria das operações é recusada e a interface mostra a licença como inválida. Para recuperar, restabeleça a conexão do Appliance com a internet e clique em Revalidar agora no painel de licença do seu perfil na interface do Appliance (a visualização local http://<appliance-host>, ou sua instância acessada pelo ironflock.com).

Mover sua licença para um novo hardware (transferência)

Uma licença está vinculada à impressão digital de hardware de uma máquina. Para movê-la para outra máquina, você inicia uma transferência a partir do seu perfil na nuvem IronFlock:

1. Abra Perfil → Instâncias em ironflock.com.
2. Clique em Redefinir impressão digital do hardware na instância que você deseja mover.

A transferência exige que o Appliance atualmente vinculado esteja online. A nuvem se conecta de volta a ele, pede que ele se revogue localmente e só então limpa a impressão digital do lado da nuvem. Esse handshake garante que o Appliance antigo não continue funcionando enquanto um novo se vincula — evitando o uso duplo acidental da mesma licença.

Assim que o desbloqueio for concluído:

1. Configure o novo hardware seguindo os passos de Instalação, usando a mesma instance key.
2. O novo Appliance faz a validação, vincula sua impressão digital e se torna o dispositivo ativo.

Quando o hardware antigo está com defeito ou inacessível

Se o Appliance vinculado anteriormente estiver inoperante ou inacessível por outro motivo, o handshake atinge o tempo limite e a interface da nuvem mostra appliance_unreachable_contact_support. Nesse caso, entre em contato com a equipe IronFlock — podemos remover o vínculo manualmente após verificar a titularidade.

Dica: acione a transferência antes de desativar o hardware antigo, enquanto ele ainda está online. O processo é muito mais rápido — para você e para nossa equipe de suporte — quando o Appliance antigo ainda pode ser alcançado.