ربط الوكيل بأداة بيانات خارجية بتفويض المستخدم

الهدف

الوصول إلى بيانات خارجية بنطاقات وافق عليها المستخدم صراحةً دون كشف بيانات اعتماد طويلة الأمد للوكيل.

الخطوات

1. حدّد الموارد التي تصل إليها الأداة لمستخدم واحد ونطاقات OAuth التي يدعمها المزود. [auth]
2. صرّح بـ OAuth عبر AuthConfig(auth_scheme=..., raw_auth_credential=..., credential_key="documents_api") واضبط خدمة بيانات اعتماد لـ CredentialManager. [auth]
3. عند مقاطعة التفويض للتشغيل، وجّه المستخدم إلى شاشة موافقة المزود ولا تضع الرموز في رسائل النموذج. [auth]
4. بعد الاستدعاء، تحقق من الحالة وربط المستخدم وأعد بيانات الاعتماد بأمان إلى الأداة المنتظرة وحدد مدة صلاحيتها. [auth]

طريقة التحقق

يقتصر التفويض على النطاقات المطلوبة؛ وتُرفض الحالة الخاطئة والرموز المنتهية أو التابعة لمستخدم آخر دون تسجيل الرموز.

معالجة الأعطال

إذا طلبت الأداة الموافقة مجدداً بعد الاستئناف، فتحقق من إعادة نتيجة التفويض الصحيحة إلى جلسة المستخدم نفسها.