إعدادات decision-gate.toml

نظرة عامة

decision-gate.toml يقوم بتكوين خادم MCP، سياسات الثقة، إعدادات إفشاء الأدلة، وسجل المزودين. يتم التحقق من جميع المدخلات وتفشل في حالة حدوث أخطاء.

أقسام المستوى الأعلى

[الخادم]

إعدادات نقل الخادم، المصادقة، الحدود، والتدقيق.

الحقل	النوع	الافتراضي	الملاحظات
transport	”stdio” | “http” | “sse”	stdio	بروتوكول النقل لـ MCP.
mode	”strict” | “dev_permissive”	strict	وضع التشغيل لـ MCP (dev_permissive هو قديم).
tls_termination	”server” | “upstream”	server	حيث يتم إنهاء TLS لنقل HTTP/SSE.
bind	سلسلة	null	عنوان الربط لنقل HTTP/SSE.
max_body_bytes	عدد صحيح	1048576	الحد الأقصى لحجم طلب JSON-RPC بالبايت.
limits	جدول	{ max_inflight = 256 }	حدود الطلبات لخادم MCP.
auth	جدول	null	إعدادات المصادقة الواردة لاستدعاءات أدوات MCP.
tls	جدول	null	إعدادات TLS لنقل HTTP/SSE.
audit	جدول	{ enabled = true }	إعدادات تسجيل التدقيق المنظم.
feedback	جدول	n/a	إعدادات الإفصاح عن الملاحظات لاستجابات الأدوات.
tools	جدول	{ mode = “filter”, allowlist = [], denylist = [] }	إعدادات رؤية الأدوات لقوائم أدوات MCP.

يتطلب HTTP/SSE bind؛ يتطلب الاتصال غير الدائري اختيارًا صريحًا من واجهة سطر الأوامر بالإضافة إلى TLS أو tls_termination = "upstream" + مصادقة غير محلية.

[server.auth]

مصادقة/تفويض الوارد لاستدعاءات أدوات MCP.

الحقل	النوع	الافتراضي	الملاحظات
mode	”local_only” | “bearer_token” | “mtls”	local_only	وضع المصادقة الوارد لاستدعاءات أدوات MCP.
bearer_tokens	مصفوفة	[]	رموز الحامل المسموح بها.
mtls_subjects	مصفوفة	[]	الموضوعات المسموح بها في mTLS (عبر رأس الوكيل الموثوق).
allowed_tools	مصفوفة	[]	قائمة أدوات اختيارية للمكالمات الواردة.
principals	مصفوفة	[]	تعيينات اختيارية من المبدأ إلى الدور.

مثال على رمز الحامل:

[server.auth]
mode = "bearer_token"
bearer_tokens = ["token-1", "token-2"]
allowed_tools = ["scenario_define", "scenario_start", "scenario_next"]

مثال على موضوع mTLS (عبر رأس الوكيل الموثوق):

[server.auth]
mode = "mtls"
mtls_subjects = ["CN=decision-gate-client,O=Example Corp"]

عند استخدام وضع mtls، يتوقع الخادم رأس x-decision-gate-client-subject من وكيل موثوق ينهي TLS.

مثال على رسم الخرائط الرئيسي (ACL السجل):

[[server.auth.principals]]
subject = "loopback"
policy_class = "prod"

[[server.auth.principals.roles]]
name = "TenantAdmin"
tenant_id = 1
namespace_id = 1

يتوقع ACL السجل المدمج قيم policy_class مثل prod أو project أو scratch (غير حساسة لحالة الأحرف). يتم التعامل مع القيم غير المعروفة على أنها prod.

[server.audit]

إعدادات تسجيل التدقيق الهيكلي.

الحقل	النوع	الافتراضي	الملاحظات
enabled	bool	true	تمكين تسجيل تدقيق منظم (خطوط JSON).
path	string	null	مسار سجل التدقيق (خطوط JSON).
log_precheck_payloads	bool	false	تسجيل الحمولة الخام لفحص ما قبل (اختيار صريح).

[server.feedback]

ضوابط الكشف عن التعليقات لردود الأدوات.

الحقل	النوع	الافتراضي	الملاحظات
scenario_next	جدول	{ الافتراضي = “ملخص”, الافتراضي_المحلي = “تتبع”, الحد_الأقصى = “تتبع” }	سياسة التغذية الراجعة لاستجابات scenario_next.

مستويات التعليقات: summary (البوابات غير الملباة فقط)، trace (حالة البوابة + الحالة الشرطية)، evidence (تشمل سجلات الأدلة، خاضعة لسياسة الإفصاح).

[server.feedback.scenario_next]

سياسة التعليقات لردود السيناريو_next.

الحقل	النوع	الافتراضي	الملاحظات
default	”ملخص” | “تتبع” | “أدلة”	ملخص	مستوى التغذية الراجعة الافتراضي للطلبات غير المحلية.
local_only_default	”ملخص” | “تتبع” | “أدلة”	تتبع	مستوى التغذية الراجعة الافتراضي للطلبات المحلية فقط.
max	”ملخص” | “تتبع” | “أدلة”	تتبع	الحد الأقصى لمستوى التغذية الراجعة المسموح به.
trace_subjects	مصفوفة	[“loopback”, “stdio”]	معرفات الموضوعات المسموح بها لطلب تغذية راجعة تتبع.
trace_roles	مصفوفة	[]	أسماء الأدوار المسموح بها لطلب تغذية راجعة تتبع.
evidence_subjects	مصفوفة	[]	معرفات الموضوعات المسموح بها لطلب تغذية راجعة أدلة.
evidence_roles	مصفوفة	[]	أسماء الأدوار المسموح بها لطلب تغذية راجعة أدلة.

تطبق الإعدادات الافتراضية المحلية فقط على loopback/stdio. يتم حل الموضوعات والأدوار من server.auth.principals.

[server.tools]

إعدادات رؤية الأدوات لمخرجات الأدوات/القائمة.

الحقل	النوع	الافتراضي	الملاحظات
mode	”filter” | “passthrough”	filter	وضع الرؤية لأدوات/مخرجات القائمة.
allowlist	مصفوفة	[]
denylist	مصفوفة	[]

الرؤية منفصلة عن المصادقة: يتم استبعاد الأدوات المخفية من tools/list وتُعتبر غير معروفة عند استدعائها.

[server.limits]

طلب التزامن وحدود المعدل.

الحقل	النوع	الافتراضي	الملاحظات
max_inflight	عدد صحيح	256	الحد الأقصى لطلبات MCP المتزامنة.
rate_limit	جدول	null	تكوين حد معدل اختياري.

[server.limits.rate_limit]

تكوين حد معدل بأسلوب دلو الاختياري.

الحقل	النوع	الافتراضي	الملاحظات
max_requests	عدد صحيح	1000	الحد الأقصى لعدد الطلبات في نافذة حد المعدل.
window_ms	عدد صحيح	1000	نافذة حد المعدل بالمللي ثانية.
max_entries	عدد صحيح	4096	الحد الأقصى لمدخلات حد المعدل المميزة.

[server.tls]

تكوين TLS لنقل HTTP/SSE.

الحقل	النوع	الافتراضي	الملاحظات
cert_path	سلسلة	غير متوفر	شهادة TLS للخادم (PEM).
key_path	سلسلة	غير متوفر	المفتاح الخاص لـ TLS للخادم (PEM).
client_ca_path	سلسلة	null	حزمة CA للعميل الاختيارية لـ mTLS.
require_client_cert	بولياني	true	يتطلب شهادة العميل لـ mTLS.

[dev]

تجاوزات مطلوبة صريحة (اختياري فقط).

الحقل	النوع	الافتراضي	الملاحظات
permissive	bool	false	تفعيل وضع المطور المتساهل (اختيار صريح).
permissive_scope	”asserted_evidence_only”	asserted_evidence_only	اختيار نطاق المطور المتساهل.
permissive_ttl_days	integer	null	TTL اختياري للتحذيرات المتعلقة بالمطور المتساهل (بالأيام).
permissive_warn	bool	true	إصدار تحذيرات عند تفعيل/انتهاء صلاحية المطور المتساهل.
permissive_exempt_providers	array	[“assetcore_read”, “assetcore”]	مقدمو الخدمات المعفيون من تخفيفات المطور المتساهل.

يتم رفض dev-permissive عندما يكون namespace.authority.mode = "assetcore_http".

[namespace]

قائمة السماح بالمساحة واختيار السلطة.

الحقل	النوع	الافتراضي	الملاحظات
allow_default	bool	false	السماح بمعرف مساحة الاسم الافتراضية (1).
default_tenants	array	[]	قائمة السماح بالمستأجرين المطلوبة عند كون allow_default صحيحًا.
authority	table	{ mode = “none” }	اختيار خلفية سلطة مساحة الاسم.

[namespace.authority]

تكوين خلفية سلطة مساحة الأسماء.

الحقل	النوع	الافتراضي	الملاحظات
mode	”none” | “assetcore_http”	none	اختيار خلفية سلطة النطاق.
assetcore	جدول	null	إعدادات سلطة نطاق Asset Core.

[namespace.authority.assetcore]

إعدادات سلطة مساحة الأسماء لـ Asset Core.

الحقل	النوع	الافتراضي	الملاحظات
base_url	سلسلة	غير متاح	عنوان URL الأساسي لكتابة خادم Asset Core.
auth_token	سلسلة	null	رمز حاملي اختياري للبحث في مساحة الأسماء.
connect_timeout_ms	عدد صحيح	500	مهلة الاتصال HTTP (مللي ثانية).
request_timeout_ms	عدد صحيح	2000	مهلة طلب HTTP (مللي ثانية).

مثال على سلطة Asset Core:

[namespace.authority]
mode = "assetcore_http"

[namespace.authority.assetcore]
base_url = "http://127.0.0.1:9001"
auth_token = "token"
connect_timeout_ms = 500
request_timeout_ms = 2000

[الثقة]

تعيينات مسار الثقة وإنفاذ توقيع المزود.

الحقل	النوع	الافتراضي	الملاحظات
default_policy	”audit”	audit	سياسة الثقة الافتراضية لمقدمي الخدمة.
min_lane	”verified” | “asserted”	verified	الحد الأدنى من دليل الثقة المقبول.

require_signature نموذج:

[trust]
default_policy = { require_signature = { keys = ["key1.pub"] } }

[evidence]

سياسة الكشف عن الأدلة الافتراضية.

الحقل	النوع	الافتراضي	الملاحظات
allow_raw_values	bool	false	السماح بالكشف عن قيم الأدلة الخام.
require_provider_opt_in	bool	true	يتطلب موافقة المزود للكشف الخام.

[provider_discovery]

ضوابط الإفصاح عن عقد/مخطط المزود.

الحقل	النوع	الافتراضي	الملاحظات
allowlist	مصفوفة	[]	قائمة السماح الاختيارية للإفصاح عن المزود.
denylist	مصفوفة	[]	معرفات المزود المرفوضة للإفصاح.
max_response_bytes	عدد صحيح	1048576	الحد الأقصى لحجم الاستجابة لأدوات اكتشاف المزود.

[anchors]

إعداد سياسة تثبيت الأدلة.

الحقل	النوع	الافتراضي	الملاحظات
providers	مصفوفة	[]	متطلبات محددة لمقدمي الخدمة.

[[anchors.providers]]

متطلبات محددة لمقدمي الخدمة.

الحقل	النوع	مطلوب	الافتراضي	الملاحظات
provider_id	سلسلة	نعم	غير متوفر	معرف المزود الذي يتطلب المراسي.
anchor_type	سلسلة	نعم	غير متوفر	معرف نوع المرساة المتوقع في النتائج.
required_fields	مصفوفة	نعم	غير متوفر	الحقول المطلوبة في anchor_value.

مثال على سياسة الربط (Asset Core):

[anchors]
[[anchors.providers]]
provider_id = "assetcore_read"
anchor_type = "assetcore.anchor_set"
required_fields = ["assetcore.namespace_id", "assetcore.commit_id", "assetcore.world_seq"]

[policy]

اختيار محرك سياسة الإرسال.

الحقل	النوع	الافتراضي	الملاحظات
engine	”permit_all” | “deny_all” | “static”	permit_all	اختيار محرك سياسة التوزيع.
static	جدول	null	قواعد سياسة التوزيع الثابتة.

مثال على سياسة ثابتة:

[policy]
engine = "static"

[policy.static]
default = "deny"

[[policy.static.rules]]
effect = "permit"
target_kinds = ["agent"]
require_labels = ["public"]

[policy.static]

قواعد سياسة الإرسال الثابت.

الحقل	النوع	الافتراضي	الملاحظات
default	”إذن” | “رفض”	رفض	القرار الافتراضي عندما لا تتطابق أي قواعد.
rules	مصفوفة	[]	قائمة مرتبة من قواعد السياسة الثابتة.

[[policy.static.rules]]

حقول قاعدة السياسة الثابتة.

الحقل	النوع	الافتراضي	الملاحظات
effect	”permit” | “deny” | “error”	n/a	تأثير القاعدة.
error_message	سلسلة	null	رسالة الخطأ عندما يكون التأثير ‘error’.
target_kinds	مصفوفة	[]	أنواع الأهداف التي قد تستقبل الحزمة.
targets	مصفوفة	[]	محددات الأهداف المحددة.
require_labels	مصفوفة	[]	تسميات الرؤية المطلوبة للمطابقة.
forbid_labels	مصفوفة	[]	تسميات الرؤية التي تمنع المطابقة.
require_policy_tags	مصفوفة	[]	تسميات السياسة المطلوبة للمطابقة.
forbid_policy_tags	مصفوفة	[]	تسميات السياسة التي تمنع المطابقة.
content_types	مصفوفة	[]	أنواع المحتوى المسموح بها.
schema_ids	مصفوفة	[]	معرفات المخطط المسموح بها.
packet_ids	مصفوفة	[]	معرفات الحزمة المسموح بها.
stage_ids	مصفوفة	[]	معرفات المرحلة المسموح بها.
scenario_ids	مصفوفة	[]	معرفات السيناريو المسموح بها.

حقول محدد الهدف (policy.static.rules.targets):

الحقل	النوع	الملاحظات
target_kind	”عميل” | “جلسة” | “خارجي” | “قناة”	نوع الهدف.
target_id	سلسلة نصية	معرف العميل/الجلسة/القناة.
system	سلسلة نصية	اسم النظام الخارجي (خارجي فقط).
target	سلسلة نصية	معرف الهدف الخارجي (خارجي فقط).

[التحقق]

سياسة التحقق من صحة المقارنات للسيناريوهات والفحوصات المسبقة.

الحقل	النوع	الافتراضي	الملاحظات
strict	bool	true	فرض التحقق من المقارنات الصارمة.
profile	”strict_core_v1”	strict_core_v1	معرف ملف تعريف المقارنات الصارمة.
allow_permissive	bool	false	خيار صريح للتأكيد على التحقق المتساهل.
enable_lexicographic	bool	false	تمكين المقارنات المعجمية (خيار حسب المخطط).
enable_deep_equals	bool	false	تمكين المقارنات العميقة للتساوي (خيار حسب المخطط).

التحقق الصارم (افتراضي):

[validation]
strict = true
profile = "strict_core_v1"

التحقق المرن (الاختيار الصريح):

[validation]
strict = false
allow_permissive = true

عائلات المقارنات الاختيارية:

[validation]
enable_lexicographic = true
enable_deep_equals = true

[runpack_storage]

تكوين تخزين Runpack.

الحقل	النوع	مطلوب	الافتراضي	الملاحظات
type	”object_store”	نعم	غير متوفر	اختيار واجهة تخزين Runpack.
provider	”s3”	نعم	غير متوفر	مزود واجهة التخزين.
bucket	سلسلة نصية	نعم	غير متوفر	اسم الدلو لتخزين Runpack.
region	سلسلة نصية	لا	null	تجاوز المنطقة الاختيارية لـ S3.
endpoint	سلسلة نصية	لا	null	نقطة النهاية الاختيارية المتوافقة مع S3.
prefix	سلسلة نصية	لا	null	بادئة المفتاح الاختيارية داخل الدلو.
force_path_style	بولياني	لا	false	فرض استخدام أسلوب العنوان بالطريق (متوافق مع S3).
allow_http	بولياني	لا	false	السماح بنقاط النهاية غير المشفرة (اختيار صريح).

[runstatestore]

إعدادات استمرارية حالة التشغيل.

الحقل	النوع	الافتراضي	الملاحظات
type	”memory” | “sqlite”	memory	اختيار واجهة تخزين حالة التشغيل.
path	سلسلة نصية	null	مسار قاعدة بيانات SQLite.
busy_timeout_ms	عدد صحيح	5000	مهلة انشغال SQLite (مللي ثانية).
journal_mode	”wal” | “delete”	wal	وضع سجل SQLite.
sync_mode	”full” | “normal”	full	وضع مزامنة SQLite.
max_versions	عدد صحيح	null	الحد الأقصى الاختياري للإصدارات المحتفظ بها لكل تشغيل.

مثال على SQLite:

[run_state_store]
type = "sqlite"
path = "decision-gate.db"
journal_mode = "wal"
sync_mode = "full"
busy_timeout_ms = 5000
max_versions = 1000

[schema_registry]

استمرارية سجل المخططات والحدود.

الحقل	النوع	الافتراضي	الملاحظات
type	”memory” | “sqlite”	memory	اختيار خلفية سجل المخطط.
path	سلسلة	null	مسار قاعدة بيانات SQLite.
busy_timeout_ms	عدد صحيح	5000	مهلة انشغال SQLite (مللي ثانية).
journal_mode	”wal” | “delete”	wal	وضع سجل SQLite.
sync_mode	”full” | “normal”	full	وضع مزامنة SQLite.
max_schema_bytes	عدد صحيح	1048576	الحد الأقصى لحجم الحمولة في المخطط بالبايت.
max_entries	عدد صحيح	null	الحد الأقصى الاختياري للمخططات لكل مستأجر + مساحة اسم.
acl	جدول	{ mode = “builtin” }	تكوين ACL لسجل المخطط.

[schema_registry.acl]

تكوين ACL لسجل المخطط.

الحقل	النوع	الافتراضي	الملاحظات
mode	”builtin” | “custom”	builtin	قواعد الأدوار المدمجة أو قواعد ACL المخصصة.
default	”deny” | “allow”	deny	القرار الافتراضي عندما لا تتطابق أي قواعد (مخصص فقط).
allow_local_only	bool	false	السماح للمواضيع المحلية فقط بالوصول إلى السجل عند استخدام ACL المدمجة.
require_signing	bool	false	يتطلب بيانات التعريف لتوقيع المخطط عند الكتابة.
rules	array	[]	قواعد ACL المخصصة (الوضع = مخصص).

تستند قائمة التحكم في الوصول المدمجة إلى server.auth.principals لحل الأدوار وفئة السياسة. بدون المبدأ، يكون الوصول إلى السجل افتراضيًا مرفوضًا ما لم يتم تمكين allow_local_only (للمستخدمين المحليين فقط). قم بتمكين allow_local_only لتسهيل الاستخدام في بيئة التطوير فقط؛ حيث يتجاوز تعيين المبدأ للمتصلين المحليين فقط.

مثال على ACL مخصص:

[schema_registry.acl]
mode = "custom"
default = "deny"

[[schema_registry.acl.rules]]
effect = "allow"
actions = ["register", "list", "get"]
tenants = [1]
namespaces = [1]
roles = ["TenantAdmin", "NamespaceAdmin"]

[[schema_registry.acl.rules]]

حقول قاعدة ACL المخصصة.

الحقل	النوع	الافتراضي	الملاحظات
effect	”allow” | “deny”	n/a	تأثير القاعدة.
actions	مصفوفة	[]	إجراءات السجل المغطاة بواسطة القاعدة.
tenants	مصفوفة	[]	نطاق معرف المستأجر.
namespaces	مصفوفة	[]	نطاق معرف مساحة الأسماء.
subjects	مصفوفة	[]	الموضوعات الرئيسية في النطاق.
roles	مصفوفة	[]	أسماء الأدوار في النطاق.
policy_classes	مصفوفة	[]	تسميات فئات السياسة في النطاق.

[المستندات]

بحث الوثائق وتكوين الموارد.

الحقل	النوع	الافتراضي	الملاحظات
enabled	bool	true	تمكين واجهات الوثائق عالمياً.
enable_search	bool	true	تمكين أداة بحث الوثائق.
enable_resources	bool	true	تمكين قائمة/قراءة موارد MCP.
include_default_docs	bool	true	تضمين مجموعة الوثائق الافتراضية المدمجة.
extra_paths	array	[]	مسارات وثائق إضافية للاستيراد (ملفات أو دلائل).
max_doc_bytes	integer	262144	الحد الأقصى لحجم إدخال وثيقة واحدة بالبايت.
max_total_bytes	integer	1048576	الحد الأقصى لإجمالي بايت الوثائق في الكتالوج.
max_docs	integer	32	الحد الأقصى لعدد الوثائق في الكتالوج.
max_sections	integer	10	الحد الأقصى للأقسام التي يتم إرجاعها بواسطة بحث الوثائق.

بحث الوثائق والموارد محدد ومحلي فقط بشكل افتراضي. استخدم extra_paths لاستيراد ملفات أو دلائل Markdown المحلية.

[[providers]]

تسجل إدخالات المزودين مزودي الخدمة المدمجين أو مزودي MCP.

الحقل	النوع	مطلوب	الافتراضي	الملاحظات
name	سلسلة	نعم	غير متوفر	معرف المزود.
type	”مضمن” | “مركز التحكم”	نعم	غير متوفر	نوع المزود.
command	مصفوفة	لا	[]
url	سلسلة	لا	null	عنوان URL HTTP للمزود.
allow_insecure_http	بولياني	لا	خطأ	السماح بعناوين URL http:// لمزودي مركز التحكم.
capabilities_path	سلسلة	لا	null	المسار إلى عقدة قدرات المزود بصيغة JSON.
auth	جدول	لا	null
trust	غير معروف	لا	null	سياسة الثقة الافتراضية للمزودين.
allow_raw	بولياني	لا	خطأ	السماح بالكشف عن الأدلة الخام لهذا المزود.
timeouts	جدول	لا	{ connect_timeout_ms = 2000, request_timeout_ms = 10000 }	تجاوزات مهلة HTTP لمزودي مركز التحكم.
config	JSON	لا	null	كتلة إعدادات خاصة بالمزود.

auth form:

auth = { bearer_token = "token" }

trust نموذج تجاوز:

trust = { require_signature = { keys = ["provider.pub"] } }

مثال على capabilities_path لمزودي MCP:

[[providers]]
name = "mongo"
type = "mcp"
command = ["mongo-provider", "--stdio"]
capabilities_path = "contracts/mongo_provider.json"

timeouts form (HTTP MCP providers):

timeouts = { connect_timeout_ms = 2000, request_timeout_ms = 10000 }

مثال لمزود HTTP مع مهلات:

[[providers]]
name = "ci"
type = "mcp"
url = "https://ci.example.com/rpc"
capabilities_path = "contracts/ci_provider.json"
timeouts = { connect_timeout_ms = 2000, request_timeout_ms = 10000 }

قيود المهلة:

• connect_timeout_ms يجب أن يكون بين 100 و 10000.
• request_timeout_ms يجب أن يكون بين 500 و 30000 و >= connect_timeout_ms.

[providers.timeouts]

تجاوزات المهلة لمزودي HTTP MCP.

الحقل	النوع	الافتراضي	الملاحظات
connect_timeout_ms	عدد صحيح	2000	مهلة الاتصال TCP/TLS (مللي ثانية).
request_timeout_ms	عدد صحيح	10000	إجمالي مهلة الطلب (مللي ثانية).

تكوين المزود المدمج

تقبل الموفرون المدمجون كتل config اختيارية:

• time:
  • allow_logical (bool, الافتراضي true)
• env:
  • قائمة السماح (array)
  • denylist (array)
  • max_value_bytes (عدد صحيح)
  • max_key_bytes (عدد صحيح)
  • الاستبدالات (جدول)
• json:
  • جذر (string)
  • root_id (سلسلة)
  • max_bytes (عدد صحيح)
  • allow_yaml (bool)
• http:
  • allow_http (bool)
  • timeout_ms (عدد صحيح)
  • max_response_bytes (عدد صحيح)
  • allowed_hosts (array)
  • user_agent (سلسلة)
  • خوارزمية_التجزئة (string)