---
read_when:
    - العمل على حلّ ملف تعريف المصادقة أو توجيه بيانات الاعتماد
    - تصحيح أخطاء فشل مصادقة النماذج أو ترتيب الملفات التعريفية
summary: دلالات أهلية بيانات الاعتماد وحلّها المرجعية لملفات تعريف المصادقة
title: دلالات بيانات اعتماد المصادقة
x-i18n:
    generated_at: "2026-04-30T21:02:26Z"
    model: gpt-5.5
    provider: openai
    source_hash: 39b9f96159d5a7b793983d07c37a73139a0904abbbc8831267807d6acf5c0037
    source_path: auth-credential-semantics.md
    workflow: 16
---

تحدد هذه الوثيقة دلالات أهلية بيانات الاعتماد وحلّها المعتمدة المستخدمة عبر:

- `resolveAuthProfileOrder`
- `resolveApiKeyForProfile`
- `models status --probe`
- `doctor-auth`

الهدف هو إبقاء سلوك وقت الاختيار وسلوك وقت التشغيل متوافقين.

## رموز أسباب الفحص المستقرة

- `ok`
- `excluded_by_auth_order`
- `missing_credential`
- `invalid_expires`
- `expired`
- `unresolved_ref`
- `no_model`

## بيانات اعتماد الرمز المميز

تدعم بيانات اعتماد الرمز المميز (`type: "token"`) القيمة المضمنة `token` و/أو `tokenRef`.

### قواعد الأهلية

1. يكون ملف تعريف الرمز المميز غير مؤهل عندما يكون كل من `token` و`tokenRef` غائبين.
2. `expires` اختياري.
3. إذا كان `expires` موجودًا، فيجب أن يكون رقمًا منتهيًا أكبر من `0`.
4. إذا كان `expires` غير صالح (`NaN`، أو `0`، أو قيمة سالبة، أو غير منتهية، أو من نوع خاطئ)، يكون ملف التعريف غير مؤهل مع `invalid_expires`.
5. إذا كان `expires` في الماضي، يكون ملف التعريف غير مؤهل مع `expired`.
6. لا يتجاوز `tokenRef` التحقق من صحة `expires`.

### قواعد الحلّ

1. تطابق دلالات أداة الحل دلالات الأهلية لـ `expires`.
2. بالنسبة إلى ملفات التعريف المؤهلة، يمكن حل مادة الرمز المميز من القيمة المضمنة أو من `tokenRef`.
3. تنتج المراجع التي يتعذر حلها `unresolved_ref` في مخرجات `models status --probe`.

## قابلية نقل نسخ الوكلاء

وراثة مصادقة الوكيل تتم بالقراءة عبر المصدر. عندما لا يملك الوكيل ملف تعريف محليًا، يمكنه حل ملفات التعريف من مخزن الوكيل الافتراضي/الرئيسي في وقت التشغيل دون نسخ المادة السرية إلى ملف `auth-profiles.json` الخاص به.

تستخدم تدفقات النسخ الصريحة، مثل `openclaw agents add`، سياسة قابلية النقل هذه:

- ملفات تعريف `api_key` قابلة للنقل ما لم يكن `copyToAgents: false`.
- ملفات تعريف `token` قابلة للنقل ما لم يكن `copyToAgents: false`.
- ملفات تعريف `oauth` غير قابلة للنقل افتراضيًا لأن رموز التحديث قد تكون أحادية الاستخدام أو حساسة للدوران.
- يمكن لتدفقات OAuth المملوكة للمزوّد الاشتراك باستخدام `copyToAgents: true` فقط عندما تكون سلامة نسخ مادة التحديث بين الوكلاء معروفة.

تبقى ملفات التعريف غير القابلة للنقل متاحة عبر وراثة القراءة عبر المصدر ما لم يسجل الوكيل الهدف الدخول بشكل منفصل وينشئ ملف تعريف محليًا خاصًا به.

## تصفية ترتيب المصادقة الصريح

- عند تعيين `auth.order.<provider>` أو تجاوز ترتيب مخزن المصادقة لمزوّد، لا يفحص `models status --probe` إلا معرّفات ملفات التعريف التي تبقى ضمن ترتيب المصادقة المحلول لذلك المزوّد.
- لا تتم تجربة ملف تعريف مخزن لذلك المزوّد محذوف من الترتيب الصريح بصمت لاحقًا. تعرض مخرجات الفحص ذلك باستخدام `reasonCode: excluded_by_auth_order` والتفصيل `Excluded by auth.order for this provider.`

## حل هدف الفحص

- يمكن أن تأتي أهداف الفحص من ملفات تعريف المصادقة أو بيانات اعتماد البيئة أو `models.json`.
- إذا كان لدى مزوّد بيانات اعتماد لكن OpenClaw لا يستطيع حل مرشح نموذج قابل للفحص له، فإن `models status --probe` يعرض `status: no_model` مع `reasonCode: no_model`.

## اكتشاف بيانات اعتماد CLI الخارجية

- لا تُكتشف بيانات الاعتماد الخاصة بوقت التشغيل فقط والمملوكة لواجهات CLI الخارجية إلا عندما يكون المزوّد أو وقت التشغيل أو ملف تعريف المصادقة ضمن نطاق العملية الحالية، أو عندما يكون ملف تعريف محلي مخزن لذلك المصدر الخارجي موجودًا بالفعل.
- ينبغي لمستدعي مخزن المصادقة اختيار وضع اكتشاف صريح لـ CLI الخارجية: `none` للمصادقة المستمرة/مصادقة Plugin فقط، أو `existing` لتحديث ملفات تعريف CLI الخارجية المخزنة مسبقًا، أو `scoped` لمجموعة محددة من المزوّدين/ملفات التعريف.
- تمرر مسارات القراءة فقط/الحالة `allowKeychainPrompt: false`؛ فهي تستخدم بيانات اعتماد CLI الخارجية المدعومة بالملفات فقط ولا تقرأ نتائج macOS Keychain أو تعيد استخدامها.

## حارس سياسة SecretRef في OAuth

- مُدخل SecretRef مخصص لبيانات الاعتماد الثابتة فقط.
- إذا كانت بيانات اعتماد ملف التعريف هي `type: "oauth"`، فلا تكون كائنات SecretRef مدعومة لمادة بيانات اعتماد ملف التعريف تلك.
- إذا كان `auth.profiles.<id>.mode` هو `"oauth"`، فيُرفض مُدخل `keyRef`/`tokenRef` المدعوم بـ SecretRef لذلك الملف التعريفي.
- تُعد الانتهاكات حالات فشل صارمة في مسارات حل مصادقة بدء التشغيل/إعادة التحميل.

## رسائل متوافقة مع الإصدارات القديمة

للتوافق مع السكربتات، تُبقي أخطاء الفحص هذا السطر الأول دون تغيير:

`Auth profile credentials are missing or expired.`

يمكن إضافة تفاصيل ملائمة للبشر ورموز أسباب مستقرة في الأسطر اللاحقة.

## ذو صلة

- [إدارة الأسرار](/ar/gateway/secrets)
- [تخزين المصادقة](/ar/concepts/oauth)
