في Canvas، يمكنك إنشاء نوعين من مفاتيح المطورين: مفاتيح LTI ومفاتيح API. هذه الإرشادات خاصة بمفاتيح LTI للمطورين. هل تريد إنشاء مفاتيح API للمطورين؟ انتقل إلى مفاتيح API للمطورين في Canvas.

Ally تستخدم LTI للتكامل مع نظام إدارة التعلم (LMS) الخاص بك. LTI عبارة عن معيار وضعته IMS Global من أجل عمليات التكامل الآمنة والسلسة.

هذا المعيار يتيح للمستخدمين الوصول إلى Ally دون ترك Canvas. نسيان تسجيل الدخول إلى مواقع متعددة: يتيح LTI تبادلاً آمنًا للمعلومات التي تمكن المستخدمين من الحصول على تجربة متجانسة.

يوجد إصداران من LTI: الإصدار 1.1 والإصدار 1.3. يتطلب كل إصدار خطوات تكوين مختلفة. الإصدار الحالي هو LTI 1.3. الفرق الأكبر عن الإصدارات السابقة يتمثل في نموذج الأمان الذي تمت ترقيته استنادًا إلى الرموز المميزة لـ JSON Web وOAuth2 وOpenID Connect.

Ally تنتقل إلى LTI 1.3 للاستفادة من نموذج الأمان الذي تمت ترقيته.

ماذا يعني هذا بالنسبة لك؟ إذا كنت حديث العهد بـ Ally، فهذا لا يعني شيئًا. نحن نتولى إعداد تكامل Ally معك. ولكن إذا كانت بالفعل لديك Ally متكاملة مع نظام إدارة التعلم (LMS) الخاص بك، فستحتاج إلى إعادة تكوين التكامل الخاص بك باستخدام LTI 1.3.

إعادة تكوين تكامل Ally باستخدام LTI 1.3

أي مؤسسة نموذجية ستجعل أدوات Ally الثلاث هذه متوفرة في الحساب الجذر:

تحتوي كل أداة على مفتاح مطور LTI مقابل وتطبيق.

ستحتاج إلى تكوين كل أداة عن طريق اتباع هذه العملية:

  1. أنشئ مفتاح مطور LTI 1.3 لكل أداة.
  2. قم بإعداد كل تطبيق للأداة باستخدام معلومات مفتاح المطور.
  3. أرسل "معرف مفتاح المطور" و"معرف توزيع LTI" الخاصين بكل أداة إلى Ally من أجل التكوين. 
  4. قم بإزالة تكوين LTI 1.1.

    نفذ هذه الخطوة في آخر الأمر من أجل عملية انتقال سلسة دون انقطاع.

إنشاء مفتاح مطور LTI لكل أداة

  1. انتقل إلى الحساب الجذر لمثيل Canvas وانتقل إلى "Developer keys" (مفاتيح المطورين).
  2. حدد زر "+ Developer Key" (+ مفتاح مطور) وحدد "LTI Key" (مفتاح LTI).
    Developer Keys page on a Canvas environment. The + Developer Key button is expanded showing the LTI Key option.
    تفتح شاشة "Key Settings Configure" (تكوين إعدادات المفاتيح).
  3. حدد قائمة "Method" (الطريقة) وحدد "Paste JSON" (لصق JSON).
    The Method menu opened with the Paste JSON open highlighted.
  4. افتح URL لأداة LTI التي تقوم بإنشاء المفتاح لها من أجل إنشاء تكوين JSON.استبدل [AllyEnvironment] بـ معلومات البيئة التي تستضيف مؤسستك. 
    • تقرير المؤسسة: https://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/institution
    • تكوين العميل: https://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/config
    • تقرير إمكانية وصول ذوي الاحتياجات الخاصة إلى المقرر الدراسي: https://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/course
  5. انسخ المعلومات في صفحة الويب التي يتم فتحها.
  6. انسخ هذا الرابط والصقه في الحقل "Redirect URIs" (إعادة توجيه عناوين URL).استبدل [AllyEnvironment] بـمعلومات البيئة التي تستضيف مؤسستك. 
    • https://<AllyEnvironment>/api/v2/auth/lti/1.3/callback
  7. أعطِ اسمًا للمفتاح.

    قم بتضمين اسم الأداة وLTI 1.3 في كل منها. على سبيل المثال: Ally Institution Report LTI 1.3، وAlly Course Accessibility Report LTI 1.3، وAlly Client Configuration LTI 1.3.

  8. حدد "Save" (حفظ). تتم إضافة المفتاح الجديد إلى صفحة "Developer Keys" (مفاتيح المطورين) ويكون في وضع "OFF" (إيقاف التشغيل) بشكل افتراضي.
  9. قم بتشغيل المفتاح الجديد.
  10. انسخ رقم معرف المفتاح وكلمة السر الخاصة به في عمود "Details" (التفاصيل). رقم معرف المفتاح هذا هو معرف العميل الفريد الخاص بك.

بيئة Ally لمنطقتك

استخدم المعلومات الخاصة ببيئة Ally التي تستضيف مؤسستك.

  • مركز البيانات بالولايات المتحدة: prod.ally.ac
  • مركز البيانات الكندي: prod-ca-central-1.ally.ac
  • مركز البيانات الأوروبي: prod-eu-central-1.ally.ac
  • مركز البيانات السنغافوري: prod-ap-southeast-1.ally.ac
  • مركز البيانات الأسترالي: prod-ap-southeast-2.ally.ac

إعداد الأداة

اتبع الخطوات التالية لأدوات تقرير المؤسسة، وتكوين العميل، وتقرير إمكانية وصول ذوي الاحتياجات الخاصة إلى المقرر الدراسي.

  1. من الحساب الجذر حدد "Settings" (الإعدادات).
  2. حدد "Apps" (التطبيقات) و"View App Configuration" (عرض تكوين التطبيق).
  3. حدد الزر "Add an App" (إضافة تطبيق).
  4. من القائمة "Configuration Type" (نوع التكوين)، حدد "By Client ID" (حسب معرف العميل).
  5. الصق رقم معرف مفتاح العميل الذي أعطيته لفريق دعم Ally في حقل "Client ID" (معرف العميل).
  6. حدد "Submit" (إرسال).
  7. حدد "Install" (تثبيت).
  8. انسخ معرف توزيع LTI الخاص بكل أداة تقرير.

يظهر رابط جديد للأداة في قائمة التنقل اليمنى الخاصة بالروابط. بعد أن تقوم Ally بتكوين الأداة في نظام Ally، يمكنك الوصول إلى الأداة من هذا الرابط.

إرسال معرف المفتاح إلى Ally

انتقل إلى Behind the Blackboard وقم بإنشاء تذكرة حالة دعم باستخدام هذه المعلومات حتى يتمكن فريق Ally من تكوين الأدوات ضمن نظام Ally:

  • معرف مفتاح المطور لكل أداة
  • معرف توزيع LTI لكل أداة
  • طلب إعداد أدوات LTI 1.3

على سبيل المثال، مفتاح المطور لتقرير المؤسسة الخاص بي هو: #00000000000000000. معرف توزيع تقرير المؤسسة الخاص بي: 0000:00c00dc0ec00c00cdc000fced. يرجى إعداد تقرير LTI 1.3 الخاص بي.

يمكنك أن تكون لديك تقارير منفصلة للحسابات الفرعية المختلفة في بيئة Canvas الخاصة بك. انسخ معرف توزيع الحساب الفرعي وأضف تلك المعلومات إلى تذكرة الدعم أيضًا.

تحديث جزء التعليمة البرمجية المتكررة لـ Ally في سمة Canvas

بعد تكوين تقرير المؤسسة في Ally باستخدام LTI 1.3، قم بتحديث جزء التعليمة البرمجية المتكررة لـ Ally في سمة Canvas. يجب أن يكون هناك حقل 'lti13Id' مقابل لمعرف العميل لتقرير المؤسسة LTI 1.3 (معرف أداة Ally) المضاف.

  1. بصفتك مسؤول Canvas، انتقل إلى "Admin" (المسؤول) وحدد "Account" (الحساب).
  2. حدد "Themes" (السمات).
  3. وجّه المؤشر إلى السمة النشطة وحدد "Open in Theme Editor" (فتح في محرر السمات).
  4. حدد علامة التبويب "Upload" (رفع).
  5. في جزء التعليمة البرمجية المتكررة لـ Javascript، أضف الخاصية ltil3Id. استبدل [InstitutionalReportDeveloperKeyID] بمعرف مفتاح مطور تقرير المؤسسة الخاص بك.

    window.ALLY_CFG = {
     'baseUrl': 'https://prod.ally.ac',
     'clientId': 00000,
     'lti13Id': '<YourInstitutionalReportDeveloperKeyID>'
    };
    $.getScript(ALLY_CFG.baseUrl + '/integration/canvas/ally.js');

  6. حدد "Apply theme" (تطبيق السمة).