T2Mark Docs
Painel
Docs / Painel Web / Registrar e Gerenciar Máquinas

Registrar e Gerenciar Máquinas

Este guia mostra como registrar máquinas (agentes Windows) no painel T2Mark e gerenciá-las após o registro.

Fluxo Geral

1. Admin baixa agente (arquivo .exe)
2. Usuário final instala agente na máquina
3. Agente se registra automaticamente (precisa TenantKey)
4. Admin vê máquina aparecer no painel
5. Admin associa política à máquina
6. Marca d'água aparece automaticamente

Pré-requisitos


Parte 1: Baixar o Agente

No Painel

  1. Clique em “Painel Web”“Agente Windows”“Download”
  2. Você verá a opção “Baixar Agente T2Mark”
  3. Clique no botão verde de download

Arquivo Recebido

Você recebe T2Mark-Setup.exe (ou similar)

Informação Important: TenantKey

Quando o agente é baixado, ele contém sua TenantKey. Esta chave:


Parte 2: Instalar o Agente

Distribua o T2Mark-Setup.exe para suas máquinas (email, pen drive, rede, etc).

Na máquina do usuário:

  1. Execute T2Mark-Setup.exe
  2. Siga o instalador (next, next…)
  3. Reinicie a máquina (ou aguarde alguns segundos)
  4. Você deve ver a marca d’água na tela após reinício

Parte 3: Ver Máquina Registrada

Após a máquina se registrar (automaticamente), ela aparece no painel.

Acessar Máquinas

  1. No painel, clique em “Máquinas” (menu principal)
  2. Você verá uma tabela com todas as máquinas registradas

Coluna: Status

Status Significado
🟢 Ativa Máquina online, heartbeat recente
🟡 Inativa Última sincronização há > 5 min
🔴 Offline Não sincroniza há horas/dias

Heartbeat: O agente envia um sinal de “estou vivo” a cada ~30 segundos. Sem heartbeat recente = offline.

Colunas Principais

Coluna O Que É
Hostname Nome da máquina Windows
Usuário Último Quem estava logado na última sincronização
Última Sincronização Quando o agente fez último heartbeat
Política Associada Qual marca d’água está aplicada
Ações Botões para gerenciar

Parte 4: Associar Política

Após registrar uma máquina, você pode escolher qual marca d’água ela exibe.

Método 1: Ao Criar Política

Ao criar uma nova política (veja Criar Política):

  1. Após salvar, pergunta: “Associar a máquinas?”
  2. Clique [Sim]
  3. Selecione máquinas na lista
  4. Clique [Aplicar]

Método 2: A Partir de Máquinas

  1. Vá para “Máquinas”
  2. Clique na linha da máquina (ou no botão “Editar”)
  3. Em “Política Associada”, escolha da dropdown
  4. Clique [Salvar]

Parte 5: Monitorar Máquinas

Verificar Status

Na tela de Máquinas, observe:

Tempo para Aplicar Mudanças

Quando você troca a política de uma máquina:

Você muda política  →  Máquina faz polling (~30s)  →  Agente recebe nova política  →  Marca muda (~5s)

Total: ~35 segundos até a marca aparecer.

Detalhes da Máquina

Clique no hostname ou botão “Detalhes” para ver:


Parte 6: Gerenciar Máquinas

Desativar Máquina

Se você quer que a marca d’água suma mas manter histórico:

  1. Clique no botão “Desativar” na linha da máquina
  2. A máquina fica inativa (marca some)
  3. Você ainda vê o histórico e pode reativar depois

Quando usar: Máquina foi devolvida, empregado saiu, etc.

Reativar Máquina

  1. Máquina desativada ainda aparece na lista
  2. Clique “Reativar”
  3. Se agente está rodando, marca volta

Desinstalar do Servidor

Se quer remover completamente do painel (sem histórico):

  1. Clique “Desinstalar”
  2. Escolha: “Limpar histórico?”
    • Sim = apaga tudo
    • Não = mantém histórico, apenas remove máquina ativa

Parte 7: Atualizar Politicas em Lote

Às vezes você quer mudar a política de várias máquinas de uma vez.

Usando Filtros/Busca

  1. Na tela de Máquinas, use a busca:
    • hostname: "VENDAS*" → todas com “VENDAS”
    • usuario: "silva" → máquinas do Silva
    • politica: "Confidencial" → todas com esta política
  2. Selecione várias máquinas (checkbox)
  3. Clique “Mudar Política em Lote”
  4. Escolha nova política
  5. Clique [Aplicar]

Fluxo Completo: Exemplo Prático

Cenário

Você é admin. Uma nova política “Projeto Secreto - Vermelho” foi criada. Você quer aplicá-la a 10 máquinas do setor de P&D.

Passo a Passo

1. Criar a Política (5 minutos)

2. Asociar a Máquinas (2 minutos)

3. Monitorar Aplicação (próximos 2 minutos)

4. Validar em Máquina Real


Troubleshooting

Problema Causa Solução
Máquina não aparece Agente não se registrou Verifique TenantKey no instalador, reinicie máquina
Status sempre “Inativo” Agente não fazendo polling Abra cmd em admin: ping google.com (teste rede)
Marca não aparece após trocar política Não sincronizou em 1 min Aguarde ~1 min ou logout→login na máquina
Marca muito fraca Opacidade baixa Aumente opacidade da política (0.20+)
Caracteres quebrados na marca Encoding incorreto Verifique acentos/caracteres especiais
Máquina desaparece após dias offline Limpeza automática Máquinas sem heartbeat por 30 dias são removidas
Não consigo desativar máquina Permissões insuficientes Você é superadmin? Contacte suporte

API Keys (Técnico)

Quando uma máquina se registra:

  1. Agente envia TenantKey (conhecida, no instalador)
  2. Servidor responde com API Key (gerada, segura)
  3. Agente salva API Key em C:\T2Mark\config.ini
  4. Próximas sincronizações usam API Key (não TenantKey)

Por que? Segurança — TenantKey só é usado 1 vez. Aí a máquina fica identificada por uma chave única (API Key).

Se quiser resetar uma máquina:


Resumo Rápido

1. Baixe agente (contém TenantKey)
2. Distribua e instale nas máquinas
3. Agente se registra automaticamente
4. Aparece em "Máquinas" no painel
5. Escolha política para cada máquina
6. ~35s depois, marca aparece
7. Monitore status (verde = ok)
8. Desative/desinstale quando necessário