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

# محرك السياسة

> تقييم السياسات على مستوى المؤسسات لسيناريوهات B2C و B2B و B2G و B2B2C.

فرض قواعد الامتثال ومتطلبات الثقة وسياسات الأمان عبر نظامك البيئي. تنطبق السياسات على ثلاث فئات: `MINT`، `VERIFY`، و`BUNDLE_EXPORT`.

> [!NOTE]
>
> هل تتطلع إلى إعداد سياسات قائمة على القواعد من وحدة التحكم أو واجهة برمجة التطبيقات؟ راجع [دليل سياسات الإصدار](https://docs.truthlocks.com/ar/guides/issuance-policies.md) لإنشاء السياسات وإدارتها ومحاكاتها دون كتابة تعليمات برمجية.

## قوالب السياسات

> [card] B2C - المستهلك
>
> سياسة موجهة للمستهلك مع الكشف عن الثقة وحماية المخاطر. - المصدر
> يجب أن يكون في حالة موثوقة - يجب أن يكون مستوى الثقة verified\_org أو أعلى -
> حظر الجهات المصدرة عالية/حرجة المخاطر - يجب أن يكون المفتاح نشطًا

> [card] B2B - الشركات
>
> من شركة إلى شركة مع متطلبات الصناعة وتدوير المفاتيح. - المصدر
> يجب أن يكون في حالة موثوقة - تتطلب المالية/الرعاية الصحية مستوى مُصدر منظم
>
> * يتطلب تدوير المفتاح كل 180 يومًا - موافقات الحوكمة للحالة
>   التغييرات

> [card] B2G - الحكومة
>
> سياسة على مستوى الحكومة مع متطلبات امتثال صارمة. - الكل
> تتطلب الإثباتات طبقة المصدر المنظم - حظر المخاطر المتوسطة أو العالية
> الجهات المصدرة - يتطلب تدوير المفاتيح كل 90 يومًا - موثق إلزامي
> أسباب الإلغاء

> [card] B2B2C - هجين
>
> سياسة هجينة لسيناريوهات المؤسسة إلى المستهلك مع إفصاح مزدوج. -
> يجب أن تكون الجهة المصدرة في حالة موثوقة - يجب أن تكون فئة الثقة verified\_org أو أعلى
>
> * حماية الخصوصية: الحمولة لا تُخزن - صديقة للمستهلك + للمؤسسات
>   تفاصيل التدقيق

## الاستخدام

```javascript theme={null}
import { EnterprisePolicyEngine, templates } from "@truthlock/policy";

// Create engine with B2B template
const engine = new EnterprisePolicyEngine(templates.B2B);

// Evaluate policy
const result = engine.evaluate({
  tenant_id: "tenant-uuid",
  issuer_current: {
    id: "issuer-uuid",
    status: "trusted",
    trust_tier: "verified_org",
    risk_rating: "low",
    jurisdiction: "US",
    assurance_level: "standard",
  },
  key: {
    kid: "key-1",
    status: "ACTIVE",
    valid_from: "2024-01-01T00:00:00Z",
    age_days: 30,
  },
  context: {
    request_type: "mint",
    industry: "technology",
  },
});

if (!result.allowed) {
  console.log("Denied:", result.code);
  console.log("Reason:", result.compliance_explanation);
}
```

## نتيجة السياسة

```typescript theme={null}
interface PolicyResult {
  allowed: boolean;
  code: string; // e.g., "ISSUER_NOT_TRUSTED"
  reason: string; // Human-readable reason
  compliance_explanation: string; // Compliance-friendly explanation
  disclosures?: {
    type: "warning" | "info" | "critical";
    message: string;
    audience: "consumer" | "enterprise" | "all";
  }[];
}
```

## إصدار السياسات

لكل مثيل سياسة تجزئة فريدة محسوبة من القالب والقواعد. يمكن تخزين هذه التجزئة مع الإفادات لأغراض التدقيق.

```javascript theme={null}
const engine = new EnterprisePolicyEngine(templates.B2G);

console.log("Policy hash:", engine.getPolicyHash());
// => "a1b2c3d4e5f6g7h8"

console.log("Policy version:", engine.getPolicyVersion());
// => "1.0.0-1704067200000"
```

## فئات السياسات

| الفئة | ينطبق على |
| - | - |
| `MINT` | طلبات إنشاء الشهادات |
| `VERIFY` | طلبات التحقق |
| `BUNDLE_EXPORT` | طلبات تصدير حزمة الإثبات وقابلية نقل البيانات |

يتم تقييم سياسات `BUNDLE_EXPORT` كلما طلب مستخدم أو عميل API تنزيل حزمة إثبات أو قدم تصدير قابلية نقل البيانات. استخدمها لتقييد الصادرات حسب الولاية القضائية أو مستوى الثقة أو تصنيف المخاطر أو أي حقل آخر متاح في سياق التقييم. راجع [سياسات التحكم في التصدير](https://docs.truthlocks.com/ar/guides/issuance-policies.md#export-control-policies) للحصول على أمثلة.

## دورة حياة السياسة

لكل سياسة حالة تتحكم في التنفيذ:

| الحالة | السلوك |
| - | - |
| `DRAFT` | تم الحفظ ولكن لم يتم فرضه — استخدمه أثناء تكرار القواعد |
| `ACTIVE` | يتم فرضه على كل طلب مطابق |
| `DISABLED` | تم إيقاف التشغيل مؤقتًا دون حذف |

يتم تقييم سياسات `ACTIVE` فقط في وقت الطلب. تزيد كل تغيير في الحالة من إصدار السياسة، والذي يتم تسجيله جنبًا إلى جنب مع كل قرار تقييم لأغراض التدقيق.

دورة حياة نموذجية:

1. **إنشاء كـ `DRAFT`** — بناء وتحسين القواعد دون التأثير على حركة المرور الحية.
2. **محاكاة** — اختبر السياسة مقابل مدخلات عينة.
3. **تعيين إلى `ACTIVE`** — يبدأ التنفيذ فورًا.
4. **تعيين إلى `DISABLED`** — إيقاف التنفيذ مؤقتًا دون فقدان تعريف السياسة.
5. **حذف** — إزالة السياسة عندما لا تكون هناك حاجة إليها.

> [!NOTE]
>
> راجع [دليل سياسات الإصدار](https://docs.truthlocks.com/ar/guides/issuance-policies.md#policy-lifecycle) للحصول على إرشادات خطوة بخطوة حول إدارة انتقالات حالة السياسة.

## محاكاة السياسات

اختبر كيف تقوم سياسة بتقييم إدخال معين قبل نشرها. راجع [محاكي السياسات](https://docs.truthlocks.com/ar/guides/issuance-policies.md#simulating-a-policy) لاستخدام وحدة التحكم وواجهة برمجة التطبيقات.


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