ב-Canvas, ניתן ליצור מפתחות פיתוח משני סוגים: מפתחות LTI ומפתחות API. הוראות אלה מתייחסות למפתחות פיתוח של LTI. רוצה ליצור מפתחות פיתוח של API? דלג למפתחות פיתוח של API עבור Canvas

Ally משתמשת ב-LTI לשילוב עם מערכת Learning Management System ‏(LMS) שלך. LTI הוא תקן שפותח על-ידי IMS Global לצורך יצירת שילובים מאובטחים וחלקים.

התקן מאפשר למשתמשים לגשת ל-Ally מבלי לצאת מ-Canvas. כבר אין צורך להיכנס לאתרים מרובים: LTI מאפשר החלפת מידע מאובטחת, דבר היוצר חוויה מגובשת עבור המשתמשים שלך.

יש שתי גרסאות של LTI:‏ v1.1 ו-v1.3. כל גרסה דורשת לבצע שלבי קביעת תצורה שונים. הגרסה העדכנית היא LTI v1.3. ההבדל העיקרי לעומת גרסאות קודמות הוא מודל האבטחה המשודרג המבוסס על OAuth2,‏ OpenID Connect ו-JSON Web Tokens.

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 ועבור אל מפתחות פיתוח.
  2. בחר את הלחצן + מפתח פיתוח ובחר מפתח LTI.
    Developer Keys page on a Canvas environment. The + Developer Key button is expanded showing the LTI Key option.
    מסך קביעת הגדרות מפתח נפתח.
  3. בחר את התפריט שיטה ובחר הדבק 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. העתק קישור זה והדבק אותו בשדה מזהי ה-URI לניתוב מחדש. החלף את [AllyEnvironment] בפרטי הסביבה שבה מוסד הלימודים שלך מתארח. 
    • https://<AllyEnvironment>/api/v2/auth/lti/1.3/callback
  7. ספק שם מפתח.

    כלול את השם של הכלי ו-LTI 1.3 בכל אחד מהם. לדוגמה: דוח של מוסד של Ally - ‏LTI 1.3, דוח נגישות של קורס של Ally -‏ LTI 1.3 ותצורת לקוח של Ally -‏ LTI 1.3.

  8. בחר שמור. המפתח החדש מתווסף לדף מפתחות פיתוח והוא כבוי כברירת מחדל.
  9. הפעל את המפתח החדש.
  10. העתק את מספר מזהה המפתח ואת הסוד בעמודה פרטים. מספר מזהה מפתח זה הוא מזהה הלקוח הייחודי שלך.

סביבת 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. מחשבון הבסיס, בחר הגדרות.
  2. בחר אפליקציות והצגת תצורת אפליקציה.
  3. בחר את לחצן הוספת אפליקציה.
  4. מהתפריט סוג תצורה, בחר לפי מזהה לקוח.
  5. הדבק את מספר המזהה של מפתח הלקוח שנתת לצוות התמיכה של Ally בשדה מזהה לקוח.
  6. בחר שלח.
  7. בחר התקן.
  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, עבור אל מנהל מערכת ובחר חשבון.
  2. בחר ערכות נושא.
  3. הצבע על ערכת הנושא הפעילה ובחר פתח בעורך ערכות הנושא.
  4. בחר את הכרטיסייה העלאה.
  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. בחר החל ערכת נושא.