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

# أمان على مستوى الصف (RLS)

> عزل المستأجرين المتعمق في طبقة قاعدة البيانات.

تستخدم Truthlocks أمان مستوى الصفوف (RLS) في Postgres كإجراء دفاعي متعمق لفرض عزل المستأجرين على مستوى قاعدة البيانات. حتى لو كان رمز التطبيق يحتوي على أخطاء، يتم منع الوصول إلى البيانات عبر المستأجرين بواسطة قاعدة البيانات نفسها.

> [!NOTE]
>
> يتم فرض RLS بالإضافة إلى تصفية المستأجر على مستوى التطبيق. كلتا الطبقتين
> العمل معًا لضمان عزل البيانات.

## كيف يعمل

### متغير الجلسة

يحدد كل طلب قاعدة بيانات متغير جلسة بمعرف المستأجر المتحقق منه:

```sql theme={null}
SET LOCAL app.tenant_id = 'verified-tenant-uuid';
```

### تعريف السياسة

تتحقق سياسات RLS من تطابق الصفوف مع المستأجر الحالي:

```sql theme={null}
CREATE POLICY tenant_isolation ON issuers
  USING (tenant_id = current_setting('app.tenant_id')::uuid)
  WITH CHECK (tenant_id = current_setting('app.tenant_id')::uuid);
```

### مصدر هوية المستأجر

يتم اشتقاق معرف المستأجر **فقط** من سياق المصادقة المتحقق منه:

* مطالبات JWT (بعد التحقق من التوقيع)
* البحث عن مفتاح API (بعد التحقق من التجزئة)
* **أبدًا** من رؤوس مقدمة من العميل مثل `X-Tenant-ID`

## الجداول المغطاة

تم تمكين RLS على جميع الجداول ذات النطاق المستأجر:

| الجدول | عمود المستأجر | السياسة |
| :- | :- | :- |
| `issuers` | `tenant_id` | ✓ ممكّن |
| `issuer_keys` | `tenant_id` | ✓ ممكّن |
| `policies` | `tenant_id` | ✓ ممكّن |
| `tenant_api_keys` | `tenant_id` | ✓ ممكّن |
| `attestations` | `tenant_id` | ✓ ممكّن |
| `risk_signals` | `tenant_id` | ✓ ممكّن |
| `risk_event_sources` | `tenant_id` | ✓ ممكّن |
| `risk_decisions` | `tenant_id` | ✓ ممكّن |
| `fraud_cases` | `tenant_id` | ✓ ممكّن |
| `fraud_events` | `tenant_id` | ✓ ممكّن |

## سلوك الفشل المغلق

إذا لم يتم تعيين `app.tenant_id` في الجلسة:

* **SELECT**: يعيد صفر صفوف (ليس خطأ)
* **إدراج**: يفشل مع انتهاك سياسة RLS
* **تحديث/حذف**: يؤثر على صفر صفوف

## التحقق

تشغيل مجموعة اختبار عزل RLS:

```bash theme={null}
make rls-check
```

## ملاحظات التنفيذ

### تجميع الاتصالات

عند استخدام مجمعات الاتصال، تأكد من استخدام `SET LOCAL` ضمن معاملة.

```go theme={null}
// Go example with pgx
tx, _ := pool.Begin(ctx)
defer tx.Rollback(ctx)

tx.Exec(ctx, "SET LOCAL app.tenant_id = $1", tenantID)
// ... perform queries ...

tx.Commit(ctx)
```


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