تمرين - استخدام graph API مِن موصل مخصص

مكتمل

في هذا التمرين، ستقوم بإنشاء موصل مخصص ومعرفة كيفية تكوينه للوصول إلَى Microsoft Graph API باستخدام مصادقة Microsoft Entra ID. نظراً لأن التركيز ينصب عَلى المصادقة، فإن هذا التمرين يقوم بتكوين إجراء واحد فقط يسمى آخر استخدام.

هام

استخدم بيئة اختبار مع توفير Microsoft Dataverse. إذا لم يكن لديك واحد، فيمكنك الاشتراك فِي خطة المجتمع.

المهمة 1: إنشاء حل جديد

لإنشاء حل جديد، اتبع هذه الخطوات:

1. انتقل إلَى Power Apps maker portal وتأكد مِن وجودك فِي البيئة الصحيحة.

2. حدّد الحلول > + حل جديد.

3. أدخل الرسم البياني Contoso لـ اسم العرض، وحدّد ناشر CDS الافتراضي لـ الناشر، ثم حدّد إنشاء. ملاحظة: عند العمل باستخدام مشروع حقيقي، فمن الأفضل إنشاء ناشر مخصص خاص بك.

   

4. لا تخرج مِن هذه الصفحة بعد تحديد إنشاء.

المهمة 2: استخدام مستكشف Graph لاختبار API

في هذه المهمة، ستستخدم "مستكشف Graph" لتنفيذ إجراء API الذي ستقوم بتكوينه فِي الموصل المخصص.

1. في علامة تبويب مستعرض جديد آخر، انتقل إلَى مستكشف Graph‏.

2. حدّد تسجيل الدخول.

   

3. سجّل الدخول بمعلومات المستخدم الخاصة بك.

4. اقرأ الأذونات المطلوبة ثم تابع إذا وافقت.

5. تأكد مِن تحديد GET للفعل، وأضف /insights/used إلَى عنوان URL، ثم حدّد تشغيل الاستعلام.

   

6. يجب أن تحصل عَلى خطأ 403 يشير إلَى أن مستكشف Graph يفتقر إلَى إذنك للقيام بهذا الإجراء.

7. حدّد علامة التبويب تعديل الأذونات لمنح مستكشف Graph الإذن.

8. حدّد Consent لـ Sites.Read.All.

9. اقرأ الأذونات المطلوبة ثم تابع إذا وافقت.

10. حدّد تشغيل الاستعلام مرة أخرى.

    يجب أن تحصل الآن عَلى الحالة OK - 200.

    

11. ابدأ علامة تبويب جلسة عمل استعراض جديدة.

12. انتقل إلَى مساحة التخزين الشخصية عَلى السحابة عَلى OneDrive وقم بتسجيل الدخول.

13. حدّد + جديد ثم حدّد مستند Word. أنت تقوم بإنشاء هذا المستند بحيث يكون لديك بعض المحتوى فِي قائمة آخر استخدام.

    

14. أدخل نص اختبار فِي ملف Word. سيتم حفظ المستند تلقائياً.

15. ارجع إلَى مستكشف Graph.

16. قم بتشغيل الاستعلام نفسه مرة أخرى.

    يجب أن تحصل الآن عَلى استجابة تحتوي عَلى قيم. إذا كنت لا ترى ردًا، فارجع إلَى المستند الذي قمت بإنشائه فِي OneDrive وقم بإجراء التغييرات، ثم ارجع وقم بتشغيل الاستعلام مرة أخرى.

17. حدّد الاستجابة JSON، وانقر بزر الماوس الأيمن، وحدّد نسخ، ثم احفظها.

    

    ستحتاج إلَى هذه الاستجابة لاحقاً فِي هذا التمرين لأنك ستستخدمها عند تكوين الاستجابة فِي الموصل المخصص.

المهمة 3: تسجيل تطبيق جديد إضافة الأذونات

في هذه المهمة، ستقوم بتكوين تطبيق جديد سيتم استخدامه للوصول إلَى Graph API مِن الموصل المخصص. ستقوم أيضاً بتكوين الأذونات للإجراءات المحدّد لـ API الخاصة بالرسم البياني، عَلى غرار ما حدث عندما قمت بتعديل الأذونات فِي مستكشف Graph.

1. انتقل إلَى Microsoft Azure وسجّل الدخول باستخدام بيانات اعتماد المستخدم المسؤول الخاصة بك.

2. حدّد إظهار قائمة المدخل، ثم حدّد Microsoft Entra ID.

   

3. حدّد تسجيل التطبيق > + تسجيل جديد.

   

4. أدخل معرفة آخر موصل تم استخدامه لـ الاسم وحدّد الويب أدخل https://global.consent.azure-apim.net/redirect لـ إعادة توجيه URI ثم حدّد تسجيل.

   

5. حدّد أذونات API ثم حدّد + إضافة إذن.

6. حدّد Microsoft Graph.

7. حدّد الأذونات المفوضة.

8. ابحث عن المواقع ثم قم بتوسيع المواقع.

9. حدّد Sites.Read.All، Sites.ReadWrite.All، ثم حدّد إضافة أذونات.

   

10. يجب أن يكون لديك الآن ثلاثة أذونات API. حدّد الشهادات والأسرار.

    

11. حدّد + سر عميل جديد.

    

12. أدخل إجراء آخر موصل تم استخدامه لـ الوصف، وحدّد 90 يومًا لـ ينتهي، ثم حدّد إضافة.

13. انسخ القيمة واحفظها لوقت لاحق لأنها لن تظهر مرة أخرى. ستستخدم سر المستخدم هذا عند إنشاء الموصل.

    

14. حدّد نظرة عامة.

15. انسخ معرف التطبيق (العميل) واحفظه فِي المفكرة. ستستخدم معرف العميل هذا عند إنشاء الموصل.

    

المهمة 4: إنشاء موصل مخصص

اتبع الخطوات التالية لإنشاء موصل مخصص:

1. انتقل إلَى مدخل مسؤول Power Apps وتأكد مِن وجودك فِي البيئة الصحيحة.

2. حدّد الحلول ثم حدّد لفتح حل الرسم البياني Contoso الذي قمت بإنشائه فِي المهمة 1: إنشاء حل جديد.

3. حدّد + جديد > تنفيذ تلقائي > موصل مخصص.

   

4. أدخل الرسم البياني Contoso لـ اسم الموصل.

   

5. مرر لأسفل، وأدخل graph.microsoft.com لـ المضيف و/v1.0 لـ عنوان URL الأساسي.

6. حدّد الأمان.

   

7. حدّد OAuth 2.0 لـ المصادقة.

8. حدّد Microsoft Entra ID لـ موفر الهوية.

9. الصق المعرف الذي نسخته مِن Azure فِي الحقل معرف العميل ثم الصق القيمة التي نسختها مِن Azure فِي الحقل سر العميل.

10. أدخل https://graph.microsoft.com لـ عنوان URL للمورد ثم حدّد إنشاء موصل.

    

11. لا تخرج مِن هذه الصفحة.

المهمة 5: إضافة إجراء

في هذه المهمة، ستقوم بتكوين تلميح آخر إجراء تم استخدامه المسمى Graph API.

1. حدّد التعريف> + إجراء جديد.

   

2. أدخل آخر استخدام لـ ملخص وLastUsed لـ معرف العملية.

3. انتقل إلَى قسم الطلب وحدّد + استيراد مِن العينة.

   

4. حدّد Get مِن أجل الفعل، وأدخل /me/insights/used لـ عنوان URL، ثم حدّد استيراد.

5. مرر لأسفل وحدّد الاستجابة الافتراضية.

   

6. حدّد + استيراد مِن العينة.

   

7. الصق الاستجابة التي قمت بنسخها مِن مستكشف Graph فِي حقل النص الأساسي ثم حدّد استيراد.

   

8. حدّد تحديث الموصل.

9. لا تخرج مِن هذه الصفحة.

المهمة 6: اختبار الموصل

اتبع الخطوات التالية لاختبار الموصل:

1. حدّد علامة التبويب اختبار، ثم حدّد + اتصال جديد.

   

2. قم بتقديم بيانات الاعتماد الخاصة بك.

3. اقرأ الأذونات المطلوبة ثم تابع.

4. حدّد تحديث الاتصالات.

5. حدّد اختبار العملية.

   

   يجب أن تشاهد الحالة 200، ويجب أن تبدو الاستجابة كما فِي الصورة التالية.