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

# التحكم في الوصول المستند إلى الدور (RBAC) والأذونات

> التحكم في الوصول المستند إلى الدور وإدارة الأذونات.

تطبق Truthlocks التحكم في الوصول المستند إلى الأدوار (RBAC) لإدارة من يمكنه تنفيذ أي إجراءات. يشرح هذا الدليل نموذج الأذونات.

## نموذج الأذونات

يتكون نموذج أذونات Truthlocks من ثلاث طبقات:

**1. الأذونات**

إجراءات ذرية مثل `attestations:mint` أو `users:read`. هذه هي
وحدات البناء.

**2. الأدوار**

مجموعات من الأذونات مجمعة حسب الوظيفة. أدوار مثل `admin`،
`issuer`، أو `viewer`.

**3. التعيينات**

ربط المستخدمين أو مفاتيح API بالأدوار. يمكن للمستخدم أن يكون له أدوار متعددة.

## الأذونات المتاحة

### أذونات التصديق

| الإذن | الوصف |
| - | - |
| `attestations:mint` | إنشاء إشهادات جديدة |
| `attestations:read` | عرض تفاصيل الإشهاد وتنزيل حزم الإثبات |
| `attestations:revoke` | إلغاء التصديقات الموجودة |
| `attestations:*` | جميع أذونات التصديق |

### أذونات المصدر

| الإذن | الوصف |
| - | - |
| `issuers:read` | عرض معلومات المصدر والمفاتيح |
| `issuers:write` | إنشاء جهات إصدار، تسجيل المفاتيح |
| `issuers:*` | جميع أذونات المُصدر |

### أذونات إدارة المستخدمين

| الإذن | الوصف |
| - | - |
| `users:read` | عرض المستخدمين وتعيينات الأدوار |
| `users:write` | دعوة المستخدمين، تعيين الأدوار، إزالة المستخدمين |
| `api-keys:read` | عرض مفاتيح API (بدون الأسرار) |
| `api-keys:write` | إنشاء مفاتيح API وإلغاؤها |

### أذونات إدارية

| الإذن | الوصف |
| - | - |
| `audit:read` | سجلات تدقيق الاستعلام |
| `governance:approve` | الموافقة على طلبات الحوكمة |
| `governance:suspend` | تعليق المصدرين النشطين |
| `*` | مسؤول فائق: جميع الأذونات |

### أذونات Webhook

| الإذن | الوصف |
| - | - |
| `webhooks:read` | عرض نقاط نهاية webhook وسجلات التسليم |
| `webhooks:write` | إنشاء وتحديث وحذف نقاط النهاية |
| `webhooks:*` | جميع أذونات الويب هوك |

### أذونات الحوكمة

| الإذن | الوصف |
| - | - |
| `governance:read` | عرض طلبات الحوكمة |
| `governance:approve` | الموافقة على طلبات الحوكمة |
| `governance:suspend` | تعليق المصدرين النشطين |
| `governance:*` | جميع أذونات الحوكمة |

### أذونات الإعدادات

| الإذن | الوصف |
| - | - |
| `settings:read` | عرض إعدادات المستأجر والمنظمة |
| `settings:write` | تحديث العلامة التجارية، النطاقات، البريد الإلكتروني، والإعدادات الأخرى |
| `settings:*` | جميع أذونات الإعدادات |

## أدوار النظام

تقوم Truthlocks بتوفير مجموعة من أدوار النظام تلقائيًا عند إنشاء المستأجر الخاص بك. لا يمكن تعديل أدوار النظام أو حذفها.

| الدور | الوصف | الأذونات الرئيسية |
| :- | :- | :- |
| **مسؤول المستأجر** | وصول كامل لجميع الموارد داخل المستأجر | `*` (مسؤول فائق) |
| **مسؤول المنظمة** | إدارة المصدرين والمستخدمين والشهادات لمنظمة واحدة | `issuers:*`، `attestations:*`، `users:*`، `audit:read` |
| **مسؤول المصدر** | إدارة المصدرين وسك الشهادات | `issuers:*`، `attestations:*` |
| **المدقق** | وصول للقراءة فقط للمراقبة والامتثال | `attestations:read`، `issuers:read`، `audit:read` |

يمكنك عرض أدوار النظام من صفحة **الأدوار** في وحدة التحكم. يعرض كل دور اسمه ووصفه وشارة **النظام**.

## الأدوار المخصصة

أنشئ أدوارًا مخصصة لتحديد أذونات الوصول المصممة خصيصًا لهيكل فريقك. تتوفر الأدوار المخصصة في جميع الخطط.

### إنشاء دور مخصص في وحدة التحكم

**1. فتح صفحة الأدوار**

انتقل إلى **الأدوار** في الشريط الجانبي لوحدة التحكم.

**2. انقر فوق إنشاء دور مخصص**

يفتح زر "**إنشاء دور مخصص**" مربع حوار حيث تقدم:

* **اسم الدور** — اسم وصفي للدور (على سبيل المثال، `Developer` أو `Compliance Officer`).
* **الوصف** — شرح موجز لماهية الدور.

**3. حفظ الدور**

انقر فوق **إنشاء دور** للحفظ. يظهر الدور الجديد في قسم **الأدوار المخصصة** في صفحة الأدوار.

### إنشاء دور مخصص عبر واجهة برمجة التطبيقات

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/roles \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "attestation_minter",
    "description": "Can only mint attestations for specific issuers",
    "permissions": ["attestations:mint", "attestations:read", "issuers:read"],
    "constraints": {
      "issuer_ids": ["issuer-uuid-1", "issuer-uuid-2"]
    }
  }'
```

### قيود على مستوى المورد

تدعم الأدوار المخصصة قيودًا اختيارية تحد من الأذونات لموارد محددة:

```json theme={null}
{
  "name": "regional_auditor",
  "description": "Audit access scoped to EU issuers only",
  "permissions": ["attestations:read", "issuers:read", "audit:read"],
  "constraints": {
    "issuer_ids": ["eu-issuer-uuid-1", "eu-issuer-uuid-2"]
  }
}
```

> [!NOTE]
>
> قيود على مستوى المورد (مثل التقييد على جهات إصدار محددة) هي
> متاح على خطط المؤسسات.

## نطاقات مفتاح API مقابل أدوار المستخدم

لكل من مفاتيح API والمستخدمين أذونات، لكنها تعمل بشكل مختلف:

| الجانب | نطاقات مفتاح API | أدوار المستخدمين |
| - | - | - |
| التعيين | يتم تعيينه عند إنشاء المفتاح، غير قابل للتغيير | يمكن تغييره في أي وقت |
| مسار التدقيق | الإجراءات المسجلة كمعرف مفتاح API | الإجراءات المسجلة كبريد إلكتروني للمستخدم |
| متعدد | مفتاح واحد = مجموعة واحدة من النطاقات | يمكن للمستخدم أن يكون له أدوار متعددة |
| حالة الاستخدام | تكامل من خادم إلى خادم | المستخدمون البشريون عبر واجهة المستخدم/لوحة التحكم |

## أفضل الممارسات

* **أقل امتياز:** امنح فقط الأذونات اللازمة لكل دور
* **فصل الواجبات:** لا تمنح دورًا واحدًا كل من `attestations:mint` و `governance:approve`
* **عمليات التدقيق المنتظمة:** مراجعة تعيينات الأدوار ربع سنوية
* **استخدم مفاتيح API للأتمتة:** لا تشارك بيانات اعتماد المستخدم للنصوص البرمجية
* **توثيق الأدوار المخصصة:** احتفظ بسجل لسبب إنشاء الأدوار المخصصة

## الخطوات التالية

> [card] [سجلات التدقيق](https://docs.truthlocks.com/security/audit.md)
>
> تتبع جميع الأحداث المتعلقة بالأذونات.

> [card] [واجهة برمجة تطبيقات الهوية](https://docs.truthlocks.com/api-reference/identity/orgs.md)
>
> إدارة المستخدمين والأدوار برمجيًا.


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