إنشاء تطبيق IoT Central وإعداد رمز مميز لواجهة برمجة التطبيقات
لحماية تطبيق IoT Central الخاص بك، يجب تخويل جميع استدعاءات واجهة برمجة تطبيقات REST.
يتضمن حل إدارة الأسطول الحالي لشركة الخدمات اللوجستية تطبيق إدارة أسطول مع لوحات معلومات لإدارة المركبات. تخطط لإضافة تطبيق IoT Central لتلقي بيانات تتبع الاستخدام من أجهزة المراقبة في المركبات. سيمكّنك تطبيق IoT Central أيضاً من إدارة الأجهزة والتحكم فيها عن بُعد. الهدف هو استخدام واجهة برمجة تطبيقات IoT Central REST لدمج إدارة الجهاز في تطبيق إدارة الأسطول الحالي. يجب أن يتحقق تطبيق IoT Central لديك من أن مستخدم تطبيق إدارة الأسطول مُخول لإجراء استدعاءات واجهة برمجة تطبيقات REST هذه.
هنا، ستراجع بعض المفاهيم الأساسية لـ IoT Central، وستتعرف على كيفية تخويل IoT Central لاستدعاءات واجهة برمجة تطبيقات REST، وكيفية إنشاء الرمز المميز لواجهة برمجة التطبيقات واستخدامه.
ما IoT Central؟
IoT Central هو حل لبرنامج IoT المُدار بالكامل كخدمة والذي يجعل من السهل إنشاء حلول تربط بين العالمين المادي والرقمي. يمكّنك IoT Central من:
- الاتصال بأجهزة IoT والتحكم فيها.
- جمع بيانات تتبع الاستخدام من الأجهزة المتصلة وتحليلها.
- إرسال البيانات من الأجهزة المتصلة إلى تطبيقات أو خدمات أخرى لمزيد من المعالجة أو التخزين.
كيف تنشئ تطبيق IoT Central؟
لديك ثلاثة خيارات لإنشاء تطبيق IoT Central:
- زيارة موقع IoT Central الخاص بتطبيقاتي.
- استخدام مدخل Azure.
- استخدام Azure CLI.
في هذه الوحدة النمطية، ستستخدم Azure CLI لإنشاء تطبيقك. في هذه الوحدة، هذه هي خطة عنصر التحكم الوحيدة التي ستنفذها. جميع العمليات الأخرى هي عمليات خطة بيانات واجهة برمجة تطبيقات REST.
تتطلب جميع الخيارات الثلاثة تقديم معلومات مثل الدولة أو المنطقة لإجراء النشر واسم التطبيق وخطة الدفع وقالب التطبيق.
ما قالب التطبيق؟
قوالب التطبيقات هي عينات من حلول إنترنت الأشياء (IoT) التي تركز على الصناعات ويتم ملؤها مسبقاً بلوحات المعلومات والأجهزة التي تمت محاكاتها وقوالب الأجهزة. يمكنك الاختيار من قوالب تطبيقات البيع بالتجزئة أو الطاقة أو الحكومة أو الرعاية الصحية أو المخصصة. في هذه الوحدة، يمكنك استخدام قالب تطبيق مخصص لإنشاء تطبيق واستخدام واجهة برمجة تطبيقات REST.
كيف يخول IoT Central استدعاءات واجهة برمجة تطبيقات REST
يجب أن يتضمن كل استدعاء لواجهة برمجة تطبيقات REST يتم إجراؤه على تطبيق IoT Central رأس التخويل. يجب أن يحتوي رأس التخويل إما على الرمز المميز لواجهة برمجة التطبيقات وإما الرمز المميز للحامل.
يُصدر تطبيق IoT Central الخاص بك الرمز المميز لواجهة برمجة التطبيقات ولا يرتبط بحساب مستخدم. تستخدم هذه الوحدة النمطية الرمز المميز لواجهة برمجة التطبيقات من IoT Central. يحدد الرمز المميز لواجهة برمجة التطبيقات مستوى الوصول الذي سيتم منحه للمتصل. تُعيّن مستويات الوصول إلى الأدوار المضمّنة والمخصصة في تطبيق IoT Central:
- يمنح مسؤول التطبيق الوصول إلى جميع استدعاءات واجهة برمجة التطبيقات
- يمنح منشئ التطبيق الوصول إلى استدعاءات واجهة برمجة التطبيقات التي تنشئ قوالب الجهاز والأجهزة وتعدّلها وتحذفها.
- يمنح مُشغّل التطبيق الوصول إلى استدعاءات واجهة برمجة التطبيقات التي تنشئ الأجهزة وتعدّلها وتحذفها.
- يُمكن للمسؤولين إنشاء أدوار مخصصة تمنح الوصول إلى مجموعة محددة من الميزات في التطبيق.
يقترن الرمز المميز للحامل بحساب مستخدم Azure Active Directory. يُمكنك إنشاء رمز مميز للحامل باستخدام أمر CLI az account get-access-token --resource https://apps.azureiotcentral.com. يُمنح المُتصل مستوى الوصول نفسه الذي يتمتع به مستخدم Azure Active Directory في تطبيق IoT Central.
الرمز المميز لواجهة برمجة التطبيقات الخاصة بـ IoT Central
يُمكنك إنشاء الرمز المميز لواجهة برمجة التطبيقات الخاصة بـ IoT Central بطريقتين:
- في قسم الإدارة في واجهة مستخدم الويب الخاصة بتطبيقك على مدخل IoT Central.
- استخدام واجهة برمجة التطبيقات الخاصة بـ IoT Central.
لإنشاء الرمز المميز لواجهة برمجة التطبيقات باستخدام واجهة مستخدم تطبيقات REST، يجب أن يكون لديك بالفعل الرمز المميز لواجهة برمجة التطبيقات الخاص بمسؤول التطبيق أو الرمز المميز للحامل لتخويل الاستدعاء.
تتيح لك واجهة برمجة التطبيقات الخاصة بـ IoT Central ما يلي:
- الحصول على قائمة بالرموز المميزة لواجهة برمجة التطبيقات في أحد التطبيقات.
- إنشاء رمز مميز جديد لواجهة برمجة التطبيقات في التطبيق.
- الحصول على رمز مميز لواجهة برمجة التطبيقات عن طريق المُعرِّف.
- حذف رمز مميز لواجهة برمجة التطبيقات.
التخويل مع IoT Central
هل تحتاج إلى مساعدة؟ راجع دليل استكشاف الأخطاء وإصلاحها الذي نقدمه أو يمكنك توفير ملاحظات معينة عبر الإبلاغ عن مشكلة.