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

# اكتشاف DID و JWKS

> حل هويات المصدر والمفاتيح العامة باستخدام بروتوكولات الاكتشاف القياسية.

توفر Truthlocks نقاط نهاية عامة لحل هويات المُصدرين باستخدام معرفات W3C اللامركزية (DIDs) واسترداد مفاتيح التوقيع عبر مجموعات مفاتيح الويب JSON (JWKS). تتيح نقاط النهاية هذه التحقق من المفاتيح القائم على المعايير دون تكاملات خاصة.

## حل المعرفات اللامركزية (DID)

لكل جهة إصدار DID بالتنسيق `did:truthlock:{issuer_id}` الذي يحل إلى مستند W3C DID يحتوي على مواد مفتاحها العام ونقاط نهاية الخدمة. يتم تعيين DIDs تلقائيًا عند إنشاء جهة إصدار.

### نقطة النهاية

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

لا يلزم المصادقة. يتم تخزين الردود مؤقتًا لمدة ساعة واحدة.

### طلب مثال

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

### استجابة مثال

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

تستخدم الاستجابة `Content-Type: application/did+json`.

### أنواع طرق التحقق

يعتمد نوع المفتاح في مستند DID على خوارزمية توقيع المصدر:

| الخوارزمية | نوع التحقق | نوع مفتاح JWK | المنحنى |
| - | - | - | - |
| Ed25519 | `Ed25519VerificationKey2020` | `OKP` | `Ed25519` |
| ES256 | `JsonWebKey2020` | `EC` | `P-256` |
| RS256 | `JsonWebKey2020` | `RSA` | — |

## نقطة نهاية JWKS

استرداد جميع المفاتيح العامة النشطة لمصدر كمجموعة مفاتيح ويب JSON قياسية.

### نقطة النهاية

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

لا يلزم المصادقة. يتم تخزين الردود مؤقتًا لمدة ساعة واحدة.

### طلب مثال

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

### استجابة مثال

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

## متى تستخدم كل نقطة نهاية

| حالة الاستخدام | نقطة النهاية |
| - | - |
| التحقق من حزمة إثبات دون اتصال باستخدام حقل `issuer_did` | حل DID |
| التحقق من توقيعات JWT من خدمات Truthlocks | JWKS |
| بناء تكاملات تتبع معايير W3C للوثائق الاعتمادية القابلة للتحقق | حل DID |
| التكامل مع البنية التحتية الحالية لـ OIDC/JWT | JWKS |

## استخدام المعرفات اللامركزية (DIDs) في حزم الإثبات

يحتوي الحقل `issuer_certificate.issuer_did` في [حزمة إثبات](https://docs.truthlocks.com/ar/specification/proof-bundle.md) على معرف DID للمصدر. يمكنك حله لاسترداد المفتاح العام والتحقق بشكل مستقل من توقيع الشهادة دون الاعتماد على بنية Truthlocks التحتية.

## ذات صلة

* [تنسيق حزمة الإثبات](https://docs.truthlocks.com/ar/specification/proof-bundle.md) — تنسيق الإثبات التشفيري الذي يشير إلى DIDs للمُصدر.
* [مفاتيح المُصدر API](https://docs.truthlocks.com/ar/api-reference/issuers/keys.md) — إدارة مفاتيح توقيع المُصدر.


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