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

# Découverte DID et JWKS

> Résoudre les identités d'émetteurs et les clés publiques à l'aide de protocoles de découverte standard.

Truthlocks fournit des points de terminaison publics pour résoudre les identités des émetteurs à l'aide des identifiants décentralisés (DID) du W3C et récupérer les clés de signature via les ensembles de clés Web JSON (JWKS). Ces points de terminaison permettent une vérification des clés basée sur les normes sans intégrations propriétaires.

## Résolution DID

Chaque émetteur a un DID au format `did:truthlock:{issuer_id}` qui se résout en un document DID W3C contenant ses clés publiques et ses points de terminaison de service. Les DID sont automatiquement attribués lors de la création d'un émetteur.

### Point de terminaison

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

Aucune authentification requise. Les réponses sont mises en cache pendant 1 heure.

### Exemple de requête

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

### Exemple de réponse

```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 réponse utilise `Content-Type: application/did+json`.

### Types de méthodes de vérification

Le type de clé dans le document DID dépend de l'algorithme de signature de l'émetteur :

| Algorithme | Type de vérification | Type de clé JWK | Courbe |
| - | - | - | - |
| Ed25519 | `Ed25519VerificationKey2020` | `OKP` | `Ed25519` |
| ES256 | `JsonWebKey2020` | `EC` | `P-256` |
| RS256 | `JsonWebKey2020` | `RSA` | — |

## Point de terminaison JWKS

Récupère toutes les clés publiques actives pour un émetteur sous forme de JSON Web Key Set standard.

### Point de terminaison

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

Aucune authentification requise. Les réponses sont mises en cache pendant 1 heure.

### Exemple de requête

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

### Exemple de réponse

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

## Quand utiliser chaque point de terminaison

| Cas d'utilisation | Point de terminaison |
| - | - |
| Vérifier un paquet de preuves hors ligne en utilisant le champ `issuer_did` | Résolution DID |
| Valider les signatures JWT des services Truthlocks | JWKS |
| Créer des intégrations conformes aux normes W3C Verifiable Credentials | Résolution DID |
| Intégration avec l'infrastructure OIDC/JWT existante | JWKS |

## Utilisation des DID dans les paquets de preuves

Le champ `issuer_certificate.issuer_did` dans un [paquet de preuves](https://docs.truthlocks.com/fr/specification/proof-bundle.md) contient le DID de l'émetteur. Vous pouvez le résoudre pour récupérer la clé publique et vérifier indépendamment la signature de l'attestation sans dépendre de l'infrastructure Truthlocks.

## Lié

* [Format du paquet de preuve](https://docs.truthlocks.com/fr/specification/proof-bundle.md) — Le format de preuve cryptographique qui référence les DID de l'émetteur.
* [API des clés d'émetteur](https://docs.truthlocks.com/fr/api-reference/issuers/keys.md) — Gérez les clés de signature de l'émetteur.


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