Segurança

A plataforma HAM protege os seus dispositivos e os seus dados. Você controla algumas das definições de segurança. Encontra-as abaixo.

Ligação do dispositivo

• O dispositivo abre a ligação para o servidor. Não precisa de porta de entrada nem de redirecionamento de portas.
• A ligação utiliza TLS com autenticação mútua na porta 9002. O dispositivo verifica o servidor e o servidor verifica o dispositivo.
• Cada dispositivo tem a sua própria chave única, criada na produção.
• Por predefinição, o dispositivo não aceita comandos da rede local.

Uma firewall com inspeção SSL interrompe a autenticação mútua. Nesse caso, o dispositivo não se liga. Consulte as definições do router.

A chave do dispositivo

A etiqueta do dispositivo tem a chave do dispositivo. Utiliza esta chave para adicionar o dispositivo à sua conta. É também a palavra-passe da rede WiFi que o dispositivo abre durante a configuração.

Guarde a etiqueta num local seguro. Não publique uma fotografia dela.

Permissões do dispositivo

O proprietário de um dispositivo partilha-o com outros utilizadores. Cada utilizador recebe um nível:

Nível	O que o utilizador pode fazer
Ver	Ver as leituras e o histórico.
Controlo	Controlar também as saídas.
Gerir	Alterar também as definições do dispositivo.

Utilize Revogar para remover o acesso de um utilizador. Consulte partilhar dispositivos.

A API, o WebSocket e o MCP verificam as mesmas permissões em cada chamada.

Chave API e token

• A chave API dá acesso total à sua conta. Não expira.
• Cada conta tem uma chave API. Quando cria uma chave nova, a chave antiga deixa de funcionar de imediato.
• Um token de acesso expira após 60 dias.

Regras para a chave:

• Não coloque a chave em código que corre num navegador.
• Não coloque a chave num repositório de código público.
• Se pensa que outra pessoa tem a chave, crie uma chave nova.

Consulte a API REST.

Acesso de suporte

A definição Permitir acesso de suporte está na página Conta. Por predefinição está desativada. Quando a ativa, a HAM Systems pode aceder à sua conta para dar apoio. Desative-a quando o trabalho de apoio terminar.

Computador

Telefone

Para a gestão permanente por um instalador ou um parceiro, consulte contas geridas.

Controlo a partir da rede local

A definição Permitir comandos LAN está nas definições do dispositivo. Por predefinição está desativada.

Quando a ativa:

• A aplicação pede duas confirmações.
• A aplicação mostra a janela Token de autorização para acesso LAN apenas uma vez. Toque em Copiar e guarde o token num local seguro.
• Para obter um token novo, desative a definição e ative-a outra vez.
• Cada dispositivo na mesma rede local que tem o token pode controlar o dispositivo.

Ative esta definição apenas numa rede em que confia.

Webhooks

• O servidor chama apenas endereços https.
• O servidor não chama endereços IP privados ou locais.
• O servidor remove as credenciais do WiFi dos dados do dispositivo antes de os enviar.
• A chamada não tem assinatura HMAC. Coloque um token secreto no URL e verifique-o no seu próprio servidor.

Consulte webhooks.

MCP

O assistente de IA utiliza a sua chave API. Tem as mesmas permissões que você. Pode controlar saídas nos dispositivos onde tem permissão de controlo. Consulte MCP para assistentes de IA.

Dados e certificações

• Os seus dados ficam em infraestrutura na UE. Consulte os seus dados.
• A HAM Systems tem certificação ISO 27001 para a segurança da informação. Para todas as certificações, consulte certificações e conformidade.