Saltar para o conteúdo principal
As políticas de emissão permitem que você aplique requisitos de conformidade, jurisdição e confiança em toda a cunhagem, verificação e exportação de pacotes de prova. Quando uma política está ativa, cada solicitação correspondente é avaliada em relação às suas regras antes de prosseguir. As solicitações que não correspondem são negadas com um motivo claro.

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
Se você não criar nenhuma política, todas as solicitações de cunhagem, verificação e exportação serão permitidas por padrão.

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 — ALLOW ou DENY se as condições corresponderem
  • Efeito padrão — aplicado quando nenhuma regra corresponde
As regras são avaliadas em ordem. A primeira regra correspondente determina o resultado. Se nenhuma regra corresponder, o 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:
  1. Criar como DRAFT — escreva e refine suas regras sem afetar o tráfego ao vivo.
  2. Simular — teste a política de rascunho com entradas de amostra usando o simulador de política.
  3. Ativar — defina o status como ACTIVE para que a política seja aplicada às solicitações correspondentes.
  4. Desativar — defina o status como DISABLED para interromper temporariamente a aplicação sem perder a definição da política.
  5. Excluir — remover a política inteiramente quando não for mais necessária.
Você pode fazer a transição entre 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íticas BUNDLE_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.
Para criar esta política via API, defina 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

Para aplicar uma política como padrão em todo o locatário, defina target_type como TENANT_DEFAULT e omita target_id:
Use valores de prioridade mais altos para vinculações mais específicas. Por exemplo, atribua prioridade 100 a uma vinculação de nível de emissor e 10 ao padrão do locatário para que a política específica do emissor seja avaliada primeiro.

Criar uma política

A partir da consola

  1. Vá para Políticas na barra lateral do console
  2. Clique em Criar política
  3. Digite um nome, selecione uma categoria (MINT, VERIFY ou BUNDLE_EXPORT) e escolha um status
  4. Escreva suas regras em formato JSON ou use um modelo
  5. 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

Defina status como DRAFT se quiser salvar a política sem aplicá-la ainda.
Response

Listando políticas

Retorna um array de todas as políticas para o locatário atual.

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
A resposta inclui quatro campos:
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.
Se nenhuma regra corresponder, a resposta reflete o 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 um decision_id que você pode referenciar em consultas de auditoria:
O registro de auditoria inclui campos que não fazem parte da resposta da API de avaliação, como 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:
A exclusão de uma política entra em vigor imediatamente. Quaisquer solicitações pendentes de cunhagem ou verificação que estavam sujeitas à política não serão mais avaliadas em relação a ela.

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.
Esta política nega emissores de nível individual, independentemente da jurisdição, permite emissores dos EUA e da UE em qualquer outro nível de confiança e nega todos os outros.

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.