أخطاء OAuth
معظم أخطاء OAuth روتينية وتندرج تحت واحدة من أربع فئات. إليك كيفية التمييز بينها وإصلاحها.
”redirect_uri mismatch”
Section titled “”redirect_uri mismatch””الأعراض: تعرض Salesforce صفحة خطأ عامة بدلاً من شاشة “Allow” (سماح)، مع وجود error=redirect_uri_mismatch في عنوان URL.
السبب: تم تكوين تطبيق TranSFlator Connected App في Salesforce بعنوان URL لمعاودة الاتصال لا يطابق ما يستخدمه التطبيق فعلياً (http://localhost:1717/oauth/callback).
الإصلاح: لا ينبغي أن يحدث هذا للعملاء أبداً — فهذا يعني أن بيانات تطبيق Connected App الخاص بنا قد تضررت. إذا واجهت ذلك، أرسل بريداً إلكترونياً إلى hello@tucario.com مع عنوان URL من متصفحك.
”invalid_grant” عند تبادل الرمز
Section titled “”invalid_grant” عند تبادل الرمز”الأعراض: يعيد المتصفح التوجيه بشكل صحيح، لكن التطبيق يظهر “فشل المصادقة”.
السبب: انتهت صلاحية رمز التفويض قبل أن يتمكن التطبيق من تبادله. يحدث هذا إذا استغرقت أكثر من دقيقة في شاشة أذونات Salesforce.
الإصلاح: انقر فوق Add Connection مرة أخرى وتابع التدفق دون توقف.
”session expired or invalid”
Section titled “”session expired or invalid””الأعراض: كان الاتصال يعمل بالأمس، واليوم يظهر عند النقر عليه نقطة حمراء ورسالة “انتهت صلاحية الجلسة”.
السبب: تم إلغاء رمز التحديث الخاص بك. يحدث هذا عندما:
- قام المسؤول بالنقر على Revoke (إلغاء) في تطبيق TranSFlator Connected App في شاشة Salesforce Connected Apps OAuth Usage.
- تمت إعادة تعيين كلمة مرور مستخدم Salesforce الخاص بك (تقوم Salesforce بإلغاء جميع رموز التحديث عند تغيير كلمة المرور).
- لدى منظمتك سياسة “صلاحية رمز التحديث” التي انتهت صلاحيتها للتو.
الإصلاح: انقر فوق الاتصال، وسيطالبك التطبيق بإعادة التفويض. اتبع خطوات تدفق OAuth وستعود للعمل.
”IP address not allowed”
Section titled “”IP address not allowed””الأعراض: ترفض Salesforce طلب OAuth مع رسالة restricted_access أو ما شابه.
السبب: لدى منظمتك Login IP Ranges (نطاقات IP لتسجيل الدخول) محددة في ملف التعريف الذي أثبت هويتك به، وعنوان IP الحالي الخاص بك ليس ضمن النطاق.
الإصلاح: اتصل من عنوان IP مسموح به (VPN المكتب، إلخ)، أو اطلب من المسؤول توسيع نطاق IP لملف التعريف الخاص بمستخدمك.