إعدادات الأمان لـ LTI 1.1/1.0
تحدد حقول خانات الاختيار الموجودة على شاشة مستهلك الأداة ما إذا كانت إعدادات أمان محددة ستظهر عندما يقوم المستخدم بإنشاء ارتباط أداة التعلّم الخارجية أو تحريره. وكل إعداد أمان مسؤول عن إرسال بيانات سياق محددة في وقت التشغيل.
- يحدد السماح بإرسال معلومات مستهلك الأداة إلى موفر الأداة ما إذا كان تضمين متغيرات tool_consumer مسموحًا به في تشغيل LTI.
- يحدد السماح بإرسال معلومات السياق إلى موفر الأداة ما إذا كانت متغيرات السياق مضمنة في تشغيل LTI. يؤثر هذا بشكل خاص في المتغيرات context_id وcontext_title وcontext_label وcontext_type.
- يحدد السماح بإرسال معلومات المقرر التعليمي إلى موفر الأداة ما إذا كان يمكن تضمين معلومات سياق المقرر التعليمي في عملية التشغيل. ويمثل المعلمتان lis_course_offering_sourcedid وlis_course_section_sourcedid. ملاحظة: ستكون قيمة المقطع هي نفسها قيمة lis_course_offering_sourcedid.
- يحدد السماح بإرسال معرِّف المستخدم إلى موفر الأداة ما إذا كانت قيمة user_id المبهمة للمستخدم الحالي مضمنة في تشغيل LTI. وإذا تم تضمين User_Id، فستقوم Brightspace بإنشاء قيمة GUID فريدة يتم إرسالها بوصفها user_id. وتكون قيمة GUID هذه ثابتة في كل عملية تشغيل يتم إجراؤها بواسطة مستخدم محدد، ولكنها لا توفر أي وسيلة يمكن بها لجهة خارجية تحديد هوية المستخدم.
- يحدد السماح بإرسال اسم المستخدم إلى موفر الأداة ما إذا كانت قيم اسم المستخدم مسموحًا بها ضمن LTI post. ويتم ملء هذه القيم باستخدام الاسم الأول واسم العائلة للمستخدم كما تم إدخالهما في ملف تعريف المستخدم في Brightspace.
- يحدد السماح بإرسال البريد الإلكتروني للمستخدم إلى موفر الأداة ما إذا كان حقل البريد الإلكتروني متوفرًا ليتم تضمينه في تشغيل LTI. ويتم ملء هذه القيمة من خاصية البريد الإلكتروني الخاصة بخاصية البريد الإلكتروني للمستخدم الحالي.
- يحدد السماح بإرسال اسم مستخدم النظام إلى موفر الأداة ما إذا كان حقل اسم المستخدم متوفرًا ليتم تضمينه في تشغيل LTI.
- يحدد السماح بإرسال معرِّف الوحدة التنظيمية المحدد الخاص بالنظام إلى موفر الأداة ما إذا كان حقل OrgDefinedId متوفرًا ليتم تضمينه في تشغيل LTI. هذا الحقل ليس حقل LTI قياسيًا. يتم ملؤه باستخدام خاصية OrgDefinedId الخاصة بالمستخدم الحالي.
- يحدد السماح بإرسال دور النظام إلى موفر الأداة ما إذا كان حقل دور D2L المخصص متوفرًا ليتم تضمينه في تشغيل LTI. هذا ليس حقل دور LTI قياسيًا. ويتم ملؤه باسم دور المستخدم في سياق الوحدة التنظيمية التي يحدث منها تشغيل LTI. يختلف هذا عن حقل الأدوار القياسية الذي يحتوي دائمًا على قيمة دور LTI صالحة.
- يحدد السماح بإرسال عنوان الارتباط إلى موفر الأداة ما إذا كان اسم ارتباط أداة التعلّم الخارجية مضمنًا في تشغيل LTI.
- يحدد السماح بإرسال وصف الارتباط إلى موفر الأداة ما إذا كان الوصف الموجود ضمن ارتباط أداة التعلّم الخارجية مضمنًا في تشغيل LTI.
- يحدد السماح بإرسال كود المقطع إلى موفر الأداة ما إذا كان يمكن تضمين كود مقطع المقرر التعليمي في عملية التشغيل. وهو lis_course_section_sourcedid. ملاحظة: في حال عدم تحديد الإعداد، ولكن كان السماح بإرسال معلومات المقرر التعليمي مسموحًا به، سيتم إرسال المقطع بقيمة lis_course_offering_sourcedid نفسها. عند تحديد الإعداد، تعمل أي عملية تشغيل مقترنة بهذا الارتباط/الأداة بالطريقة الآتية:
- في حال عدم وجود مقاطع: أرسل lis_course_section_sourcedid = lis_course_offering_sourcedid
- في حال وجود مقطع واحد:
- تحقق من تسجيل المستخدم، وإذا كان مسجلاً في المقطع فأرسل lis_course_section_sourcedid = كود مضمون المقرر التعليمي للمقطع
- إذا لم يكن مسجلاً في المقطع فأرسل lis_course_section_sourcedid = lis_course_offering_sourcedi
- في حال وجود أكثر من مقطع واحد:
- تحقق من تسجيل المستخدم
- إذا كان مسجلاً في مقطع واحد فأرسل lis_course_section_sourcedid = كود مضمون المقرر التعليمي للمقطع
- إذا لم يكن مسجلاً في أي مقطع فأرسل lis_course_section_sourcedid = lis_course_offering_sourcedid
- إذا كان مسجلاً في مقاطع متعددة فأرسل lis_course_section_sourcedid = كود مضمون المقرر التعليمي للمقطع الخاص بالتسجيل الأول
- بناءً على اسم المقطع - أبجديًا
لفهم البيانات التي ترسلها Brightspace، استخدم الخريطة أدناه:
| POS لاسم عنصر التحكم في واجهة المستخدم |
معلمة نموذج POST |
نموذج القيمة |
الوصف |
|---|
| إرسال معلومات مستهلك الأداة إلى موفر الأداة |
tool_consumer_instance_guid |
secret |
قيمة المفتاح التي تم تعيينها في صفحة معلومات مستهلك أداة المؤسسة. |
| إرسال معلومات مستهلك الأداة إلى موفر الأداة |
tool_consumer_instance_name |
Partners |
قيمة الاسم التي تم تعيينها في صفحة معلومات مستهلك أداة المؤسسة. |
| إرسال معلومات مستهلك الأداة إلى موفر الأداة |
tool_consumer_instance_description |
Global tools description |
قيمة الوصف التي تم إدخالها في صفحة معلومات مستهلك أداة المؤسسة. |
| إرسال معلومات مستهلك الأداة إلى موفر الأداة |
tool_consumer_instance_contact_email |
admincontact@ educationtest.com |
قيمة عنوان البريد الإلكتروني التي تم إدخالها في صفحة معلومات مستهلك أداة المؤسسة. |
| إرسال معلومات مستهلك الأداة إلى موفر الأداة |
tool_consumer_info_version |
10.8.3.0 |
رقم إصدار منصة Brightspace. |
| إرسال معلومات مستهلك الأداة إلى موفر الأداة |
tool_consumer_info_product_family_code |
desire2learn |
كود المنتج أو الإشارة إلى Brightspace التي تحدد المنصة لموفر الأداة. |
| إرسال معلومات السياق إلى موفر الأداة |
context_id |
8631 |
معرِّف الوحدة التنظيمية التي تأتي منها عملية التشغيل. عادةً ما يكون هذا هو معرِّف المقرر التعليمي ولكن يمكنك أيضًا استخدام قالب أو مقطع أو مجموعة. |
| إرسال معلومات السياق إلى موفر الأداة |
context_label |
Math 101 |
كود الوحدة التنظيمية التي تأتي منها عملية التشغيل. عادةً ما يكون هذا هو كود المقرر التعليمي. |
| إرسال معلومات السياق إلى موفر الأداة |
context_title |
Math 101 |
عنوان الوحدة التنظيمية التي تأتي منها عملية التشغيل. عادةً ما يكون هذا هو عنوان المقرر التعليمي. |
| إرسال معلومات السياق إلى موفر الأداة |
context_type |
CourseOffering |
اسم نوع الوحدة التنظيمية لعملية التشغيل. عادةً ما يكون هذا "CourseOffering" للإشارة إلى مقرر تعليمي. |
| إرسال معلومات المقرر التعليمي إلى موفّر الأداة |
lis_course_offering_sourcedid |
partners.brightspace.com:math101 |
يحتوي على معرِّف المقرر التعليمي في LIS مع عملية التشغيل هذه. |
| إرسال معلومات المقرر التعليمي إلى موفّر الأداة |
lis_course_section_sourcedid |
partners.brightspace.com:math101 |
يحتوي على معرِّف مضمون المقرر التعليمي في LIS مع عملية التشغيل هذه. ويتوفر خيار لإرسال كود مقطع المقرر التعليمي لعمليات تشغيل 1.1. |
| إرسال معرِّف مستخدم LTI وقائمة دور LTI إلى موفّر الأداة |
user_id |
ca5578d1-ee6a-434a-840d-405d7cc0b9b7_168 |
معرِّف فريد غير شفاف (يخضع التنسيق للتغيير) للمحتوى. |
| إرسال معرِّف مستخدم LTI وقائمة دور LTI إلى موفّر الأداة |
roles |
urn:lti:instrole:ims/lis/Instructor |
لائحة الأدوار التي تم تعيين المستخدم إليها. يتعلق هذا بأداة تعيين أدوار IMS داخل Brightspace (ما يسمح بتعيينات أدوار واحد إلى متعدد). |
| إرسال اسم المستخدم إلى موفر الأداة |
lis_person_name_given |
John |
الاسم الأول للمستخدم المنشط. |
| إرسال اسم المستخدم إلى موفر الأداة |
lis_person_name_family |
Snivy |
اسم العائلة للمستخدم المنشط. |
| إرسال اسم المستخدم إلى موفر الأداة |
lis_person_name_full |
John Snivy |
الاسم الكامل للمستخدم المنشط. |
| إرسال البريد الإلكتروني للمستخدم إلى موفر الأداة |
lis_person_contact_email_primary |
john.snivy@educationtest.com |
البريد الإلكتروني للمستخدم المنشط. |
| إرسال اسم مستخدم النظام إلى موفر الأداة |
ext_d2l_username |
John.Snivy |
يرسل اسم المستخدم الخاص بالمستخدم. ويختلف هذا عن اسم المستخدم (الاسم الأول واسم العائلة). |
| إرسال معرِّف المؤسسة المحدد الخاص بالنظام إلى موفر الأداة |
ext_d2l_orgdefinedid |
1089679 |
معرِّف الوحدة التنظيمية المحدد هو حقل خاص بـ Brightspace، لذلك لا يظهر في مواصفات IMS. وعادةً ما يكون هذا معرِّفًا فريدًا للمستخدم يحدده مستهلك الأداة. يؤدي تمكينه إلى إرسال معرِّف الوحدة التنظيمية المحدد الخاص بالمستخدم في الحقل. |
| إرسال دور النظام إلى موفر الأداة |
ext_d2l_role |
Section Instructor |
على عكس حقل الأدوار السابق، يرسل هذا الحقل اسم دور Brightspace. ويتضمن هذا دورًا واحدًا فقط ولا يتطابق مع الأدوار المدعومة من IMS لأنه دورها المحدد داخل نظام إدارة التعلّم. |
| إرسال عنوان الارتباط إلى موفر الأداة |
resource_link_title |
Week 1 Math Assignment |
يرسل اسم ارتباط LTI وعنوانه كما هو موجود داخل نظام إدارة التعلّم. وقد يتغير هذا على مدى مدة بقاء الارتباط. |
| إرسال وصف الارتباط إلى موفر الأداة |
resource_link_description |
ارتباط LTI للمسؤول المستخدم لاستكشاف الأخطاء وإصلاحها |
إذا تم توفير وصف لارتباط LTI، فسيظهر هنا. |
نموذج طلب لتشغيل 1.0
يرد أدناه مثال يوضح الشكل الذي يمكن أن يبدو عليه طلب LTI قديم صادر من Brightspace، مع تمكين جميع إعدادات الأمان:
<html>
<body>
<div id="ltiLaunchFormSubmitArea">
<form method="post" id="LtiRequestForm" name="LtiRequestForm" action="http://ltiapps.net/test/tp.php"" enctype="application/x-www-form-urlencoded">
<input type="hidden" name="custom_userid" value="169">
<input type="hidden" name="lis_result_sourcedid" value="a573f15a-cec3-418f-ab3c-1f36e7d87430">
<input type="hidden" name="ext_d2l_token_id" value="5306288">
<input type="hidden" name="ext_d2l_link_id" value="144437">
<input type="hidden" name="ext_d2l_token_digest" value="ajBeRQMIratFlRyB8mTL8vnsQxU=">
<input type="hidden" name="ext_completion_url" value="">
<input type="hidden" name="launch_presentation_locale" value="EN-US">
<input type="hidden" name="tool_consumer_instance_guid" value="secret">
<input type="hidden" name="tool_consumer_instance_name" value="Partners">
<input type="hidden" name="tool_consumer_instance_description" value="admincontact@educationtest.com">
<input type="hidden" name="tool_consumer_instance_contact_email" value="">
<input type="hidden" name="tool_consumer_info_version" value="10.8.3.0">
<input type="hidden" name="tool_consumer_info_product_family_code" value="desire2learn">
<input type="hidden" name="context_id" value="8631">
<input type="hidden" name="context_title" value="Math 101">
<input type="hidden" name="context_label" value="Math 101">
<input type="hidden" name="context_type" value="CourseOffering">
<input type="hidden" name="user_id" value="ca5578d1-ee6a-434a-840d-405d7cc0b9b7_111">
<input type="hidden" name="roles" value="urn:lti:instrole:ims/lis/Instructor">
<input type="hidden" name="lis_person_name_given" value="John">
<input type="hidden" name="lis_person_name_family" value="Snivy">
<input type="hidden" name="lis_person_name_full" value="John Snivy">
<input type="hidden" name="lis_person_contact_email_primary" value="john.snivy@educationtest.com">
<input type="hidden" name="ext_d2l_username" value="John.Snivy">
<input type="hidden" name="ext_d2l_orgdefinedid" value="">
<input type="hidden" name="ext_d2l_role" value="Section Instructor">
<input type="hidden" name="ext_d2l_tenantid" value="41b632b6-ff74-4288-b3f1-7ffb6eb14bb4">
<input type="hidden" name="ext_tc_profile_url" value="https://partners.brightspace.com/d2l/api/ext/1.0/lti/tcservices">;
<input type="hidden" name="resource_link_title" value="Week 1 Math Assignment">
<input type="hidden" name="resource_link_id" value="">
<input type="hidden" name="resource_link_description" value="">
<input type="hidden" name="lis_outcome_service_url" value="https://partners.brightspace.com/d2l/le/lti/Outcome">;
<input type="hidden" name="lti_version" value="LTI-1p0">
<input type="hidden" name="lti_message_type" value="basic-lti-launch-request">
<input type="hidden" name="lis_course_offering_sourcedid" value="partners.brightspace.com:Jordan Snider Course 2">
<input type="hidden" name="lis_course_section_sourcedid" value="partners.brightspace.com:Jordan Snider Course 2">
<input type="hidden" name="oauth_version" value="1.0">
<input type="hidden" name="oauth_nonce" value="3bff529f-d941-424a-bb35-aa3e97a4c3b2">
<input type="hidden" name="oauth_timestamp" value="1513353415">
<input type="hidden" name="oauth_signature_method" value="HMAC-SHA1">
<input type="hidden" name="oauth_consumer_key" value="secret">
<input type="hidden" name="oauth_callback" value="about:blank">
<input type="hidden" name="oauth_signature" value="wyWXmyxWC/aegAd2PQ145l3t8Fs=">
<input type="submit" name="ext_basiclti_submit" value="Launch Endpoint with BasicLTI Data">
</form>