عام
س: هل يُنفذ نظام Brightspace سياسات الحصص أو قيود الاستخدام الأخرى مثل حدود المعدلات، لطلبات التمديد؟
ج: نعم ولا. بالنسبة إلى LTI Advantage 1.3، فإن نقاط نهاية LTI لخدمات الواجبات والعلامات (AGS) وخدمات تزويد أسماء وأدوار LTI (NRPS) محدودة المعدل تمامًا مثل واجهات برمجة تطبيقات Brightspace. ويستند تحديد المعدل على أساس كل تكامل، وليس على أساس كل مستخدم. كما أن نتائج LTI 1.1 القديمة ليست محدودة المعدل.
س: أتلقى رسالة ”422 كيان غير قابل للمعالجة“ عند إرسال درجة LineItem من أداة إلى Brightspace.
ج. تظهر رسالة الخطأ هذه عندما تحاول أداة إرسال درجة LineItem لدور المستخدم الذي لا يمكن وضع علامة له.
يتم التحكم في هذه الوظيفة عن طريق تمكين خيار إمكانية وضع علامات عليه في حقل العلامات في إعدادات دور المستخدم في أداة الأدوار والأذونات.
لجعل دور المستخدم قابلاً لوضع علامة عليه:
- من قائمة أدوات المسؤول، انقر فوق الأدوار والأذونات.
- من قائمة سياق الدور الذي تريد تحرير خصائصه، انقر فوق تحرير الإعدادات.
- في منطقة خيارات سلوك الأداة، حدد خانة الاختيار إمكانية وضع علامات عليه في حقل العلامات.
- انقر فوق حفظ وإغلاق.
المصادقة
س: أتلقى خطأ 404 عند محاولة إعادة التشغيل للعودة إلى منصة Brightspace.
ج: يجب تضمين جميع المعلمات (بما في ذلك الحالة الاختيارية) عند إجراء إعادة التشغيل لربط الطلب.
س: ما القيم المطلوبة في الرمز المميز للوصول إلى Oauth 2.0؟
ج: القيم التالية مطلوبة:
- iss: معرف فريد للكيان الذي أصدر JWT. قيمة client_id من المنصة. مماثل لـ sub.
- sub: مماثل لـ iss، قيمة client_id لـ Oauth من المنصة.
- aud: معرف (معرفات) الخادم المخول (الذي توفره المنصة).
- iat: الطابع الزمني لوقت إنشاء JWT.
- exp: الطابع الزمني لوقت التعامل مع JWT على أنه منتهي الصلاحية.
- jti: معرِّف فريد (يُحتمل أن يكون قابلاً لإعادة الاستخدام) للرمز المميز.
المصدر: استخدام رموز JSON المميزة على الويب مع منح بيانات اعتماد عميل OAuth 2.0
س: هل تدعم Brightspace المفاتيح العامة والخاصة من الأداة؟
ج: لا، يدعم Brightspace مجموعة مفاتيح JWK الخاصة بالأداة فقط.
س: أتلقى خطأ "error_description": "Error validating assertion: KeyId not found in token".
ج: يدعم Brightspace مسارات JWKS الخاصة بالأداة. يجب أن يكون المفتاح محاطًا بمجموعة مفاتيح وفق معيار JWKS.
س: أتلقى خطأ "error":"invalid_client".
ج: يجب أن يكون iss هو معرف العميل نفسه مثل sub. راجع وثائق مطالبات نقطة نهاية الرمز المميز والخدمات الخاصة بـ IMS Global لمزيد من التفاصيل.
س: عند طلب رمز مميز للوصول لخدمة LTI، أتلقى رسائل الفشل التالية:
- {"error":"invalid_grant","error_description":"Client is not authorized to set a 'kid' claim"}
- {"error":"invalid_grant","error_description":"Error validating assertion: KeyId not found in token"}
ج: يجب تضمين مطالبة Kid في الرأس فقط، وليس في البيانات الأساسية.
س: يتعذر في بعض الأحيان إرسال طلب إلى خدمة المصادقة مع ظهور خطأ غير معروف، مثل:
{"error":"server_error","error_description":"An unexpected exception occurred"}
ج: يتم طرح هذا الخطأ من قِبل خدمة المصادقة الخاصة بنا، وقد يكون من الصعب تصحيحه. عادةً ما تكون الأخطاء أكثر وضوحًا، لكن في الحالات التي لا تكون فيها كذلك، فإن أفضل خيار هو أن تسترد الأداة الطلب وترسله إلينا لتصحيح المشكلة.
س: هل تدعم المنصة GET أو POST لتخويل عناوين URL لإعادة التوجيه؟
ج: كل من GET وPOST أسلوبان مدعومان
س: هل تدعم المنصة المفاتيح العامة التي تُستخدم لمرة واحدة أو عنوان URL لـ JWKS؟
ج: يدعم Brightspace استخدام عناوين URL لـ JWKS لكلا مفتاحَي المنصة ولاسترداد المفاتيح من الأداة.
س: ما خوارزميات التوقيع المدعومة؟
ج: RS256 هي الخوارزمية المدعومة.
س: ما حجم المفتاح المدعوم: 1024 أم 2048؟
ج: 2048 هو حجم المفتاح المدعوم.
س: ما نقطة نهاية استرداد الرمز المميز للمنصة؟
ج: عنوان URL للرمز المميز للوصول إلى Brightspace OAuth2:https://auth.brightspace.com/core/connect/token
س: أتلقى خطأ طلب غير صالح.
ج: تحقق من سجل نظام D2L لأي من الرسائل التالية:
- تلميح رسالة غير صالح: التلميح غير موجود.
- انتهت صلاحية تلميح الرسالة: انتهت صلاحية هذا التلميح. للتلميحات إطار زمني لانتهاء الصلاحية قدره عشر دقائق لتسجيل الدخول الأولي.
- تعذر تحليل تلميح الرسالة: لا يحتوي التلميح على التنسيق الصحيح. راجع مواصفات معلمات تسجيل الدخول lti_message_hint لمزيد من التفاصيل.
خدمة الواجبات والعلامات
س: ما نوع منحة OAuth 2.0 الذي تدعمه المنصة لخدمة الواجبات والعلامات؟
ج: نتبع مواصفات الأمان من IMS Global: استخدام رموز JSON المميزة على الويب مع منح بيانات اعتماد عميل OAuth 2.0.
س: تُرجع أداتي علامة، لكن لا يتم تحديث دفتر العلامات.
ج: تعكس أداة العلامات فقط الدرجات التي تم الحصول عليها من الأداة التي تكون حالتها تم وضع علامة عليها بالكامل.
س: يفشل تمرير LineItem لديَّ أو لا يتم إنشاؤه عند إضافته عبر Insert Stuff.
ج: سيفشل تمرير عنصر السطر عند استخدام ISF أو الربط لموضوع معين داخل محرر HTML. يعمل تمرير عنصر السطر عند إنشاء موضوع محتوى LTI باستخدام الارتباط السريع الخاص بالربط لموضوع معيّن.
يوصي D2L بإنشاء موضوع محتوى LTI باستخدام الارتباط السريع الخاص بالربط لموضوع معيّن بدلاً من تضمينه داخل ملف HTML.
س: أتلقى رسالة الخطأ التالية: ”لا يمكن إقران LineItem بمعرف ارتباط مورد context_launch الخاص بالأداة البرمجية“.
ج: سيتم قبول LineItems المستقلة، لكن لا يمكن إقران LineItem بأداة برمجية في Brightspace.
الأسماء والأدوار
س: لا أتلقى مستخدمين غير معروفين لأداتي من قائمة الصفوف عند استخدام ملحق الأسماء والأدوار.
ج: قد تؤثر الأسباب التالية في كيفية اختيار المنصة لإرسال المستخدمين:
- زر التبديل ”إرسال المستخدمين غير معروفين“: السبب الواضح هو زر التبديل على مستوى النشر الذي يحدد ما إذا كان مسموحًا للأداة باستقبال المستخدمين الذين لا تعرفهم بالفعل. بدءًا من الإصدار 20.20.11 لـ Brightspace، إذا كانت ”قائمة الصفوف تتضمن مستخدمين غير معروفين لعملية النشر هذه“، فسينشئ طلب NRPS من الأداة LTI UserId تلقائيًا لأي مستخدم لم يشغل ارتباط LTI في Brightspace مطلقًا.
- بنية أسلوب GET: اعتمادًا على أداتك، من الممكن طلب قائمة الصفوف في العروض التي تمت تصفيتها ولا تطلب ”جميع المستخدمين“. يجب أن تضمن الأدوات تنظيم طلبك للحصول على أي مستخدمين في مقرر تعليمي معين عبر استدعاء واجهة برمجة التطبيقات للأسماء والأدوار.
الربط لموضوع معيّن
س: أتلقى رسالة الخطأ "IDX10511: Signature validation failed".
ج: في هذه الحالة، بدأت الوحدات النمطية بـ 00. ثمة خطأ في .NET غير قادر على معالجة هذا وتجب إزالة البايت الإضافي قبل الترميز.
س: أرجعتني إعادة النشر في أثناء سير عمل الربط لموضوع معيّن إلى خطأ داخلي أو خطأ 500.
ج: يجب تضمين مطالبة KID في رأس JWT.
س: يفشل إرجاع الربط لموضوع معيّن من دون ظهور أي خطأ.
ج: تحقق دائما من سجل النظام. ستظهر معلومات إضافية بما في ذلك الرسالة في سجل النظام للمساعدة على استكشاف المشكلة وإصلاحها. على سبيل المثال: يعني ”تعذر العثور على المفتاح العام مع المعرِّف“ إلى أن مطالبة KID في JWT لا تظهر في JWKS.
س: أتلقى طلبًا غير صالح عند إعادة إرسال البيانات من أداتي.
ج: تنتهي صلاحية تلميح الرسالة بعد ست ساعات. إذا كنت تستخدم الأداة لمدة تزيد على ست ساعات قبل إرجاع البيانات، فستنتهي صلاحية تلميح الرسالة وينتج عن ذلك طلب غير صالح.
واجهة برمجة تطبيقات الترحيل
س: لديّ أداة برمجية مخصصة تستخدم LTI الإصدار 1.1. هل يمكنني ترحيله باستخدام واجهة برمجة التطبيقات إلى LTI 1.3؟
ج: لا، نوصي بإعادة إنشاء الأداة البرمجية باستخدام سير عمل موضع LTI الإصدار 1.3.