Configuração

A configuração do agente T2Mark é feita através do arquivo config.ini na máquina local. Este guia explica os arquivos, diretórios e como configurar manualmente se necessário.

Localização dos Arquivos

Após instalar, todos os arquivos do agente ficam em:

C:\T2Mark\
├── config.ini           (configuração — IMPORTANTE)
├── agent_debug.log      (log do Core service)
├── overlay_debug.log    (log do Overlay)
└── ...outros arquivos

Diretório de Instalação

O executável fica em:

C:\Program Files\T2Mark\
├── Core.exe             (Windows Service)
├── Overlay.exe          (WPF application)
└── ...dependências

Arquivo: config.ini

Este é o arquivo principal de configuração. Contém credenciais, política e metadados do agente.

Estrutura Geral

[Agent]
TenantKey=abcd1234efgh5678...
ApiKey=sha256_hash_of_api_key...
Endpoint=https://t2mark.setor9.net

[Watermark]
Template=color=#FFFF00\nopacity=0.15\n---\n{domain}\{user} | {date}\nCONFIDENCIAL
Version=1

Seção [Agent]

TenantKey

TenantKey=abcd1234efgh5678ijkl9012mnop3456qrst

O que é: Chave única da sua empresa
Vem de: Dentro do instalador (automático)
Função: Primeira identificação no servidor (registro)
Mudança: Raramente — apenas se trocar de empresa

ApiKey

ApiKey=5f1b3c8e9d2a4b6c7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b

O que é: Chave de API individual da máquina (SHA-256 hash)
Vem de: Servidor, após registro com TenantKey
Função: Autenticação em requisições posteriores
Mudança: Automático se máquina se re-registra

Endpoint

Endpoint=https://t2mark.setor9.net

O que é: URL do servidor T2Mark
Padrão: https://t2mark.setor9.net
Mudança: Não altere (servidor gerenciado)

Seção [Watermark]

Template

Template=color=#FFFF00\nopacity=0.15\n---\n{domain}\{user} | {date}\nCONFIDENCIAL

O que é: Configuração completa da marca (Front Matter format)
Vem de: Política criada no painel (servidor envia)
Mudança: Automática quando admin muda política

Para detalhes sobre template format, veja Template da Marca D’Água.

Version

Version=1

O que é: Número da versão da política atual
Vem de: Política no servidor
Função: Agente aplica updates apenas se nova_versão > versão_local
Mudança: Automática quando nova versão chega

Arquivo: agent_debug.log

Log do serviço Core (Windows Service).

Localização

C:\T2Mark\agent_debug.log

Conteúdo Típico

[2026-05-05 14:30:00] Service started
[2026-05-05 14:30:05] Initializing IPC server...
[2026-05-05 14:30:10] Loading config from C:\T2Mark\config.ini
[2026-05-05 14:30:15] TenantKey: abcd1234...
[2026-05-05 14:30:20] Connecting to https://t2mark.setor9.net
[2026-05-05 14:30:25] GET /api/config — 200 OK
[2026-05-05 14:30:30] Registering machine...
[2026-05-05 14:30:35] POST /api/register — 201 Created
[2026-05-05 14:30:40] Received ApiKey: 5f1b3c8e...
[2026-05-05 14:30:45] Polling for policy...
[2026-05-05 14:30:50] GET /api/policy — 200 OK
[2026-05-05 14:30:55] New policy version: 1
[2026-05-05 14:31:00] Sending CONFIG message to Overlay via Named Pipe
[2026-05-05 14:31:05] Overlay connected and received CONFIG
[2026-05-05 14:31:10] Heartbeat sent successfully

Como Usar para Debugging

Problema: Máquina não sincroniza
Solução: Verifique log para erros:

# Abra o arquivo
notepad C:\T2Mark\agent_debug.log

# Procure por: ERROR, FAIL, 404, 500, Connection refused

Arquivo: overlay_debug.log

Log da aplicação Overlay (WPF app).

Localização

C:\T2Mark\overlay_debug.log

Conteúdo Típico

[2026-05-05 14:30:45] MainWindow initialized
[2026-05-05 14:30:50] Connecting to Named Pipe...
[2026-05-05 14:30:55] Connected to T2MarkPipe
[2026-05-05 14:31:00] Received CONFIG message
[2026-05-05 14:31:05] Parsing Front Matter template...
[2026-05-05 14:31:10] Metadata: color=#FFFF00, opacity=0.15
[2026-05-05 14:31:15] Text template: {domain}\{user} | {date}
[2026-05-05 14:31:20] Resolving variables: ACME\joao.silva | 05/05/2026
[2026-05-05 14:31:25] Rendering watermark on screen
[2026-05-05 14:31:30] Applied dual-layer watermark (main + inverted)
[2026-05-05 14:31:35] Window positioned: -1 (HWND_TOPMOST)
[2026-05-05 14:31:40] Keyboard hook installed (blocks Print Screen)
[2026-05-05 14:31:45] Heartbeat: PING sent

Como Usar para Debugging

Problema: Marca aparece com cores estranhas
Solução: Verifique log:

notepad C:\T2Mark\overlay_debug.log

# Procure por: "Parsing Front Matter", "Rendering watermark"
# Verifique valores de color, opacity

Editar Manualmente (Não Recomendado)

Se o agente não consegue sincronizar com servidor, você pode editar manualmente:

⚠️ Aviso: Apenas como emergência/teste. Use painel web sempre que possível.

Passo 1: Parar o Serviço

Abra cmd como admin:

sc stop T2MarkCore

Aguarde 5 segundos.

Passo 2: Editar Arquivo

notepad C:\T2Mark\config.ini

Modifique conforme necessário (ver seções acima).

Passo 3: Salvar

Ctrl+S para salvar.

Passo 4: Reiniciar Serviço

sc start T2MarkCore

Aguarde 10 segundos. Overlay deve relançar automaticamente.

Passo 5: Verificar Logs

type C:\T2Mark\agent_debug.log | findstr ERROR

Se houver erros, reverta as mudanças.

Credenciais e Segurança

Proteção do config.ini

O arquivo config.ini contém credenciais sensíveis (TenantKey, ApiKey):

Permissões: SYSTEM (só sistema pode ler/escrever)
ACL: Bloqueada para outros usuários
Chance de acesso não autorizado: Mínima

⚠️ Nunca:

❌ Compartilhe o arquivo
❌ Copie para rede não segura
❌ Coloque em email
❌ Upload para internet

Se TenantKey/ApiKey Foram Comprometidos

Contacte suporte: suporte@t2mark.setor9.net
Providência: Suporte gera nova ApiKey
Reinstale agente: Receberá novo arquivo com novas credenciais

Modificar Política Manualmente

Se precisar testar uma política antes de publicar no servidor:

Editar Template (Teste Local)

[Watermark]
Template=color=#FF0000\nopacity=0.25\n---\nTESTE - {user}
Version=999

Efeito

Salve o arquivo
Parar/reiniciar Core service
Overlay receberá a política via Named Pipe
Marca muda localmente
⚠️ Não afeta servidor — revertido quando admin publica v2

Variáveis de Ambiente

Se o agente precisar de variáveis do Windows:

Variável	Localização
`%COMPUTERNAME%`	Hostname da máquina
`%USERNAME%`	Usuário logado
`%USERDOMAIN%`	Domínio Windows
`%APPDATA%`	C:\Users\username\AppData\Roaming

O agente acessa automaticamente. Não precisa de configuração manual.

Versões do Config.ini

Cada atualização de política cria uma nova versão:

Histórico de Versões

; config.ini pode ter histórico comentado:

; V1 - Original (05/05/2026)
; [Watermark]
; Template=color=#FFFF00\nopacity=0.15\n---\n{user}

; V2 - Mudou cor (10/05/2026)  
; [Watermark]
; Template=color=#FF0000\nopacity=0.15\n---\n{user}

; V3 - Atual (15/05/2026)
[Watermark]
Template=color=#FF0000\nopacity=0.25\n---\n{domain}\{user}
Version=3

Nota: O arquivo sempre contém apenas a versão atual — histórico é apenas referência.

Limpeza e Manutenção

Limpar Logs (Se Ficarem Grandes)

del C:\T2Mark\agent_debug.log
del C:\T2Mark\overlay_debug.log

# Serviço recria logs automaticamente na próxima execução

Verificar Tamanho

dir C:\T2Mark\

Se agent_debug.log > 100 MB, considere limpar.

Troubleshooting de Configuração

Problema	Verificar
config.ini não existe	Instalação falhou? Reinstale agente
ApiKey está vazio	TenantKey não registrou? Aguarde polling ou reinicie serviço
Marca não muda após editar	Reiniciou Core service? Sintaxe config.ini está correta?
Erro “File locked” ao editar	Core service ainda rodando? Execute `sc stop T2MarkCore`
Logs gigantescos	Delete logs antigos (veja “Limpeza” acima)

Resumo Rápido

LOCALIZAÇÃO:
  C:\T2Mark\config.ini      ← Principal (credenciais + política)
  C:\T2Mark\agent_debug.log ← Log do Core
  C:\T2Mark\overlay_debug.log ← Log do Overlay
  C:\Program Files\T2Mark\  ← Executáveis

CONFIG.INI:
  [Agent] → TenantKey, ApiKey, Endpoint
  [Watermark] → Template (Front Matter), Version

EDITAR:
  1. sc stop T2MarkCore
  2. notepad C:\T2Mark\config.ini
  3. Modifique
  4. sc start T2MarkCore
  5. Verifique logs

SEGURANÇA:
  ✓ config.ini protegido com ACL (SYSTEM only)
  ✗ Nunca compartilhe arquivo
  ✓ Credenciais geradas automaticamente pelo servidor