> ## 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.

# Políticas de emisión

> Defina políticas basadas en reglas que controlen quién puede acuñar, verificar y exportar atestaciones en su inquilino.

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`.

```json theme={null}
{
  "rules": [
    {
      "id": "us_only",
      "description": "US jurisdiction required",
      "conditions": [
        { "field": "jurisdiction", "op": "eq", "value": "US" }
      ],
      "effect": "ALLOW"
    }
  ],
  "default_effect": "DENY"
}
```

### Operadores de condición

| Operador | Descripción | Ejemplo |
| - | - | - |
| `eq` | Es igual a | `{ "field": "jurisdiction", "op": "eq", "value": "US" }` |
| `neq` | No es igual a | `{ "field": "trust_tier", "op": "neq", "value": "individual" }` |
| `in` | Coincide con cualquier valor de una lista | `{ "field": "trust_tier", "op": "in", "value": ["verified_org", "enterprise"] }` |
| `nin` | No coincide con ningún valor de una lista | `{ "field": "jurisdiction", "op": "nin", "value": ["CN", "RU"] }` |
| `gt` | Mayor que (numérico) | `{ "field": "key.age_days", "op": "gt", "value": 90 }` |
| `lt` | Menor que (numérico) | `{ "field": "key.age_days", "op": "lt", "value": 365 }` |
| `exists` | El campo está presente | `{ "field": "jurisdiction", "op": "exists", "value": true }` |

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:

| Campo | Descripción |
| - | - |
| `jurisdiction` | La jurisdicción registrada del emisor (código de país ISO) |
| `trust_tier` | El nivel de confianza del emisor (`individual`, `verified_org`, `regulated_issuer`, `enterprise`) |
| `status` | El estado actual del emisor (`ACTIVE`, `suspended`, `revoked`, `SUNSET`, `pending`) |
| `risk_rating` | La calificación de riesgo del emisor (`low`, `medium`, `high`, `CRITICAL`) |
| `assurance_level` | El nivel de garantía del emisor (`standard`, `high`, `regulated`) |
| `key.age_days` | Antigüedad de la clave de firma en días |
| `key.status` | Estado de la clave de firma (`ACTIVE`, `REVOKED`, `EXPIRED`) |
| `key.kid` | Identificador de la clave de firma |

## Ciclo de vida de la política

Cada política tiene un estado que controla si se aplica:

| Estado | Comportamiento |
| - | - |
| `DRAFT` | Guardado pero no aplicado — úselo mientras itera en las reglas |
| `ACTIVE` | Aplicado en cada solicitud coincidente |
| `DISABLED` | Desactivada temporalmente sin eliminar la política |

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](#simulating-a-policy).
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.

> [!NOTE]
>
> 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:

| Categoría | Se aplica a |
| - | - |
| `MINT` | Solicitudes de acuñación de atestaciones |
| `VERIFY` | Solicitudes de verificación |
| `BUNDLE_EXPORT` | Solicitudes de exportación de paquetes de prueba y portabilidad de datos |

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.

```json theme={null}
{
  "rules": [
    {
      "id": "block_non_enterprise",
      "description": "Only enterprise-tier issuers can export bundles",
      "conditions": [
        { "field": "trust_tier", "op": "nin", "value": ["enterprise", "regulated_issuer"] }
      ],
      "effect": "DENY"
    },
    {
      "id": "allow_low_risk",
      "description": "Allow exports for low-risk issuers",
      "conditions": [
        { "field": "risk_rating", "op": "eq", "value": "low" }
      ],
      "effect": "ALLOW"
    }
  ],
  "default_effect": "DENY"
}
```

Para crear esta política a través de la API, establezca `category` en `BUNDLE_EXPORT`:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Enterprise Export Only",
    "category": "BUNDLE_EXPORT",
    "status": "ACTIVE",
    "description": "Restrict proof-bundle exports to enterprise issuers with low risk",
    "language": "json_rules",
    "rules": {
      "rules": [
        {
          "id": "block_non_enterprise",
          "description": "Only enterprise-tier issuers can export bundles",
          "conditions": [
            { "field": "trust_tier", "op": "nin", "value": ["enterprise", "regulated_issuer"] }
          ],
          "effect": "DENY"
        }
      ],
      "default_effect": "ALLOW"
    }
  }'
```

### 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:

| Campo | Tipo | Descripción |
| - | - | - |
| `policy_id` | string | El ID de la política a vincular |
| `target_type` | string | `ISSUER`, `VERIFICATION_PROFILE`, o `TENANT_DEFAULT` |
| `target_id` | string | UUID del objetivo. Omita para `TENANT_DEFAULT` para aplicar la política a todas las entidades. |
| `action` | string | `MINT`, `VERIFY`, o `BUNDLE_EXPORT` |
| `priority` | integer | Las vinculaciones de mayor prioridad se evalúan primero |

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

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies/bindings \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "policy_id": "pol_abc123",
    "target_type": "ISSUER",
    "target_id": "iss_def456",
    "action": "MINT",
    "priority": 100
  }'
```

Para aplicar una política como predeterminada para todo el inquilino, establezca `target_type` en `TENANT_DEFAULT` y omita `target_id`:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies/bindings \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "policy_id": "pol_abc123",
    "target_type": "TENANT_DEFAULT",
    "action": "MINT",
    "priority": 10
  }'
```

> [!TIP]
>
> 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:

| Plantilla | Categoría | Descripción |
| - | - | - |
| Permitir jurisdicción de EE. UU. | MINT | Solo permitir la acuñación de emisores con sede en EE. UU. |
| Solo organización verificada | MINT | Requiere un nivel de confianza `verified_org` o superior |
| Permitir todo (Permisivo) | MINT | Permitir todas las acuñaciones — usar con precaución |
| Verificar - Solo EE. UU. y UE | VERIFICAR | Solo aceptar verificaciones de jurisdicciones de EE. UU. o la UE |

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.

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "US Issuers Only",
    "category": "MINT",
    "status": "ACTIVE",
    "description": "Restrict minting to US-based issuers",
    "language": "json_rules",
    "rules": {
      "rules": [
        {
          "id": "us_only",
          "description": "US jurisdiction required",
          "conditions": [
            { "field": "jurisdiction", "op": "eq", "value": "US" }
          ],
          "effect": "ALLOW"
        }
      ],
      "default_effect": "DENY"
    }
  }'
```

```json Response theme={null}
{
  "id": "pol_abc123",
  "name": "US Issuers Only",
  "category": "MINT",
  "status": "ACTIVE",
  "description": "Restrict minting to US-based issuers",
  "rules": { "..." },
  "version": 1,
  "created_at": "2026-03-31T10:00:00Z"
}
```

## Listado de políticas

```bash theme={null}
curl https://api.truthlocks.com/v1/policies \
  -H "X-API-Key: tl_live_..."
```

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:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies/evaluate \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "action": "MINT",
    "target_type": "ISSUER",
    "input": {
      "jurisdiction": "US",
      "trust_tier": "ENTERPRISE"
    }
  }'
```

```json Response theme={null}
{
  "allowed": true,
  "matched_rules": ["us_only"],
  "reasons": [],
  "decision_id": "dec_7f3a1b"
}
```

La respuesta incluye cuatro campos:

| Campo | Tipo | Descripción |
| - | - | - |
| `allowed` | boolean | Si la solicitud pasó todas las políticas activas |
| `matched_rules` | string\[] | IDs de las reglas que coincidieron con la entrada. Vacío cuando ninguna regla coincidió y se aplicó el efecto predeterminado. |
| `reasons` | string\[] | Explicación legible por humanos cuando se deniega una solicitud. Siempre un array vacío cuando `allowed` es `true`. |
| `decision_id` | string | Identificador único para esta evaluación — úselo para buscar el registro de decisión completo en la [pista de auditoría](https://docs.truthlocks.com/es/security/audit.md#policy-decision-audit-trail). |

> [!NOTE]
>
> 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](#decision-audit-trail) — consulte `resource_type=policy_decision` en el [registro de auditoría](https://docs.truthlocks.com/es/security/audit.md#policy-decision-audit-trail) para recuperarlo.

Si ninguna regla coincide, la respuesta refleja el `default_effect`:

```json theme={null}
{
  "allowed": false,
  "matched_rules": [],
  "reasons": ["Default policy effect: DENY"],
  "decision_id": "dec_9c2d4e"
}
```

## 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:

```bash theme={null}
curl "https://api.truthlocks.com/v1/audit/events?resource_type=policy_decision&resource_id=dec_7f3a1b" \
  -H "X-API-Key: tl_live_..."
```

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`:

| Campo de decisión | Descripción |
| - | - |
| `decision_id` | Identificador único para esta evaluación |
| `policy_id` | La política que fue evaluada |
| `policy_version` | Versión de la política en el momento de la evaluación |
| `allowed` | Si se permitió la solicitud |
| `matched_rules` | IDs de reglas que coincidieron con la entrada |
| `evaluation_ms` | Tiempo empleado en la evaluación, en milisegundos (solo pista de auditoría) |
| `input_hash` | Hash SHA-256 de la entrada de evaluación |

## 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:

```bash theme={null}
curl -X DELETE https://api.truthlocks.com/v1/policies/{id} \
  -H "X-API-Key: tl_live_..."
```

> [!WARNING]
>
> 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.

```json theme={null}
{
  "rules": [
    {
      "id": "block_individual",
      "description": "Block individual-tier issuers",
      "conditions": [
        { "field": "trust_tier", "op": "eq", "value": "individual" }
      ],
      "effect": "DENY"
    },
    {
      "id": "allow_us_eu",
      "description": "Allow US or EU jurisdictions",
      "conditions": [
        { "field": "jurisdiction", "op": "in", "value": ["US", "EU"] }
      ],
      "effect": "ALLOW"
    }
  ],
  "default_effect": "DENY"
}
```

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

> [card] [SDK del motor de políticas](https://docs.truthlocks.com/policy.md)
>
> Evalúe políticas programáticamente usando el SDK para integración personalizada
> escenarios.

> [card] [Referencia de la API de políticas](https://docs.truthlocks.com/api-reference/policies/create.md)
>
> Cree, liste, evalúe y elimine políticas a través de la API REST.

> [card] [Exportaciones de cumplimiento](https://docs.truthlocks.com/guides/compliance-exports.md)
>
> Exporte datos de auditoría en formatos SOC 2, GDPR y HIPAA para cumplimiento
> informes.

> [card] [Gobernanza](https://docs.truthlocks.com/api-reference/governance/list-requests.md)
>
> Utilice flujos de trabajo de gobernanza para la aprobación del emisor y los cambios de estado.


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