← Voltar ao guia de utilização
Guia · Segurança

Registar dispositivos para proteção de código

A 'gravação protegida' guarda o código das estratégias no servidor apenas como texto cifrado. Só esta conta e os dispositivos (agentes) assinados por ela podem abrir a cópia guardada. Este guia explica como criar essa lista de dispositivos.

Estado atual — a gravação protegida está disponível (2026-10-14). Nas contas com sessão iniciada por palavra-passe, as novas estratégias e alocadores são protegidos por defeito; as estratégias antigas podem ser convertidas uma a uma ou em lote a partir do 🛡 no estúdio. Esta lista indica os dispositivos que podem abrir esse código.

Quem pode abrir

Esta conta: abre num browser com sessão iniciada por palavra-passe (a chave da conta sai de um envelope que só a palavra-passe ou o código de recuperação abrem). Dispositivos assinados: os agentes incluídos na lista abaixo abrem-no com a sua própria chave — é por isso que backtests e trading real funcionam sem browser. Servidor soritrading: não consegue abrir o texto cifrado guardado nem alterar a lista (a assinatura só é feita no browser). No entanto, o código passa pelo servidor no momento em que é guardado e quando uma AI o lê — veja as limitações abaixo.

Passos

  1. Atualize o agente para a 1.302.0 ou posterior. O agente cria uma chave de selagem exclusiva do dispositivo (seal-key.json) e escreve no registo de arranque `[seal] code-seal key` com uma impressão digital de 16 caracteres.
  2. Inicie sessão neste browser com a palavra-passe. Nesse momento a chave da conta fica preparada e, se não existir lista de destinatários, é criada automaticamente.
  3. Menu Trading → Gestão de agentes. Em 'Agentes ligados', à esquerda, o painel 'Dispositivos que podem abrir código protegido' mostra uma linha de estado por dispositivo.
  4. Selecione o dispositivo uma vez na lista (ligação cifrada) e fica registado automaticamente — não há nada para premir. Pode, quando quiser, confirmar se a impressão digital coincide com a linha `seal` no registo desse dispositivo.
  5. Quando a linha indicar 'Assinado ✓', está concluído. O único caso em que tem de escolher é 'Chave alterada' (reinstalação, etc.) — assinale apenas se foi o utilizador a fazê-lo e a impressão digital coincidir, e prima [Assinar e guardar].

Ativos →

Estados das linhas e o que fazer

Assinado — Este dispositivo pode abrir código protegido.
A aguardar confirmação — Novo dispositivo — selecione-o uma vez na lista (ligação cifrada) e fica registado automaticamente.
Chave alterada — Reportou uma chave diferente da registada (reinstalação ou substituição do ficheiro da chave). Assinale e assine apenas se foi o utilizador a fazê-lo e a impressão digital coincidir com o valor `[seal] code-seal key …` no registo deste dispositivo — caso contrário, deixe como está.
Erro no ficheiro da chave — O agente não conseguiu ler o ficheiro da chave de selagem (seal-key.json). Veja a linha `[seal]` no registo do agente. O ficheiro nunca é substituído automaticamente.
Atualização necessária — Atualmente vx.y.z — o registo automático exige o agente 1.302.0. Aparece aqui depois de atualizar.
A aguardar relatório — A versão (vx.y.z) é suficiente, mas ainda não foi reportada nenhuma chave. Se o agente acabou de arrancar, aguarde 1 a 10 minutos. Se continuar assim, pesquise `seal` no separador de registos deste dispositivo.

Perguntas frequentes

  • E se remover um dispositivo? — É retirado da lista na próxima assinatura, e o código guardado a partir daí não pode ser aberto por ele. As versões anteriores que já recebeu não podem ser recuperadas.
  • Apareceu 'Chave alterada' — acontece quando o agente é reinstalado ou o seal-key.json é eliminado. Volte a assinalar apenas se foi o utilizador a fazê-lo e a impressão digital coincidir com o registo.
  • Aparece 'Inicie sessão novamente' — este browser não tem a chave da conta (outro browser, após terminar sessão, etc.). Termine a sessão e inicie-a com a palavra-passe. As linhas de estado dos dispositivos são visíveis mesmo antes disso.
  • A impressão digital difere do registo — não assinale. Pode significar que o servidor ou algo no caminho está a apresentar outra chave. Se continuar diferente depois de reiniciar esse dispositivo, contacte-nos.
  • Devo fazer cópia de segurança do seal-key.json? — Recomenda-se. Se o perder, os dados não desaparecem, porque a conta (palavra-passe·código de recuperação) continua a abrir o código, mas esse dispositivo terá de ser confirmado de novo com uma nova chave.

Limitações (com franqueza)

  • Durante a transmissão, o código passa pelo servidor. O servidor cifra-o ao recebê-lo e não guarda o original, mas no momento de guardar e quando uma AI (conector·assistente) lê o código (o seu agente abre-o apenas para esse pedido), o código passa pela memória do servidor.
  • Quando mostra código a uma AI remota (conector por subscrição·assistente com chave API), o código vai nesse momento para a empresa dessa AI. A gravação protegida impede que fique guardado no servidor, não impede o envio para uma AI.
  • Informações como nomes de estratégias, símbolos e resultados de backtest não são cifradas.
  • O browser, sozinho, não consegue detetar que o servidor volte a apresentar uma lista antiga (que ainda incluía um dispositivo removido). Esse dispositivo tinha uma chave que o utilizador confirmou anteriormente, pelo que o dano se limita a 'um dispositivo removido volta a receber'.
  • Retirar um dispositivo da lista não apaga as versões anteriores que já recebeu.