دلالات بيانات اعتماد المصادقة
يعرّف هذا المستند دلالات الأهلية والحل القانونية لبيانات الاعتماد المستخدمة عبر:resolveAuthProfileOrderresolveApiKeyForProfilemodels status --probedoctor-auth
رموز أسباب الفحص المستقرة
okexcluded_by_auth_ordermissing_credentialinvalid_expiresexpiredunresolved_refno_model
بيانات اعتماد الرمز المميز
تدعم بيانات اعتماد الرمز المميز (type: "token") قيمة token المضمنة و/أو tokenRef.
قواعد الأهلية
- يكون ملف تعريف الرمز المميز غير مؤهل عندما يكون كل من
tokenوtokenRefغير موجودين. expiresاختياري.- إذا كانت
expiresموجودة، فيجب أن تكون رقمًا منتهيًا أكبر من0. - إذا كانت
expiresغير صالحة (NaNأو0أو سالبة أو غير منتهية أو من نوع خاطئ)، يكون ملف التعريف غير مؤهل معinvalid_expires. - إذا كانت
expiresفي الماضي، يكون ملف التعريف غير مؤهل معexpired. - لا يتجاوز
tokenRefالتحقق منexpires.
قواعد الحل
- تتطابق دلالات أداة الحل مع دلالات الأهلية بالنسبة إلى
expires. - بالنسبة إلى ملفات التعريف المؤهلة، يمكن حل مادة الرمز المميز من القيمة المضمنة أو
tokenRef. - تؤدي المراجع غير القابلة للحل إلى
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.
حاجز سياسة SecretRef لـ OAuth
- إدخال SecretRef مخصص لبيانات الاعتماد الثابتة فقط.
- إذا كانت بيانات اعتماد ملف التعريف من النوع
type: "oauth"، فلا يتم دعم كائنات SecretRef لمادة بيانات اعتماد ملف التعريف تلك. - إذا كان
auth.profiles.<id>.modeيساوي"oauth"، فيتم رفض إدخالkeyRef/tokenRefالمدعوم بـ SecretRef لذلك الملف التعريفي. - الانتهاكات هي حالات فشل صارمة في مسارات حل المصادقة عند بدء التشغيل/إعادة التحميل.
الرسائل المتوافقة مع الإصدارات القديمة
للتوافق مع البرامج النصية، تحتفظ أخطاء الفحص بهذا السطر الأول دون تغيير:Auth profile credentials are missing or expired.
يمكن إضافة تفاصيل سهلة الفهم ورموز أسباب مستقرة في الأسطر اللاحقة.