Tokens con un propósito específico y revocación

Mantenga los datos personales fuera de los tokens

Un ejemplo utiliza tokens opacos impredecibles con alcance y vencimiento del lado del servidor. Exija la autenticación del destinatario además del token para limitar el impacto del robo.

token_hash

Un valor de búsqueda para tokens coincidentes. Mantenga los tokens sin procesar fuera de los registros y de las pantallas de administración ordinarias.

audience

El destinatario autorizado. Rechazar el uso por parte de un socio de integración diferente.

scope / purpose

Datos permitidos y finalidad. No opte por defecto por autorizaciones amplias.

resource_ref

El pedido o registro de entrega. Impedir su uso para otro registro.

expires_at / remaining_uses

Límite de caducidad y uso. Rechazar tokens caducados y consumidos en el lado del servidor.

Uso único y respuestas perdidas

El ID referencia una dirección; el token limita la recuperación a un pedido, aplicación y campos. Protege ambos. Un token de un solo uso se consume tras una recuperación correcta; no se garantiza repetir la respuesta. Si se pierde, comprueba el estado antes de emitir otro.

Caducidad, revocación y cambios

Registre otra dirección; no se modifica la existente. Consulte el vínculo actual, pase su Version como expectedVersion, cambie el pedido y emita un token para la nueva versión. El cambio bloquea todos los tokens de versiones anteriores. Emitir otro en la misma versión no revoca los anteriores. Compruebe otros pedidos y la retención antes de borrar la dirección antigua. El texto ya recibido no puede recuperarse.

Transiciones de estado

activo → consumido / caducado / revocado. Nunca reactive un estado revocado.

Almacenamiento en caché

Limitar el retraso de revocación. Las operaciones de alto riesgo deben verificar el estado autorizado.

Límites

La revocación no puede recuperar datos personales ya recuperados por un socio.

DATA / INTEGRATION EXAMPLE

Ejemplo de datos e integración

Estos ejemplos explican el diseño. Los nombres y valores de los campos son ilustrativos, no una referencia de API ejecutable.

{
  "operation": "Delivery token issuance example",
  "request": {
    "proxy_id": "nym_example_01",
    "resource_ref": "order_example_01",
    "audience": "carrier-a",
    "scope": [
      "shipping.address.read"
    ],
    "expires_in_seconds": 600,
    "max_uses": 1
  },
  "response": {
    "token": "tok_example_not_a_real_token",
    "expires_in_seconds": 600
  }
}

600 segundos y un uso son ejemplos. Un JWT firmado por sí solo no garantiza la revocación anticipada o el uso único; Se necesita una gestión estatal adicional.

Diseños técnicos relacionados

Integración diseñada para sus flujos de trabajo.

Mapee los datos retenidos, los socios y las acciones requeridas para identificar formas de reducir la exposición.