T2Mark Docs
Painel
Docs / Agente Windows / Variáveis de Marca D'Água

Variáveis de Marca D'Água

Variáveis são placeholders dinâmicos que se adaptam automaticamente a cada máquina e usuário. Este guia lista todas as variáveis disponíveis e como usá-las no template da marca d’água.

O Que São Variáveis?

Variáveis são instruções que dizem: “Coloque o valor específico daqui nesta máquina”.

Exemplo:

Template: {domain}\{user} | {date}

Máquina 1 (Joao):
  Renderiza: ACME\joao.silva | 05/05/2026

Máquina 2 (Maria):
  Renderiza: ACME\maria.santos | 05/05/2026

Máquina 3 (Outro domínio):
  Renderiza: OTHERDOMAIN\carlos.silva | 05/05/2026

Mesma política → Resultados diferentes em cada máquina. Automático!


Variáveis Disponíveis

1. {domain}

O que é: Domínio Windows (LDAP/AD)

Valor: Nome de domínio (ex: ACME, CORPORACAO, EMPRESA)

Origem: Environment.UserDomainName (Windows API)

Exemplo de uso:

Template: Usuário de {domain}

Máquina 1:  Usuário de ACME
Máquina 2:  Usuário de CORPORACAO
Máquina 3:  Usuário de OTHERDOMAIN

Casos de uso:


2. {user}

O que é: Nome do usuário Windows logado

Valor: Nome de usuário (ex: joao.silva, maria.santos, admin)

Origem: Environment.UserName (Windows API)

Exemplo de uso:

Template: Logado como {user}

Máquina A:  Logado como joao.silva
Máquina A:  Logado como maria.santos (depois de logout/login)
Máquina B:  Logado como carlos.silva

Casos de uso:


3. {date}

O que é: Data atual da máquina

Valor: Data no formato DD/MM/YYYY (ex: 05/05/2026)

Origem: DateTime.Now (relógio local da máquina)

Exemplo de uso:

Template: Capturado em {date}

Máquina 1:  Capturado em 05/05/2026
Máquina 1:  Capturado em 06/05/2026 (próximo dia)
Máquina 2:  Capturado em 05/05/2026

Importante: Data vem do relógio local da máquina.

Se relógio estiver errado → data errada na marca.

Casos de uso:


4. {hostname}

O que é: Nome da máquina/computador

Valor: Nome de hostname (ex: PC-VENDAS-001, LAPTOP-SILVA)

Origem: Environment.MachineName (Windows API)

Exemplo de uso:

Template: Máquina {hostname}

Máquina A:  Máquina PC-VENDAS-001
Máquina B:  Máquina LAPTOP-SILVA
Máquina C:  Máquina DESKTOP-TI-002

Casos de uso:


Combinando Variáveis

A maioria das políticas usa múltiplas variáveis juntas:

Combinação 1: Usuário + Data (Padrão)

{user} | {date}

Renderiza:
  joao.silva | 05/05/2026

Combinação 2: Domínio + Usuário + Data (Mais Rastreável)

{domain}\{user} | {date}

Renderiza:
  ACME\joao.silva | 05/05/2026

Combinação 3: Usuário + Máquina + Data (Nível Alto)

{user} @ {hostname} | {date}

Renderiza:
  joao.silva @ PC-VENDAS-001 | 05/05/2026

Combinação 4: Tudo (Máximo Detalhe)

{domain}\{user} @ {hostname} | {date}

Renderiza:
  ACME\joao.silva @ PC-VENDAS-001 | 05/05/2026

Combinação 5: Estruturado (Multi-linha)

ACESSO: {domain}\{user}
MÁQUINA: {hostname}
DATA: {date}

Renderiza:
  ACESSO: ACME\joao.silva
  MÁQUINA: PC-VENDAS-001
  DATA: 05/05/2026

Casos de Uso por Setor

Vendas (Rastreamento de Clientes)

Template: {domain}\{user} - {date}

Razão: Identificar qual vendedor acessou qual cliente

TI (Auditoria Técnica)

Template: AUDITADO: {domain}\{user} @ {hostname} | {date}

Razão: Rastrear quem fez o quê em qual máquina e quando

Jurídico (Compliance Máximo)

Template: CONFIDENCIAL
ACESSO: {domain}\{user}
MÁQUINA: {hostname}
DATA: {date}

Razão: Máximo detalhe para investigações/auditorias

RH (Discreto)

Template: {user} - {date}

Razão: Menos invasivo, mas ainda rastreável

Pesquisa/P&D (Segredo Máximo)

Template: PROJETO SECRETO
RESPONSÁVEL: {domain}\{user}
MÁQUINA: {hostname}
DATA: {date}

Razão: Máxima segurança para dados sensíveis

Formatação com Variáveis

Escape de Barra (Domain\User)

Para exibir a barra literal, use barra invertida dupla ou escape:

✅ CORRETO:   {domain}\{user}
   Renderiza: ACME\joao.silva

❌ ERRADO:    {domain}/{user}
   Renderiza: ACME/joao.silva (barra "normal", não típica Windows)

Espaçamento

Adicione espaços/pontuação conforme necessário:

{user} - {date}          (hífen com espaços)
{domain}\{user}|{date}   (pipe sem espaços)
[{user}] ({date})        (colchetes e parênteses)

Capitalização

Variáveis vêm conforme Windows:

{domain}    → ACME (maiúscula, ou minúscula se domínio for assim)
{user}      → joao.silva (minúscula, padrão corporativo)
{hostname}  → PC-VENDAS-001 (conforme nomeação local)

Se precisar mudar a capitalização:

Criar política com texto:  {domain} \ {user}
Renderiza:                ACME \ joao.silva

Ordem de Variáveis

Recomendação: Ordem lógica para rastreabilidade.

Ordem 1: De Específico para Geral

{user} → {hostname} → {domain} → {date}

Lê-se: "Este usuário, nesta máquina, deste domínio, nesta data"

Ordem 2: Hierárquica

{domain}\{user} → {hostname} → {date}

Lê-se: "Este domínio e usuário, nesta máquina, nesta data"

Ordem 3: Cronológica (Para Documentos)

{date} - {domain}\{user} @ {hostname}

Lê-se: "Nesta data, este usuário fez isso nesta máquina"

Variáveis Não Disponíveis (E Por Quê?)

❌ {time}

Por quê não está disponível:

Alternativa: Apenas {date} está disponível.


❌ {groups}

Por quê não está disponível:

Alternativa: Use {domain} para identificar qual AD o usuário veio.


❌ {email}

Por quê não está disponível:

Alternativa: Use {domain}\{user} para identificação.


❌ {os}

Por quê não está disponível:

Alternativa: Assumir sempre Windows.


Comportamento Especial

O Que Acontece Se…

…um usuário não está em domínio?

{domain} retorna: WORKGROUP (ou computername local)
{user}   retorna: usuario (local, sem domínio)

…máquina não consegue pegar informação?

Raro, mas se houver erro:
  {domain} → "UNKNOWN"
  {user}   → "UNKNOWN"
  {hostname} → "UNKNOWN"
  {date}     → "01/01/1970" (fallback)

…relógio da máquina está errado?

{date} reflete a data LOCAL errada.

Solução: Sincronizar relógio Windows com servidor NTP.

Exemplos Práticos Completos

Exemplo 1: Política Vendas

Admin cria no painel:

Texto: {domain}\{user} | {date}
Cor: #FFFF00
Opacidade: 0.15

Nas máquinas:

Máquina PC-VENDAS-001, João Silva, 05/05/2026:
  ↓ Renderiza ↓
  ACME\joao.silva | 05/05/2026

Máquina LAPTOP-SILVA, Maria Santos, 06/05/2026:
  ↓ Renderiza ↓
  ACME\maria.santos | 06/05/2026

Exemplo 2: Política TI Auditoria

Admin cria:

Texto:
  AUDITADO
  {domain}\{user}
  {hostname}
  {date}
Cor: #0000FF
Opacidade: 0.20
Tamanho: 18px

Máquina PC-TI-002, Carlos Silva, 05/05/2026:

AUDITADO
ACME\carlos.silva
PC-TI-002
05/05/2026

Exemplo 3: Política P&D Secreto

Admin cria:

Texto:
  PROJETO SECRETO — Acesso Restrito
  Responsável: {domain}\{user}
  Máquina: {hostname}
  Data: {date}
Cor: #FF0000
Opacidade: 0.25
Tamanho: 24px
Negrito: Sim

Máquina LAPTOP-PESQUISA-04, Dra. Silva, 05/05/2026:

PROJETO SECRETO — Acesso Restrito
Responsável: ACME\dra.silva
Máquina: LAPTOP-PESQUISA-04
Data: 05/05/2026

Resumo Rápido

VARIÁVEIS DISPONÍVEIS:
  {domain}   → Domínio Windows (ex: ACME)
  {user}     → Usuário Windows (ex: joao.silva)
  {date}     → Data local (ex: 05/05/2026)
  {hostname} → Nome máquina (ex: PC-VENDAS-001)

COMBINAÇÕES COMUNS:
  {domain}\{user} | {date}           (padrão)
  {user} @ {hostname} | {date}       (máquina + usuário)
  {domain}\{user} @ {hostname}       (máximo detalhe)

CADA POLÍTICA USA VARIÁVEIS:
  ✓ Mesma política em 100 máquinas
  ✓ Cada máquina mostra seus próprios valores
  ✓ Automático, sem reconfiguração manual

NÃO DISPONÍVEL:
  ✗ {time}   (muda a cada segundo)
  ✗ {groups} (ambiguo, muitos valores)
  ✗ {email}  (pode não existir)
  ✗ {os}     (sempre Windows)