اكوّن x-on-behalf-user الوصول عندما يحتاج حساب تقني إلى تنفيذ عمليات Analyzer API لمستخدمين محددين في نفس المؤسسة.
عندما يكون الوصول بالنيابة مُفعلاً، يمكن لتطبيق مركزي العمل مع مستندات وبيانات المستخدم دون الحاجة إلى رموز مصادقة المستخدم الفردية.
ما الذي يُتيحه الوصول بالنيابة
يمكن للحساب التقني أن يتصرف نيابة عن مستخدم معتمد لـ:
- الوصول إلى مستندات المستخدم.
- استرداد القيم المستخرجة من مستندات المستخدم.
- البحث في بيانات المستخدم.
- رفع مستندات للمستخدم.
- استخراج الخصائص التي كوّنها المستخدم.
يسري الوصول فقط على المستخدمين الذين تمت الموافقة عليهم صراحةً للحساب التقني.
المتطلبات
قبل طلب الوصول بالنيابة:
- اكوّن الحساب التقني للوصول إلى Analyzer API.
- قم بتنفيذ مكالمة Analyzer API ناجحة واحدة على الأقل باستخدام الحساب التقني.
- تأكد من أن كل مستخدم ينتمي إلى نفس المؤسسة التي ينتمي إليها الحساب التقني.
- اجمع عنوان البريد الإلكتروني الدقيق لكل مستخدم يحتاج إلى وصول بالنيابة.
ترفض Adobe طلبات النيابة للمستخدمين في مؤسسة أخرى أو عندما لا يطابق عنوان البريد الإلكتروني المقدم حساب المستخدم بشكل دقيق.
حدد الحساب التقني
حدد الحساب التقني الذي ينشئ رمز وصول OAuth ويرسل طلبات API.
للعثور على معرف الحساب التقني:
- افتح المشروع في Adobe Developer Console.
- افتح بيانات اعتماد OAuth Server-to-Server المستخدمة لـ Analyzer.
- افتح الصفحة المستخدمة لإنشاء رمز وصول.
- حدد موقع معرف الحساب التقني.
ينتهي معرف الحساب التقني بـ @techacct.adobe.com.
تأكد من أن المعرف ينتمي إلى الحساب التقني الذي يستخدمه التكامل الخاص بك قبل إرسال طلب قائمة السماح ب.
تحديد المستخدمين
إنشاء قائمة بالمستخدمين الذين يحتاج الحساب التقني للعمل نيابة عنهم.
لكل مستخدم:
- جمع عنوان البريد الإلكتروني الصحيح لحساب Adobe الخاص بالمستخدم.
- التحقق من أن المستخدم ينتمي إلى نفس المؤسسة الخاصة بالحساب التقني.
يمكن الوصول فقط إلى المستخدمين المدرجين في قائمة المسموح بهم المعتمدة من خلال طلبات نيابة عن.
طلب الوصول نيابة عن
دعم Adobe يدير قائمة المسموح بهم لكل حساب تقني.
يجب على مدير النظام في المؤسسة تقديم طلب دعم يتضمن:
- معرف الحساب التقني المنتهي بـ @techacct.adobe.com.
- القائمة الكاملة لعناوين البريد الإلكتروني للمستخدمين لإضافتها إلى القائمة المسموحة.
- تأكيد الموافقة من مدير النظام في المؤسسة.
تراجع Adobe الطلب وتكوّن المستخدمين المعتمدين للحساب التقني.
يجب أن يكون الحساب التقني قد أكمل استدعاء واحد ناجح على الأقل لواجهة برمجة التطبيقات Analyzer قبل أن تتمكن Adobe من تحديث تكوينه.
إجراء طلب واجهة برمجة التطبيقات نيابة عن مستخدم
بعد موافقة Adobe على القائمة المسموحة، قم بتضمين ترويسة x-on-behalf-user في الطلبات التي يجب تشغيلها نيابةً عن مستخدم معتمد.
عيّن قيمة الترويسة على عنوان البريد الإلكتروني المعتمد للمستخدم:
x-on-behalf-user: user@example.com
استمر في مصادقة الطلب برمز OAuth Server-to-Server bearer الخاص بالحساب التقني.
يتم تشغيل الطلب في سياق المستخدم المحدد بواسطة ترويسة x-on-behalf-user.يجب أن يكون المستخدم في القائمة المسموحة المعتمدة للحساب التقني.
تجربة Acrobat على الويب
قم بإنشاء ملفات PDF وتحريرها ومشاركتها عبر الإنترنت.