مفتاح المطور لـ Canvas هو بديل قوي لنهج الرمز المميز للوصول، حيث يمكن تمكين أي نقطة نهاية (نطاق) لـ Canvas REST أو تعطيلها من أجل عمليات التكامل.
لإعداد تكامل REST API، عليك إنجاز الخطوات التالية
- إنشاء مفتاح مطور API في بيئة Canvas الخاصة بك
- تكوين Ally باستخدام مفتاح مطور Canvas
إنشاء مفتاح مطور API
مفتاح API للمطورين في Canvas هو في الأساس مفتاح ID وزوج كلمات سر ممزوج مع تكوين نطاق محدد.
- انتقل إلى الحساب الجذر لمثيل Canvas وانتقل إلى "Developer keys" (مفاتيح المطورين).
- حدد زر "+ Developer Key" (+ مفتاح مطور) وحدد "API Key" (مفتاح API).
- قم بتقديم اسم المفتاح وعنوان البريد الإلكتروني للمالك.
- انسخ هذا الرابط والصقه في الحقل "Redirect URIs" (إعادة توجيه عناوين URL). استبدل [AllyEnvironment] بـمعلومات البيئة التي تستضيف مؤسستك. استبدل [ClientID] بمعرف العميل الخاص بك.
https://[AllyEnvironment]/api/v2/[ClientId]/auth/canvas/callback
- حدد مفتاح التبديل "Enforce Scopes" (فرض النطاقات) لتشغيلها.
- حدد خانة الاختيار "Allow Include Parameters" (السماح بتضمين المعلمات).
- قم بتمكين النطاقات التالية من الجدول:
تمكين هذه النطاقات اسم النطاق القسم url:GET|/api/v1/accounts الحسابات url:GET|/api/v1/accounts/:id الحسابات url:GET|/api/v1/accounts/:account_id/sub_accounts الحسابات url:GET|/api/v1/accounts/:account_id/courses الحسابات url:GET|/api/v1/courses/:course_id/assignments الواجبات url:GET|/api/v1/courses/:course_id/assignments/:id الواجبات url:PUT|/api/v1/courses/:course_id/assignments/:id الواجبات url:GET|/api/v1/courses/:course_id/blueprint_subscriptions المقررات الدراسية في المخطط url:GET|/api/v1/courses/:course_id/blueprint_subscriptions/:subscription_id/migrations المقررات الدراسية في المخطط url:GET|/api/v1/courses/:course_id/content_migrations ترحيلات المحتوى url:GET|/api/v1/courses/:id المقررات الدراسية url:PUT|/api/v1/courses/:id المقررات الدراسية url:POST|/api/v1/courses/:course_id/files المقررات الدراسية url:GET|/api/v1/courses/:course_id/discussion_topics موضوعات المناقشة url:GET|/api/v1/courses/:course_id/discussion_topics/:topic_id موضوعات المناقشة url:PUT|/api/v1/courses/:course_id/discussion_topics/:topic_id موضوعات المناقشة url:GET|/api/v1/accounts/:account_id/terms مدد التسجيل url:GET|/api/v1/courses/:course_id/files الملفات url:GET|/api/v1/courses/:course_id/files/:id الملفات url:PUT|/api/v1/files/:id الملفات url:DELETE|/api/v1/files/:id الملفات url:GET|/api/v1/courses/:course_id/media_objects كائنات الوسائط url:PUT|/api/v1/media_objects/:media_object_id كائنات الوسائط url:GET|/api/v1/media_objects/:media_object_id/media_tracks كائنات الوسائط url:PUT|/api/v1/media_objects/:media_object_id/media_tracks كائنات الوسائط url:GET|/api/v1/courses/:course_id/pages الصفحات url:GET|/api/v1/courses/:course_id/pages/:url_or_id الصفحات url:PUT|/api/v1/courses/:course_id/pages/:url_or_id الصفحات url:GET|/api/v1/courses/:course_id/quizzes الاختبارات الموجزة url:GET|/api/v1/courses/:course_id/quizzes/:id الاختبارات الموجزة url:PUT|/api/v1/courses/:course_id/quizzes/:id الاختبارات الموجزة - حدد "Save" (حفظ).
- تتم إضافة المفتاح الجديد إلى صفحة "Developer Keys" (مفاتيح المطورين) ويكون في وضع "OFF" (إيقاف التشغيل) بشكل افتراضي.
- قم بتشغيل المفتاح الجديد.
- انسخ رقم معرف المفتاح في عمود "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
تكوين Ally باستخدام مفتاح المطور
يجب أن تكون مسجلاً الدخول في كلٍ من بيئة Canvas الخاص بك وصفحة "Ally Configuration" (تكوين Ally) لديك.
- انتقل إلى صفحة تكوين Ally وحدد علامة التبويب "Canvas Developer Key" (مفتاح المطور لـ Canvas).
- حدد "Configure Ally with Canvas Developer Key" (تكوين Ally باستخدام مفتاح مطور Canvas).
- انسخ والصق المفتاح وكلمة السر الخاصين بمفتاح مطور API الذي أنشأته.
- حدد "Save and grant access" (حفظ ومنح إمكانية الوصول).
- حدد "Authorize" (تخويل) لمنح Ally الإذن لاستخدام مفتاح المطور لـ Canvas.
في الخلفية، ستشغل Ally فحصًا سريعًا (بسيطًا) لضمان إضافة النطاقات الصحيحة في مفتاح المطور لـ Canvas.
وإذا كانت الأمور تسير بشكل جيد، فلا بد أن يتم توجيهك مرة أخرى إلى أداة التكوين مع ظهور رسالة تقول إنه قد تم تكوين التكامل بشكل صحيح.