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

# Descoberta de DID e JWKS

> Resolver identidades de emissores e chaves públicas usando protocolos de descoberta padrão.

Truthlocks fornece endpoints públicos para resolver identidades de emissores usando Identificadores Descentralizados (DIDs) do W3C e recuperar chaves de assinatura via JSON Web Key Sets (JWKS). Esses endpoints permitem a verificação de chaves baseada em padrões sem integrações proprietárias.

## Resolução DID

Todo emissor tem um DID no formato `did:truthlock:{issuer_id}` que se resolve para um Documento DID W3C contendo seu material de chave pública e endpoints de serviço. Os DIDs são atribuídos automaticamente quando um emissor é criado.

### Endpoint

```text theme={null}
GET /v1/public/did/{did}
```

Nenhuma autenticação necessária. As respostas são armazenadas em cache por 1 hora.

### Exemplo de solicitação

```bash theme={null}
curl https://api.truthlocks.com/v1/public/did/did:truthlock:iss_p4q5r6
```

### Exemplo de resposta

```json theme={null}
{
  "@context": [
    "https://www.w3.org/ns/did/v1",
    "https://w3id.org/security/suites/jws-2020/v1"
  ],
  "id": "did:truthlock:iss_p4q5r6",
  "controller": "did:truthlock:iss_p4q5r6",
  "verificationMethod": [
    {
      "id": "did:truthlock:iss_p4q5r6#key-1",
      "type": "Ed25519VerificationKey2020",
      "controller": "did:truthlock:iss_p4q5r6",
      "publicKeyJwk": {
        "kty": "OKP",
        "crv": "Ed25519",
        "x": "base64url-encoded-public-key",
        "kid": "key-1",
        "alg": "ed25519"
      }
    }
  ],
  "authentication": ["did:truthlock:iss_p4q5r6#key-1"],
  "assertionMethod": ["did:truthlock:iss_p4q5r6#key-1"],
  "service": [
    {
      "id": "did:truthlock:iss_p4q5r6#verification",
      "type": "TruthlockVerification",
      "serviceEndpoint": "https://api.truthlocks.com/v1/verify"
    },
    {
      "id": "did:truthlock:iss_p4q5r6#portfolio",
      "type": "TruthlockPortfolio",
      "serviceEndpoint": "https://verify.truthlocks.com/portfolio"
    }
  ]
}
```

A resposta usa `Content-Type: application/did+json`.

### Tipos de método de verificação

O tipo de chave no Documento DID depende do algoritmo de assinatura do emissor:

| Algoritmo | Tipo de verificação | Tipo de chave JWK | Curva |
| - | - | - | - |
| Ed25519 | `Ed25519VerificationKey2020` | `OKP` | `Ed25519` |
| ES256 | `JsonWebKey2020` | `EC` | `P-256` |
| RS256 | `JsonWebKey2020` | `RSA` | — |

## Endpoint JWKS

Recupere todas as chaves públicas ativas para um emissor como um conjunto de chaves da Web JSON padrão.

### Endpoint

```text theme={null}
GET /v1/public/issuers/{issuer_id}/jwks.json
```

Nenhuma autenticação necessária. As respostas são armazenadas em cache por 1 hora.

### Exemplo de solicitação

```bash theme={null}
curl https://api.truthlocks.com/v1/public/issuers/iss_p4q5r6/jwks.json
```

### Exemplo de resposta

```json theme={null}
{
  "keys": [
    {
      "kty": "OKP",
      "crv": "Ed25519",
      "x": "base64url-encoded-public-key",
      "kid": "key-1",
      "alg": "ed25519"
    }
  ]
}
```

## Quando usar cada endpoint

| Caso de uso | Endpoint |
| - | - |
| Verificar um pacote de prova offline usando o campo `issuer_did` | Resolução DID |
| Validar assinaturas JWT dos serviços Truthlocks | JWKS |
| Construir integrações que sigam os padrões de Credenciais Verificáveis do W3C | Resolução DID |
| Integrar com a infraestrutura OIDC/JWT existente | JWKS |

## Usando DIDs em pacotes de prova

O campo `issuer_certificate.issuer_did` em um [pacote de prova](https://docs.truthlocks.com/pt/specification/proof-bundle.md) contém o DID do emissor. Você pode resolvê-lo para recuperar a chave pública e verificar independentemente a assinatura do atestado sem depender da infraestrutura Truthlocks.

## Relacionado

* [Formato do pacote de prova](https://docs.truthlocks.com/pt/specification/proof-bundle.md) — O formato de prova criptográfica que referencia DIDs de emissor.
* [API de chaves de emissor](https://docs.truthlocks.com/pt/api-reference/issuers/keys.md) — Gerenciar chaves de assinatura de emissor.


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