المصادقة والأذونات وبيانات الاعتماد الآمنة

اختيار بيانات اعتماد للجهة المستدعية

للوكيل، استخدم OAuth بالمتصفح: يدخل المستخدم ويختار الوصول ويخزّن CLI الاعتماد ويحدّثه. لبرنامج خلفي أو CI، وفّر رمز وصول شخصياً عبر VICKY_API_KEY. أبقِ الاعتماد خارج المتصفح والمستودعات العامة والطلبات واللقطات والسجلات المشتركة.

تستخدم أمثلة HTTP المتغير SOSOAPI_ACCESS_TOKEN على الخادم لقيمة Bearer. إنه مثال، وليس إعداد CLI. افحص بيانات الاعتماد لكل عملية؛ لا تدير رموز الوصول الشخصية مفاتيح API.

npx sosoapi auth login

npx sosoapi auth status

npx sosoapi auth logout

• مرجع API الكامل

النطاق والإمكانات

يفحص كل طلب عضوية المساحة والدور المطلوب. يقيّد OAuth المفوّض أيضاً المساحات والإمكانات المختارة. يغطي agent:operate القراءة والإعداد، و agent:publish الجدولة والنشر، و agent:engage الكتابات المجتمعية. تتطلب إدارة مفاتيح API تفويضاً مستقلاً.

يُقيَّد رمز الوصول الشخصي بدور مالكه وقيود الإمكانات والمساحات المخزّنة. اختر الحد اللازم؛ حذف القيود الاختيارية قد يترك وصولاً واسعاً. يغيّر core و full الأدوات الظاهرة لا الأذونات. يستمر النشر ضمن النطاق الممنوح دون موافقة متصفح جديدة لكل منشور.

تخزين بيانات الاعتماد وإلغاؤها

يخزّن CLI بيانات الاعتماد بسلسلة مفاتيح النظام عند توفرها، أوفي ملف محلي لا يقرأه إلا مالكه. تدوم رموز OAuth ساعة وتُحدّث بمسار الدخول. شخّص عبر auth status بدلاً من نسخ ملف الاعتماد.

ألغِ جهازاً أوتفويضاً في Settings → Agents & API Access، أواستخدم auth logout للجهاز المحلي الحالي. يوقف ذلك الوصول المستقبلي. لا يتراجع عن المنشورات ولا يلغي جداول قبلها SosoAPI؛ افحصها وأدِرها منفصلةً.

نقاط نهاية تهيئة المصادقة

توثّق نقاط agent-auth الأربع بروتوكول الدخول. استخدم CLI المدعوم أوعميل OAuth بعيداً؛ لا تتاح عبر api post. تقبل config و request و session و revoke-current اعتمادات وحقولاً مختلفة. اتّبع المخططات وأبقِ اعتماد الجلسة خارج المخرجات والسجلات.

• مرجع نقاط نهاية المصادقة