> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mecanismo de política

> Avaliação de políticas de nível empresarial para cenários B2C, B2B, B2G e B2B2C.

Aplique regras de conformidade, requisitos de confiança e políticas de segurança em todo o seu ecossistema. As políticas se aplicam a três categorias: `MINT`, `VERIFY` e `BUNDLE_EXPORT`.

> [!NOTE]
>
> Procurando configurar políticas baseadas em regras a partir do console ou API? Consulte o [guia de políticas de emissão](https://docs.truthlocks.com/pt/guides/issuance-policies.md) para criar, gerenciar e simular políticas sem escrever código.

## Modelos de Política

> [card] B2C - Consumidor
>
> Política focada no consumidor com divulgação de confiança e proteções de risco. - Emissor
> deve estar em status confiável - O nível de confiança deve ser verified\_org ou superior -
> Bloquear emissores de alto/crítico risco - A chave deve estar ativa

> [card] B2B - Corporativo
>
> Business-to-business com requisitos da indústria e rotação de chaves. - Emissor
> deve estar em status confiável - Finanças/Saúde exigem o nível regulated\_issuer
>
> * Rotação de chave exigida a cada 180 dias - Aprovações de governança para status
>   alterações

> [card] B2G - Governo
>
> Política de nível governamental com requisitos de conformidade rigorosos. - Todos
> atestados exigem o nível de emissor regulamentado - Bloquear risco médio ou superior
> emissores - Rotação de chaves exigida a cada 90 dias - Documentação obrigatória
> motivos de revogação

> [card] B2B2C - Híbrido
>
> Política híbrida para cenários empresa-consumidor com dupla divulgação. -
> O emissor deve estar em status confiável - O nível de confiança deve ser verified\_org ou superior
>
> * Proteção de privacidade: payload não armazenado - Amigável ao consumidor + empresarial
>   detalhes da auditoria

## Uso

```javascript theme={null}
import { EnterprisePolicyEngine, templates } from "@truthlock/policy";

// Create engine with B2B template
const engine = new EnterprisePolicyEngine(templates.B2B);

// Evaluate policy
const result = engine.evaluate({
  tenant_id: "tenant-uuid",
  issuer_current: {
    id: "issuer-uuid",
    status: "trusted",
    trust_tier: "verified_org",
    risk_rating: "low",
    jurisdiction: "US",
    assurance_level: "standard",
  },
  key: {
    kid: "key-1",
    status: "ACTIVE",
    valid_from: "2024-01-01T00:00:00Z",
    age_days: 30,
  },
  context: {
    request_type: "mint",
    industry: "technology",
  },
});

if (!result.allowed) {
  console.log("Denied:", result.code);
  console.log("Reason:", result.compliance_explanation);
}
```

## Resultado da Política

```typescript theme={null}
interface PolicyResult {
  allowed: boolean;
  code: string; // e.g., "ISSUER_NOT_TRUSTED"
  reason: string; // Human-readable reason
  compliance_explanation: string; // Compliance-friendly explanation
  disclosures?: {
    type: "warning" | "info" | "critical";
    message: string;
    audience: "consumer" | "enterprise" | "all";
  }[];
}
```

## Versionamento de Políticas

Cada instância de política tem um hash único computado a partir do modelo e das regras. Este hash pode ser armazenado com atestados para fins de auditoria.

```javascript theme={null}
const engine = new EnterprisePolicyEngine(templates.B2G);

console.log("Policy hash:", engine.getPolicyHash());
// => "a1b2c3d4e5f6g7h8"

console.log("Policy version:", engine.getPolicyVersion());
// => "1.0.0-1704067200000"
```

## Categorias de políticas

| Categoria | Aplica-se a |
| - | - |
| `MINT` | Solicitações de cunhagem de atestado |
| `VERIFY` | Solicitações de verificação |
| `BUNDLE_EXPORT` | Exportação de pacote de prova e solicitações de portabilidade de dados |

As políticas `BUNDLE_EXPORT` são avaliadas sempre que um usuário ou cliente de API solicita o download de um pacote de prova ou envia uma exportação de portabilidade de dados. Use-as para restringir exportações por jurisdição, nível de confiança, classificação de risco ou qualquer outro campo disponível no contexto de avaliação. Consulte [políticas de controle de exportação](https://docs.truthlocks.com/pt/guides/issuance-policies.md#export-control-policies) para exemplos.

## Ciclo de vida da política

Toda política tem um status que controla a aplicação:

| Status | Comportamento |
| - | - |
| `DRAFT` | Salvo, mas não aplicado — use enquanto itera nas regras |
| `ACTIVE` | Aplicado em cada pedido correspondente |
| `DISABLED` | Desativado temporariamente sem exclusão |

Apenas as políticas `ACTIVE` são avaliadas no momento da solicitação. Cada alteração de status incrementa a versão da política, que é registrada junto com cada decisão de avaliação para fins de auditoria.

Um ciclo de vida típico:

1. **Criar como `DRAFT`** — construa e refine regras sem afetar o tráfego ao vivo.
2. **Simular** — teste a política com entradas de amostra.
3. **Definir como `ACTIVE`** — a aplicação começa imediatamente.
4. **Definir como `DISABLED`** — pausar a aplicação sem perder a definição da política.
5. **Excluir** — remover a política quando não for mais necessária.

> [!NOTE]
>
> Consulte o [guia de políticas de emissão](https://docs.truthlocks.com/pt/guides/issuance-policies.md#policy-lifecycle) para instruções passo a passo sobre como gerenciar transições de status de política.

## Simulando políticas

Teste como uma política avalia uma determinada entrada antes de implantá-la. Consulte o [simulador de políticas](https://docs.truthlocks.com/pt/guides/issuance-policies.md#simulating-a-policy) para uso do console e da API.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.