Tokens por finalidade e revogação

Não inclua dados pessoais nos tokens

Um exemplo usa tokens opacos imprevisíveis, com escopo e validade no servidor. Exija também a autenticação do destinatário para limitar o impacto de um roubo.

token_hash

Valor de consulta para comparar tokens. Não mantenha tokens brutos em logs ou telas administrativas comuns.

audience

O destinatário autorizado. Rejeite o uso por outro parceiro de integração.

scope / purpose

Dados e finalidades permitidos. Não conceda autorizações amplas por padrão.

resource_ref

O registro do pedido ou da entrega. Impeça o uso para outro registro.

expires_at / remaining_uses

Validade e limite de uso. Rejeite tokens expirados e consumidos no servidor.

Uso único e respostas perdidas

O ID referencia um endereço. O token acrescenta condições para pedido, aplicativo e campos específicos. Proteja ambos. O token de uso único é consumido na recuperação bem-sucedida; repetir a mesma resposta não é garantido. Se a resposta se perder, confira o estado antes de emitir outro.

Expiração, revogação e alterações

Cadastre outro endereço em vez de editar o existente. Consulte o vínculo, passe sua Version como expectedVersion, altere o pedido e emita um token para a nova versão. A mudança bloqueia todos os tokens das versões anteriores. Emitir mais tokens na mesma versão não revoga os existentes. Verifique outros pedidos e a retenção antes de excluir o endereço antigo. Texto já entregue não pode ser recolhido.

Transições de estado

active → consumed / expired / revoked. Nunca reative um estado revogado.

Cache

Limite atrasos na revogação. Operações de alto risco devem verificar o estado na fonte oficial.

Limites

A revogação não recupera dados pessoais já consultados por um parceiro.

DATA / INTEGRATION EXAMPLE

Exemplo de dados e integração

Estes exemplos explicam o projeto. Nomes de campos e valores são ilustrativos, não uma referência executável de API.

{
  "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 e um uso são exemplos. Um JWT assinado sozinho não garante revogação antecipada nem uso único; é necessária gestão de estado adicional.

Projetos técnicos relacionados

Integração projetada para seus processos.

Mapeie dados retidos, parceiros e ações necessárias para identificar formas de reduzir a exposição.