Quando usar políticas
Use políticas de emissão quando precisar:- Restringir a cunhagem a emissores em jurisdições específicas (por exemplo, apenas EUA ou EUA e UE)
- Exigir um nível mínimo de confiança antes que um emissor possa criar atestações
- Impor regras diferentes para cunhagem vs. verificação
- Controlar quem pode exportar pacotes de prova ou enviar solicitações de portabilidade de dados
- Testar uma política com entradas de amostra antes de implantar em produção
- Auditar qual política estava em vigor quando uma atestação foi criada
Como as políticas funcionam
Cada política contém uma ou mais regras. Uma regra tem:- Condições — verificações em nível de campo avaliadas em relação ao contexto da solicitação (por exemplo,
jurisdiction eq US) - Efeito —
ALLOWouDENYse as condições corresponderem - Efeito padrão — aplicado quando nenhuma regra corresponde
default_effect se aplica.
Operadores de condição
As condições suportam notação de ponto para campos aninhados (por exemplo,
key.age_days, key.status).
Campos disponíveis
Qualquer campo na entrada de avaliação pode ser referenciado, incluindo campos aninhados com notação de ponto. Os seguintes campos estão disponíveis por padrão:Ciclo de vida da política
Cada política tem um status que controla se ela é aplicada:
Ao criar uma política, você escolhe o status inicial. Apenas políticas
ACTIVE são avaliadas no momento da requisição.
Transições de ciclo de vida
As políticas geralmente seguem esta progressão:- Criar como
DRAFT— escreva e refine suas regras sem afetar o tráfego ao vivo. - Simular — teste a política de rascunho com entradas de amostra usando o simulador de política.
- Ativar — defina o status como
ACTIVEpara que a política seja aplicada às solicitações correspondentes. - Desativar — defina o status como
DISABLEDpara interromper temporariamente a aplicação sem perder a definição da política. - Excluir — remover a política inteiramente quando não for mais necessária.
DRAFT, ACTIVE e DISABLED a qualquer momento, atualizando a política. Cada mudança de status incrementa a versão da política, que é registrada junto com cada decisão de avaliação para fins de auditoria.
A transição de uma política para
ACTIVE entra em vigor imediatamente. Certifique-se de ter testado as regras com o simulador antes de ativar.Categorias de políticas
As políticas são restritas a uma ação específica:
Você pode ter várias políticas ativas. Cada política se aplica apenas à sua categoria.
Políticas de controlo de exportação
As políticasBUNDLE_EXPORT controlam quem pode exportar pacotes de prova e enviar solicitações de portabilidade de dados. Use-as para restringir exportações por jurisdição, nível de confiança ou qualquer outro campo na entrada de avaliação.
category como BUNDLE_EXPORT:
Vinculações de política
As vinculações de política conectam uma política a um destino específico para que o mecanismo saiba quando aplicá-la. Cada vinculação inclui:
Quando múltiplas vinculações correspondem a uma requisição, elas são avaliadas em ordem decrescente de prioridade. O primeiro resultado
DENY interrompe a avaliação imediatamente.
Criando uma vinculação via API
target_type como TENANT_DEFAULT e omita target_id:
Criar uma política
A partir da consola
- Vá para Políticas na barra lateral do console
- Clique em Criar política
- Digite um nome, selecione uma categoria (
MINT,VERIFYouBUNDLE_EXPORT) e escolha um status - Escreva suas regras em formato JSON ou use um modelo
- Clique em Implantar Política — se o status for
ACTIVE, ela entra em vigor imediatamente
A partir de um modelo
O console inclui quatro modelos prontos para uso que você pode adicionar com um clique:
Para usar um modelo, abra a aba Modelos na página de políticas e clique em Usar modelo. A política é criada e ativada imediatamente. Você pode editá-la posteriormente para personalizar as regras.
Via API
Definastatus como DRAFT se quiser salvar a política sem aplicá-la ainda.
Response
Listando políticas
Simulando uma política
Antes de confiar em uma política em produção, use o simulador para testar como ela avalia uma determinada entrada. No console, abra a guia Simulador na página de políticas, selecione uma política e insira uma entrada de teste. Você também pode chamar o endpoint de avaliação diretamente:Response
Se você anteriormente dependia de
evaluation_ms na resposta de avaliação para monitoramento de desempenho, esse campo foi removido da resposta da API. Ele ainda é registrado no rastro de auditoria de decisão — consulte resource_type=policy_decision no log de auditoria para recuperá-lo.default_effect:
Trilha de auditoria de decisão
Toda avaliação de política é registrada automaticamente. Cada decisão captura a versão da política, as regras correspondentes e um hash SHA-256 da entrada para evidência de adulteração. Use os registros de decisão para rastrear por que uma solicitação específica foi permitida ou negada. A resposta de avaliação inclui umdecision_id que você pode referenciar em consultas de auditoria:
evaluation_ms e input_hash:
Excluir uma política
Remova uma política da consola clicando no ícone de exclusão no cartão da política, ou através da API:Exemplo: política de múltiplas regras
Combine várias regras para expressar requisitos complexos. As regras são avaliadas em ordem — a primeira correspondência vence.Relacionado
SDK do motor de políticas
Avalie políticas programaticamente usando o SDK para integração personalizada
cenários.
Referência da API de Políticas
Crie, liste, avalie e exclua políticas via API REST.
Exportações de conformidade
Exporte dados de auditoria nos formatos SOC 2, GDPR e HIPAA para conformidade
relatórios.
Governança
Use fluxos de trabalho de governança para aprovação do emissor e alterações de status.

