---
read_when:
    - العمل على تحليل ملف تعريف المصادقة أو توجيه بيانات الاعتماد
    - تصحيح إخفاقات مصادقة النموذج أو ترتيب ملفات التعريف
summary: دلالات أهلية بيانات الاعتماد الأساسية وآلية التحليل لملفات تعريف المصادقة
title: دلالات بيانات اعتماد المصادقة
x-i18n:
    generated_at: "2026-04-24T07:29:14Z"
    model: gpt-5.4
    provider: openai
    source_hash: b45da872b9ab177acbac08ce353b6ee31b6a068477ace52e5e5eda32a848d8bb
    source_path: auth-credential-semantics.md
    workflow: 15
---

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

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

## حاجز سياسة OAuth SecretRef

- يُستخدم إدخال 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)
