إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
توفر هذه المقالة قائمة برسائل خطأ موصل تطبيق API وتوصيات الحل لكل خطأ.
رسائل الخطأ الشائعة والدقة
يمكن رؤية أخطاء موصل التطبيق في مربع حوار موصل التطبيق بعد محاولة توصيل تطبيق سحابي باستخدام موصل تطبيق API.
ملاحظة
إذا واجه الموصل فشلا أو قطع اتصال، فسيتم إنشاء تنبيه النظام. لاستئناف العمليات العادية والحفاظ على الاتصال، أعد توصيل الموصل على صفحة الموصلات.
| رسالة خطأ | التطبيق ذي الصلة | الوصف | القرار |
|---|---|---|---|
| HttpRequestFailure: تم إرجاع الخادم: خطأ خادم داخلي 500 | جميع التطبيقات | حدث خطأ في التطبيق. | التحقق من حالة التطبيق |
| مهلة الخدمة | جميع التطبيقات | تم الكشف عن مهلة في الاتصال بين Defender for Cloud Apps والتطبيق. قد يكون هذا بسبب مشكلة في التطبيق. | أعِد المحاولة لاحقًا. |
| الحصول على الأحداث: فشل الطلب مع رمز الحالة 402. الدفع مطلوب. فشل التحقق من صحة استحقاق سجل التدقيق | Atlassian | لا يحتوي اشتراك Atlassian على خطة "Atlassian Access" المطلوبة لمراقبة الأحداث. | يرجى تمكين خطة "Atlassian Access" على اشتراك Atlassian الخاص بك. |
| NullPointerException | اوس | خطأ داخلي | الاتصال بقسم الدعم |
| AuthFatalFailureException: com.box.boxjavalibv2.exceptions.BoxServerException: {"error":"invalid_grant","error_description":"رمز التحديث غير صالح"} | مربع | الرمز المميز لتحديث المربع غير صحيح | اتبع العملية لتوصيل Box Defender for Cloud Apps مرة أخرى. |
| BoxRestException: فشل تحليل الاستجابة. | مربع | خطأ داخلي | انقر فوق الارتباط اختبار الآن مرة أخرى لاختبار الاتصال ب Box. |
| ContextManagerServiceException: com.adallom.adalib.httputils.exceptions.TokenRefreshException: {"error":"invalid_grant","error_description":"رمز التحديث غير صالح"}' | مربع | الرمز المميز لتحديث المربع غير صحيح | اتبع العملية لتوصيل Box Defender for Cloud Apps مرة أخرى. |
| BoxServerException: لا يمكن للمستخدم الوصول إلى هذه الميزة دون الحاجة إلى مؤسسة | مربع | حساب Box ليس حساب مؤسسة. | قم بترقية ترخيص Box إلى إصدار Enterprise من Box ثم اتبع العملية لتوصيل Box Defender for Cloud Apps مرة أخرى. |
| BoxServerException: غير مصرح به - لا يمكن التخويل باستخدام هذه الخدمة | مربع | قام مسؤول Box بحذف تطبيق Defender for Cloud Apps في Box. | اتبع العملية لتوصيل Box Defender for Cloud Apps مرة أخرى. |
| HttpRequestFailure: تم إرجاع الخادم: 401 غير مصرح به | التبادل عبر الإنترنت | المستخدم أو كلمة المرور غير صحيحة | تأكد من صحة اسم المستخدم وكلمة المرور واتبع العملية للاتصال Exchange Online Defender for Cloud Apps مرة أخرى. |
| HttpRequestFailure: تم إرجاع الخادم: 404 غير موجود | التبادل عبر الإنترنت | المستخدم الذي تستخدمه لتسجيل الدخول إلى Exchange Online ليس لديه علبة بريد أساسية في Exchange Online (على سبيل المثال، مستخدم غير موجود في Microsoft Entra ID أو مستخدم موجود في Microsoft Entra ID، ولكن ليس لديه Exchange Online الترخيص). | اتبع العملية للاتصال Exchange Online Defender for Cloud Apps مرة أخرى باستخدام حساب مسؤول جديد. |
| GoogleJsonResponseException: 401 غير مصرح به | مساحة عمل Google | تم رفض الوصول. أنت غير مصرح لك بقراءة سجلات النشاط. يجب أن يكون المستخدم الذي تسجل الدخول إلى Google Workspace معه مستخدما مسؤولا. | اتبع العملية لتوصيل مساحة عمل Google Defender for Cloud Apps مرة أخرى باستخدام حساب مسؤول. |
| GoogleJsonResponseException: 403 ممنوع | مساحة عمل Google | ||
| مشكلة في تشغيل واجهة برمجة تطبيقات مساحة عمل Google. | إذا قمت للتو بنشر Defender for Cloud Apps App Connector ل Google Workspace، فتحقق مما يلي: إذا نقرت فوق Unlimited، فتأكد من أن حساب Google Workspace غير محدود حقا. إذا لم يكن كذلك، فقم بتشغيل App Connector مرة أخرى وألغ تحديد الخيار لحساب غير محدود. تحقق من صحة النطاقات التي حددتها أثناء الإعداد. إذا لم يكن هذا نشرا جديدا وشاهدت هذا الخطأ، فقد تكون قد وصلت إلى حد واجهة برمجة التطبيقات لهذا اليوم وسيتم تجديد أحداث Google Workspace غدا. | ||
| TokenResponseException: 400 طلب غير صحيح | مساحة عمل Google | إما أن الاتصال بمساحة عمل Google لم يكتمل أو انتهت صلاحيته. | اتبع العملية لتوصيل مساحة عمل Google Defender for Cloud Apps مرة أخرى. |
| HttpRequestFailure: تم إرجاع الخادم: 401 غير مصرح به | Okta | رمز Okta المميز غير صحيح. | اتبع العملية لتوصيل Okta Defender for Cloud Apps مرة أخرى. |
| IOException: | Okta | خطأ داخلي | الاتصال بقسم الدعم |
| HttpRequestFailure: تم إرجاع الخادم: 404 غير موجود | Okta | خطأ داخلي | الاتصال بقسم الدعم |
| HttpRequestFailure: تم إرجاع الخادم: 400 طلب غير صحيح: {"error":{"code":"AF20012","message":"تم تكوين معرف المستأجر المحدد (Tenant_ID هنا) بشكل غير صحيح في النظام." | Microsoft 365 | لم يتم العثور على تراخيص Microsoft 365 المعينة. | قم بتعيين ترخيص Microsoft 365 واحد على الأقل للمستأجر الخاص بك. |
| Microsoft.Office.Compliance.Audit.DataServiceException: Tenant 998cea7e-35cd-46a5-ab3c-8ec88a45d7d5 غير موجود أو {"error":"code":"AF20023","message":"تم تعطيل الاشتراك." | Microsoft 365 | لم يتم تمكين تسجيل التدقيق في Microsoft 365 | تمكين تسجيل التدقيق في Microsoft 365. معرفة المزيد |
| HttpRequestFailure: تم إرجاع الخادم: 401 غير مصرح به | Microsoft 365 | مشكلة داخلية | انقر فوق الارتباط اختبار الآن مرة أخرى |
| TokenRefreshException: {"error":"invalid_grant","error_description":"AADSTS70002: خطأ في التحقق من صحة بيانات الاعتماد. AADSTS70008: انتهت صلاحية رمز التخويل المقدم أو رمز التحديث المميز. إرسال طلب تخويل تفاعلي جديد لهذا المستخدم والمورد. | Microsoft 365 | انتهت صلاحية الرمز المميز | اتبع العملية لتوصيل Microsoft 365 Defender for Cloud Apps مرة أخرى. |
| SocketTimeoutException: مهلة القراءة | Microsoft 365 | خطأ داخلي | انقر فوق الارتباط اختبار الآن مرة أخرى |
| NullPointerException | Microsoft 365 | خطأ داخلي | الاتصال بقسم الدعم |
| IgniteException | Microsoft 365 | المجال أو المستخدم غير صالح | أعد تعيين الإعدادات واتبع العملية لتوصيل Microsoft 365 Defender for Cloud Apps مرة أخرى. |
| ContextManagerServiceException: com.adallom.adalib.httputils.exceptions.TokenRefreshException: {"error":"invalid_grant","error_description":"AADSTS70002: خطأ في التحقق من صحة بيانات الاعتماد. AADSTS70008: انتهت صلاحية رمز التخويل المقدم أو رمز التحديث المميز. إرسال طلب تخويل تفاعلي جديد لهذا المستخدم والمورد. | Microsoft 365 | المجال أو المستخدم غير صالح | أعد تعيين الإعدادات واتبع العملية لتوصيل Microsoft 365 Defender for Cloud Apps مرة أخرى. |
| HttpRequestFailure: تم إرجاع الخادم: 400 طلب غير صحيح | Microsoft 365 | خطأ داخلي | انقر فوق الارتباط اختبار الآن مرة أخرى في بضع دقائق، إذا لم يعمل، فاتبع العملية لتوصيل Microsoft 365 Defender for Cloud Apps مرة أخرى. |
| SocketTimeoutException: مهلة القراءة | Salesforce | خطأ داخلي | انقر فوق رابط Test now مرة أخرى لاختبار الاتصال ب Salesforce. |
| HttpRequestFailure: تم إرجاع الخادم: 400 طلب غير صحيح | Salesforce | إما أن الاتصال ب Salesforce لم يكتمل أو انتهت صلاحيته. | اتبع العملية لتوصيل Salesforce Defender for Cloud Apps مرة أخرى. |
الحصول على الأذونات: لاHttpResponseException: *******.salesforce.com:443 فشل الاستجابة |
Salesforce | تقييد IP على ENV للعميل. | في مدخل Salesforce، ضمن إعداد>إعدادات الجلسة، قم بإلغاء تحديد خانة الاختيار تأمين جلسات العمل إلى عنوان IP الذي نشأت منه . |
| team_not_authorized | الركود | لم يتم تمكين Slack Discovery API. | اتصل بدعم Slack واطلب تمكين Discovery API. |
| RuntimeException: com.adallom.adalib.httputils.exceptions.HttpRequestFailure: تم إرجاع الخادم: 403 ممنوع | ServiceNow | الأذونات غير صحيحة | اتبع العملية للاتصال ServiceNow Defender for Cloud Apps مرة أخرى باستخدام حساب مسؤول. |
| العملية التي تحاول تنفيذها غير مدعومة من قبل خطتك | ورقة ذكية | خطة Smartsheet غير صحيحة، مطلوب ترخيص مؤسسة مع الحزمة البلاتينية | ترقية ترخيص Smartsheet. |
| الحصول على الأحداث: {"code":403,"serverResponse" الحصول على المستخدمين: {"code":403,"serverResponse" … "النص الأساسي":"{"خطأ":"تم رفض الإذن"}" |
ساعات | إذن غير كاف للوصول إلى سجلات التدقيق و/أو نقاط نهاية المستخدم | تحقق من وجود جميع الأذونات. معرفة المزيد |
| "التعليمات البرمجية":400،"serverResponse" … النص الأساسي":"{"error":"invalid_grant"} |
ساعات | مشكلة المصادقة | قد يتم تأمين الحساب المستخدم لإعداد المثيل أو تعطيله. للتحقق، اعرض حساب Workday وحدد عرض محفوظات تسجيل الدخول. قد ترى رسالة فشل مصادقة في التقرير تحدد تعطيل حساب النظام. معرفة المزيد |
| "التعليمات البرمجية":401،"serverResponse": … النص الأساسي":"{"error":"invalid_client"}" |
ساعات | مشكلة صلاحية الرمز المميز للعميل | الرمز المميز لعميل واجهة برمجة تطبيقات REST OAuth 2.0 غير صالح. قد يكون الرمز المميز قد انتهت صلاحيته، أو قد يكون غير صحيح. إنشاء رمز مميز آخر وتعيينه إلى المثيل المتصل. معرفة المزيد |
| الحصول على المستخدم: أحداث Success Get: فشل الطلب مع رمز الحالة 403 | Zendesk | لم يعد مستخدم Zendesk الذي يقوم بتكوين التكامل مسؤولا في Zendesk، أو أن ترخيص Zendesk غير مدعوم. | قم بترقية مستخدم Zendesk الذي قام بتكوين الموصل إلى المسؤول (من مدخل مسؤول Zendesk)، أو تحقق هنا لمعرفة ما إذا كان ترخيص Zendesk الخاص بك مدعوما. |
استكشاف أخطاء الأنشطة المفقودة وإصلاحها بعد توصيل أحد التطبيقات
إذا لم تظهر الأنشطة المتوقعة بعد توصيل أحد التطبيقات، فاستخدم عمليات التحقق التالية لتحديد مكان توفر البيانات وما إذا كان التكوين الإضافي مطلوبا أم لا.
1. تأكد من أن الموصل سليم تحقق من توصيل موصل التطبيق بنجاح وأنه لا توجد تحذيرات تكوين أو مشكلات في الأذونات.
2. تحقق من توقعات تأخير الاستيعاب التي توقعت بعض الموصلات زمن انتقال قبل ظهور الأنشطة. تحقق مما إذا كان الموصل يحتوي على تأخير استيعاب موثق قبل التعامل مع النشاط المفقود كمشكلة.
3. تأكد من أن الموصل يدعم استيعاب النشاط تحقق مما إذا كان الموصل يدعم مجموعة النشاط. للحصول على قائمة بالأنشطة المدعومة لكل موصل، راجع توصيل التطبيقات للحصول على الرؤية والتحكم.
4. راجع خيارات النشاط الخاصة بالموصل للموصلات التي تدعم أنواع الأنشطة القابلة للتحديد، تأكد من تمكين الخيارات المطلوبة. على سبيل المثال، إذا كنت تحقق في نشاط تسجيل الدخول، فتحقق من تكوين الموصل لجمع بيانات تسجيل الدخول ذات الصلة.
5. تحقق من إعدادات النشر المحدد النطاق إذا تم تمكين النشر المحدد النطاق، فتأكد من تضمين الحساب الذي يقوم بالنشاط في قواعد التوزيع الحالية محددة النطاق. لا يتم استيعاب الأنشطة التي تم إنشاؤها بواسطة المستخدمين أو المجموعات أو التطبيقات المستبعدة. تحقق أيضا مما إذا كانت معرفات الحساب تتم مطابقتها بشكل صحيح في التطبيقات المتصلة، خاصة عند استخدام تنسيقات معرف مختلفة.
6. تحقق من صحة سطح التسجيل المتوقع استنادا إلى نوع النشاط، تحقق مما إذا كان الحدث يظهر في المصدر المناسب المدرج في الجدول التالي.
| Event | مصدر |
|---|---|
| تغييرات إدارة النهج Defender for Cloud Apps | سجل نشاط Microsoft Defender for Cloud Apps |
| Microsoft Entra أحداث تسجيل الدخول | Microsoft Entra سجلات تسجيل الدخول |
| بيانات التحقيق المتعلقة بالهوية | جداول هوية التتبع المتقدمة |
7. تطبيق عوامل التصفية قبل الاستنتاج بأن البيانات مفقودة استخدام عوامل التصفية مثل:
- النطاق الزمني
- المستخدم أو المسؤول
- نوع النشاط
- التطبيق أو حمل العمل
8. تحقق من قيود النطاق المعروفة قد لا يتم تمثيل بعض الأنشطة بشكل كامل في كل سطح تسجيل. إذا كان الحدث مفقودا من مصدر واحد، فتأكد مما إذا كان هذا النشاط موثقا على أنه متوفر في مصدر آخر.
هام
لا يشير النشاط المفقود دائما إلى فشل الموصل. تأكد أولا من توقع النشاط في Defender for Cloud Apps أو سجلات Microsoft Entra أو سجلات تدقيق Microsoft 365 أو التتبع المتقدم.
مزيد من التحقيق
تحقق بشكل أكبر عندما:
- يظهر الموصل حالة سليمة ولكن لا تظهر أي بيانات متوقعة في أي سطح تسجيل مدعوم.
- يتم تشغيل خيارات النشاط المطلوبة، ولكن لا يزال الحدث غائبا بعد فترة تحقق معقولة.
- نفس نوع النشاط غير متوفر باستمرار في عمليات فحص متعددة.
الخطوات التالية
إذا واجهت أي مشاكل، فنحن هنا للمساعدة. للحصول على المساعدة أو الدعم لقضية المنتج، يرجى فتح تذكرة دعم.