الخطوة 1 - تسجيل الاداة في Brightspace Brightspace
تُنفَّذ الخطوة الاولى بالكامل داخل Brightspace بواسطة مسؤول المنصة. ستسجل DrillBit كاداة خارجية جديدة بمعيار LTI 1.3، وتوجهها الى نقاط نهاية DrillBit، وتفعّل الامتدادات التي يحتاجها DrillBit، وتضيف معاملات الاستبدال التي تمرر سياق المقرر / المستخدم في كل تشغيل، وتنهي بحفظ Client ID المُنشأ للخطوة التالية.
1. فتح صفحة تسجيل LTI Advantage
- سجّل الدخول الى Brightspace بصفتك Administrator.
- افتح Admin Tools (ايقونة الترس في الشريط العلوي).
- اختر Manage Extensibility.
- انتقل الى علامة التبويب LTI Advantage.
- انقر فوق Register Tool واختر Standard عند سؤالك عن كيفية تسجيل الاداة.
2. ادخال نقاط نهاية DrillBit
في نموذج التسجيل، املأ الحقول التالية بعناوين DrillBit الدقيقة ادناه. وهي متطابقة لكل عملاء Brightspace:
| Name | Drillbit Plagiarism Tool |
|---|---|
| Description | Drillbit Plagiarism LTI Advantage Tool Provider |
| Domain | https://lti.drillbitplagiarismcheck.com |
| Redirect URLs | https://lti.drillbitplagiarismcheck.com/lti/launch |
| OpenID Connect Login URL | https://lti.drillbitplagiarismcheck.com/lti/login |
| Target Link URI | https://lti.drillbitplagiarismcheck.com/lti/launch |
| Keyset URL | https://lti.drillbitplagiarismcheck.com/lti/keyset |
تأكد من ان مفتاح Enabled في اعلى النموذج مُفعّل.
3. تفعيل الامتدادات المطلوبة
ضمن قسم Extensions، حدد الثلاثة جميعا:
- Assignment and Grade Services - يتيح لـ DrillBit اعادة نسب التشابه الى سجل الدرجات في Brightspace.
- Deep Linking - يتيح للاداة انشاء Quicklink الذي يرفقه المدرسون بمحتوى المقرر.
- Names and Role Provisioning Services - يتيح لـ DrillBit تحديد الطالب / المدرس وراء كل تشغيل.
ضمن Roles، فعّل Send Institution Role - يستخدمه DrillBit للتمييز بين المدرسين والطلاب.
4. اضافة معاملات الاستبدال
في قسم Substitution Parameters، اضف ازواج الاسم / القيمة التالية حتى تمرر Brightspace السياق الصحيح الى DrillBit في كل تشغيل:
| user_name | $User.username |
|---|---|
| user_id | $User.id |
| course_title | $CourseOffering.title |
| resource_title | $ResourceLink.title |
| resource_description | $ResourceLink.description |
| resource_start_time | $ResourceLink.available.startDateTime |
| resource_end_time | $ResourceLink.available.endDateTime |
| resource_submission_end_time | $ResourceLink.submission.endDateTime |
5. التسجيل ونسخ بيانات الاعتماد
- انقر فوق Register في اسفل النموذج.
- ستفتح Brightspace مربع حوار Brightspace Registration Details الذي يحتوي على Client ID مُنشأ وعناوين URL التي ستحتاجها من جانب DrillBit.
- انسخ كل قيمة ادناه - ستلصقها في DrillBit في الخطوة التالية:
- Client Id
- Brightspace Keyset URL
- Brightspace OAuth2 Access Token URL
- OpenID Connect Authentication Endpoint
- Brightspace OAuth2 Audience
- Issuer
احفظ Client ID في مكان امن قبل اغلاق مربع الحوار. يمكنك العودة الى Tool Details لنسخه مجددا، لكن الخطوة التالية (تهيئة DrillBit) لا يمكن ان تستمر بدونه.
اكتمل التسجيل. انتقل الى الخطوة 2 - تفعيل Brightspace داخل DrillBit لربط جانب DrillBit من التكامل.