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

# Descubrimiento de DID y JWKS

> Resolver identidades de emisores y claves públicas utilizando protocolos de descubrimiento estándar.

Truthlocks proporciona endpoints públicos para resolver identidades de emisores utilizando Identificadores Descentralizados (DIDs) de W3C y recuperar claves de firma a través de JSON Web Key Sets (JWKS). Estos endpoints permiten la verificación de claves basada en estándares sin integraciones propietarias.

## Resolución DID

Cada emisor tiene un DID en el formato `did:truthlock:{issuer_id}` que se resuelve en un Documento DID de W3C que contiene su material de clave pública y endpoints de servicio. Los DID se asignan automáticamente cuando se crea un emisor.

### Punto final

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

No se requiere autenticación. Las respuestas se almacenan en caché durante 1 hora.

### Solicitud de ejemplo

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

### Respuesta de ejemplo

```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"
    }
  ]
}
```

La respuesta utiliza `Content-Type: application/did+json`.

### Tipos de métodos de verificación

El tipo de clave en el Documento DID depende del algoritmo de firma del emisor:

| Algoritmo | Tipo de verificación | Tipo de clave JWK | Curva |
| - | - | - | - |
| Ed25519 | `Ed25519VerificationKey2020` | `OKP` | `Ed25519` |
| ES256 | `JsonWebKey2020` | `EC` | `P-256` |
| RS256 | `JsonWebKey2020` | `RSA` | — |

## Punto de conexión JWKS

Recuperar todas las claves públicas activas para un emisor como un conjunto de claves web JSON estándar.

### Punto final

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

No se requiere autenticación. Las respuestas se almacenan en caché durante 1 hora.

### Solicitud de ejemplo

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

### Respuesta de ejemplo

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

## Cuándo usar cada endpoint

| Caso de uso | Punto final |
| - | - |
| Verificar un paquete de prueba sin conexión usando el campo `issuer_did` | Resolución DID |
| Validar firmas JWT de los servicios de Truthlocks | JWKS |
| Crear integraciones que sigan los estándares de credenciales verificables de W3C | Resolución DID |
| Integrar con la infraestructura OIDC/JWT existente | JWKS |

## Uso de DIDs en paquetes de prueba

El campo `issuer_certificate.issuer_did` en un [paquete de prueba](https://docs.truthlocks.com/es/specification/proof-bundle.md) contiene el DID del emisor. Puede resolverlo para recuperar la clave pública y verificar independientemente la firma de la atestación sin depender de la infraestructura de Truthlocks.

## Relacionado

* [Formato de paquete de prueba](https://docs.truthlocks.com/es/specification/proof-bundle.md) — El formato de prueba criptográfica que hace referencia a los DID del emisor.
* [API de claves de emisor](https://docs.truthlocks.com/es/api-reference/issuers/keys.md) — Administre las claves de firma del emisor.


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