Saltar al contenido principal
Las políticas de emisión le permiten hacer cumplir los requisitos de cumplimiento, jurisdicción y confianza en la acuñación, verificación y exportación de paquetes de prueba. Cuando una política está activa, cada solicitud coincidente se evalúa según sus reglas antes de que proceda. Las solicitudes que no coinciden se deniegan con una razón clara.

Cuándo usar políticas

Utilice políticas de emisión cuando necesite:
  • Restringir la acuñación a emisores en jurisdicciones específicas (por ejemplo, solo EE. UU. o EE. UU. y la UE)
  • Requerir un nivel de confianza mínimo antes de que un emisor pueda crear atestaciones
  • Aplicar diferentes reglas para la acuñación vs. la verificación
  • Controlar quién puede exportar paquetes de prueba o enviar solicitudes de portabilidad de datos
  • Probar una política con entradas de muestra antes de implementarla en producción
  • Auditar qué política estaba vigente cuando se creó una atestación
Si no crea ninguna política, todas las solicitudes de acuñación, verificación y exportación se permiten de forma predeterminada.

Cómo funcionan las políticas

Cada política contiene una o más reglas. Una regla tiene:
  • Condiciones — comprobaciones a nivel de campo evaluadas contra el contexto de la solicitud (por ejemplo, jurisdiction eq US)
  • Efecto — ALLOW o DENY si las condiciones coinciden
  • Efecto predeterminado — aplicado cuando ninguna regla coincide
Las reglas se evalúan en orden. La primera regla que coincide determina el resultado. Si ninguna regla coincide, se aplica el default_effect.

Operadores de condición

Las condiciones admiten la notación de puntos para campos anidados (por ejemplo, key.age_days, key.status).

Campos disponibles

Se puede hacer referencia a cualquier campo en la entrada de evaluación, incluidos los campos anidados con notación de puntos. Los siguientes campos están disponibles por defecto:

Ciclo de vida de la política

Cada política tiene un estado que controla si se aplica: Cuando crea una política, elige el estado inicial. Solo las políticas ACTIVE se evalúan en el momento de la solicitud.

Transiciones del ciclo de vida

Las políticas suelen seguir esta progresión:
  1. Crear como DRAFT: escriba y refine sus reglas sin afectar el tráfico en vivo.
  2. Simular: pruebe la política preliminar con entradas de muestra utilizando el simulador de políticas.
  3. Activar — establezca el estado en ACTIVE para que la política se aplique a las solicitudes coincidentes.
  4. Deshabilitar — establezca el estado en DISABLED para detener temporalmente la aplicación sin perder la definición de la política.
  5. Eliminar — elimine la política por completo cuando ya no sea necesaria.
Puede realizar la transición entre DRAFT, ACTIVE y DISABLED en cualquier momento actualizando la política. Cada cambio de estado incrementa la versión de la política, que se registra junto con cada decisión de evaluación para fines de auditoría.
La transición de una política a ACTIVE surte efecto inmediatamente. Asegúrese de haber probado las reglas con el simulador antes de activarlas.

Categorías de políticas

Las políticas tienen un alcance para una acción específica: Puede tener varias políticas activas. Cada política se aplica solo a su categoría.

Políticas de control de exportaciones

Las políticas de BUNDLE_EXPORT controlan quién puede exportar paquetes de prueba y enviar solicitudes de portabilidad de datos. Úselas para restringir las exportaciones por jurisdicción, nivel de confianza o cualquier otro campo en la entrada de evaluación.
Para crear esta política a través de la API, establezca category en BUNDLE_EXPORT:

Enlaces de políticas

Las vinculaciones de políticas conectan una política a un objetivo específico para que el motor sepa cuándo aplicarla. Cada vinculación incluye: Cuando múltiples enlaces coinciden con una solicitud, se evalúan en orden de prioridad descendente. El primer resultado de DENY detiene la evaluación inmediatamente.

Creación de un enlace a través de la API

Para aplicar una política como predeterminada para todo el inquilino, establezca target_type en TENANT_DEFAULT y omita target_id:
Utilice valores de prioridad más altos para enlaces más específicos. Por ejemplo, asigne la prioridad 100 a un enlace de nivel de emisor y 10 al valor predeterminado del inquilino para que la política específica del emisor se evalúe primero.

Creación de una política

Desde la consola

  1. Vaya a Políticas en la barra lateral de la consola.
  2. Haga clic en Crear política.
  3. Ingrese un nombre, seleccione una categoría (MINT, VERIFY o BUNDLE_EXPORT) y elija un estado
  4. Escriba sus reglas en formato JSON o use una plantilla
  5. Haga clic en Implementar política — si el estado es ACTIVE, surte efecto inmediatamente

Desde una plantilla

La consola incluye cuatro plantillas listas para usar que puede agregar con un solo clic: Para usar una plantilla, abra la pestaña Plantillas en la página de políticas y haga clic en Usar plantilla. La política se crea y activa inmediatamente. Puede editarla después para personalizar las reglas.

A través de la API

Establezca status en DRAFT si desea guardar la política sin aplicarla todavía.
Response

Listado de políticas

Devuelve una matriz de todas las políticas para el inquilino actual.

Simulación de una política

Antes de confiar en una política en producción, use el simulador para probar cómo evalúa una entrada dada. En la consola, abra la pestaña Simulador en la página de políticas, seleccione una política e ingrese una entrada de prueba. También puede llamar directamente al punto final de evaluación:
Response
La respuesta incluye cuatro campos:
Si anteriormente dependía de evaluation_ms en la respuesta de evaluación para el monitoreo del rendimiento, ese campo ha sido eliminado de la respuesta de la API. Todavía se registra en la pista de auditoría de decisiones — consulte resource_type=policy_decision en el registro de auditoría para recuperarlo.
Si ninguna regla coincide, la respuesta refleja el default_effect:

Pista de auditoría de decisiones

Cada evaluación de política se registra automáticamente. Cada decisión captura la versión de la política, las reglas coincidentes y un hash SHA-256 de la entrada para evidencia de manipulación. Utilice los registros de decisión para rastrear por qué se permitió o denegó una solicitud específica. La respuesta de evaluación incluye un decision_id que puede referenciar en las consultas de auditoría:
El registro de auditoría incluye campos que no forman parte de la respuesta de la API de evaluación, como evaluation_ms y input_hash:

Eliminación de una política

Elimine una política de la consola haciendo clic en el icono de eliminar en la tarjeta de la política, o a través de la API:
La eliminación de una política surte efecto inmediatamente. Cualquier solicitud pendiente de acuñación o verificación que estuviera sujeta a la política ya no se evaluará con ella.

Ejemplo: política de múltiples reglas

Combine múltiples reglas para expresar requisitos complejos. Las reglas se evalúan en orden — la primera coincidencia gana.
Esta política deniega a los emisores de nivel individual independientemente de la jurisdicción, permite a los emisores de EE. UU. y la UE en cualquier otro nivel de confianza y deniega a todos los demás.

Relacionado

SDK del motor de políticas

Evalúe políticas programáticamente usando el SDK para integración personalizada escenarios.

Referencia de la API de políticas

Cree, liste, evalúe y elimine políticas a través de la API REST.

Exportaciones de cumplimiento

Exporte datos de auditoría en formatos SOC 2, GDPR y HIPAA para cumplimiento informes.

Gobernanza

Utilice flujos de trabajo de gobernanza para la aprobación del emisor y los cambios de estado.