مشاركة عبر

تكوين تحميلات ملفات IoT Hub باستخدام مدخل Microsoft Azure

تكوين رفع الملفات في مركز إنترنت الأشياء الخاص بك يمكن أجهزتك المتصلة برفع الملفات إلى حساب تخزين أزور. توضح لك هذه المقالة كيفية تكوين رفع الملفات على مركز إنترنت الأشياء الخاص بك باستخدام بوابة Azure، وAzure CLI، وAzure PowerShell.

لاستخدام وظيفة تحميل الملف في IoT Hub، يجب أولا إقران حساب تخزين Azure وحاوية كائن ثنائي كبير الحجم بمركز IoT الخاص بك. يقوم IoT Hub تلقائيا بإنشاء معرفات URI لـ SAS مع أذونات الكتابة إلى حاوية الكائن الثنائي كبير الحجم هذه للأجهزة لاستخدامها عند تحميل الملفات. بالإضافة إلى حساب التخزين وحاوية الكائن الثنائي كبير الحجم، يمكنك تعيين وقت البقاء لـ SAS URI ونوع المصادقة التي يستخدمها IoT Hub مع تخزين Azure. يمكنك أيضا تكوين إعدادات إعلامات تحميل الملفات الاختيارية التي يمكن لIoT Hub والقيام بتسليمها إلى خدمات الواجهة الخلفية.

المتطلبات الأساسية

  • حساب Azureنشط. إذا لم يكن لديك حساب، يمكنك إنشاء حساب مجاني في دقيقتين فقط.

  • مركز IoT في اشتِراك Azure الخاص بك. إذا لم يكن لديك مركز بعد، يمكنك اتباع الخطوات في قسم إنشاء مركز إنترنت الأشياء في إنشاء وإدارة مراكز Azure IoT.

تكوين مركز إنترنت الأشياء الخاص بك في بوابة Azure

  1. في مدخل Microsoft Azure، انتقل إلى مركز IoT وحدد تحميل الملف لعرض خصائص تحميل الملف. ثم حدد حاوية تخزين Azure ضمن إعدادات حاوية التخزين.

    لقطة شاشة توضح كيفية تكوين إعدادات تحميل الملف في البوابة الإلكترونية.

  2. حدد حساب تخزين Azure وحاوية كائن ثنائي كبير الحجم في اشتراكك الحالي لإقرانه بمركز IoT الخاص بك. إذا لزم الأمر، يمكنك إنشاء حساب تخزين Azure في جزء حسابات التخزين وإنشاء حاوية كائن ثنائي كبير الحجم في جزء الحاويات.

    لقطة شاشة توضح كيفية عرض حاويات التخزين لتحميل الملف.

  3. بعد تحديد حساب تخزين Azure وحاوية كائن ثنائي كبير الحجم، قم بتكوين بقية خصائص تحميل الملف.

    • تلقي إعلامات للملفات التي تم تحميلها: تمكين إعلامات تحميل الملفات أو تعطيلها عبر التبديل.

    • SAS TTL: هذا الإعداد هو وقت البقاء لواجهات SAS URIs التي تم إرجاعها إلى الجهاز عن طريق IoT Hub. تعيين إلى ساعة واحدة بشكل افتراضي ولكن يمكن تخصيصها إلى قيم أخرى باستخدام شريط التمرير.

    • TTL الافتراضي: وقت الانتهاء من إشعار رفع الملف قبل انتهاء صلاحيته. اضبط على يوم واحد بشكل افتراضي ولكن يمكن تخصيصه لقيم أخرى باستخدام شريط التمرير.

    • أقصى عدد من التسليمات: عدد المرات التي يحاول فيها مركز إنترنت الأشياء تسليم إشعار رفع الملف. قم بالتعيين إلى 10 افتراضيًا ولكن يمكن تخصيصه لقيم أخرى باستخدام شريط التمرير.

    • نوع المصادقة: بشكل افتراضي، يستخدم Azure IoT Hub المصادقة المستندة إلى المفتاح للاتصال بتخويل تخزين Azure. يمكنك أيضًا تكوين الهويات المدارة المعينة من قبل المستخدم أو المعينة من قبل النظام لمصادقة مركز إنترنت الأشياء في Azure باستخدام تخزين Azure. توفر الهويات المدارة خدمات Azure بهوية مدارة تلقائيا في معرف Microsoft Entra بطريقة آمنة. لمعرفة كيفية تكوين الهويات المدارة، راجع دعم IoT Hub للهويات المدارة. بعد تكوين هوية مدارة واحدة أو أكثر على حساب تخزين Azure ومركز IoT، يمكنك تحديد واحدة للمصادقة باستخدام تخزين Azure باستخدام الأزرار المعينة من قبل النظام أو المعينة من قبل المستخدم.

      إشعار

      يقوم إعداد نوع المصادقة بتكوين كيفية مصادقة مركز IoT باستخدام حساب تخزين Azure الخاص بك. تصادق الأجهزة دائما باستخدام تخزين Azure باستخدام SAS URI الذي تحصل عليه من مركز IoT.

  4. حدد حفظ لحفظ إعداداتك. تأكد من التحقق من التأكيد لإكماله بنجاح. يتم التحقق من صحة بعض التحديدات، مثل نوع المصادقة، فقط بعد حفظ الإعدادات.

المتطلبات الأساسية

  • حساب Azureنشط. إذا لم يكن لديك حساب، يمكنك إنشاء حساب مجاني في دقيقتين فقط.

  • مركز IoT في اشتِراك Azure الخاص بك. إذا لم يكن لديك مركز بعد، يمكنك اتباع الخطوات في قسم إنشاء مركز إنترنت الأشياء في إنشاء وإدارة مراكز Azure IoT.

  • حساب Azure Storage مع حاوية blob. إذا لم يكن لديك حساب Azure Storage، يمكنك استخدام واجهة زر Azure لإنشاء واحد. لمزيد من المعلومات، راجع إنشاء حساب تخزين Azure.

سجل الدخول وقم بتعيين حساب Azure الخاص بك

سجل الدخول إلى حسابك في Azure، وحدد اشتراكك. إذا كنت تستخدم Azure Cloud Shell، يجب أن تكون مسجلا بالفعل؛ ومع ذلك، قد تحتاج إلى اختيار اشتراكك في Azure إذا كان لديك عدة اشتراكات.

  1. في موجه الأوامر، شغل أمر تسجيل الدخول az :

    az login

    اتبع الإرشادات للمصادقة باستخدام التعليمات البرمجية، ثم قم بتسجيل الدخول إلى حسابك في Azure من خلال مستعرض ويب.

  2. إذا كان لديك العديد من اشتراكات Azure، فإن تسجيل الدخول إلى Azure يمنحك حق الوصول إلى كافة حسابات Azure المقترنة ببيانات الاعتماد الخاصة بك. استخدم أمر قائمة حسابات az أدناه لسرد حسابات Azure المتاحة لك:

    az account list

    استخدم الأمر التالي لاختيار الاشتراك الذي تريد استخدامه لتشغيل أوامر إنشاء مركز إنترنت الأشياء الخاص بك. يمكنك استخدام اسم الاشتراك، أو معرف ID من إخراج الأمر السابق:

    az account set --subscription {your subscription name or id}

تكوين الوصول إلى حساب التخزين

تفترض الخطوات التالية أنك أنشأت حساب التخزين الخاص بك باستخدام نموذج نشر مدير الموارد ، وليس نموذج النشر الكلاسيكي .

لتكوين رفع الملفات من أجهزتك، تحتاج إلى منح مركز إنترنت الأشياء صلاحيات الوصول إلى حساب Azure Storage. يجب أن يكون حساب التخزين في نفس الاشتراك مع مركز إنترنت الأشياء الخاص بك. تحتاج أيضا إلى اسم حاوية blob في حساب التخزين.

يمكنك استخدام المصادقة القائمة على المفاتيح أو الهوية لتوفير صلاحيات الوصول. توصي مايكروسوفت بالمصادقة القائمة على الهوية كخيار أكثر أمانا.

المصادقة المستندة إلى المفتاح

للمصادقة المعتمدة على المفاتيح، قدم سلسلة الاتصال لحساب التخزين الخاص بك. استخدم أمر az storage account show-connection-string لاسترجاع مفاتيح حساب التخزين الخاص بك.

دون connectionString القيمة. يبدو خيط الاتصال مشابها للمخرج التالي:

{
  "connectionString": "DefaultEndpointsProtocol=https;EndpointSuffix=core.windows.net;AccountName={your_storage_account_name};AccountKey={your_storage_account_key}"
}

المصادقة المستندة إلى الهوية

يمكنك استخدام الهويات المدارة المعينة من النظام أو الهويات المدارة المعينة من قبل المستخدم للمصادقة القائمة على الهوية. لمزيد من المعلومات، راجع دعم IoT Hub للهويات المدارة.

استخدم أمر إنشاء تعيين الأدوار في az لتعيين دور لهويتك المدارة. لمزيد من المعلومات، راجع تعيين دور Azure للوصول إلى بيانات كائن ثنائي كبير الحجم.

تكوين مركز IoT الأشياء الخاص بك

يمكنك الآن تكوين مركز إنترنت الأشياء الخاص بك لتمكين إمكانية رفع الملفات إلى مركز إنترنت الأشياء باستخدام تفاصيل حساب التخزين الخاص بك.

يتطلب التكوين القيم التالية:

  • حاوية التخزين: حاوية blob في حساب تخزين Azure ضمن اشتراكك الحالي في Azure لربطها بمركز إنترنت الأشياء الخاص بك. لقد استرجعت معلومات حساب التخزين اللازمة في القسم السابق. يقوم IoT Hub تلقائيا بإنشاء معرفات URI لـ SAS مع أذونات الكتابة إلى حاوية الكائن الثنائي كبير الحجم هذه للأجهزة لاستخدامها عند تحميل الملفات.

  • استلام الإشعارات للملفات المرفوعة: تفعيل أو تعطيل إشعارات رفع الملفات.

  • SAS TTL: هذا الإعداد هو وقت البقاء لواجهات SAS URIs التي تم إرجاعها إلى الجهاز عن طريق IoT Hub. ضبطها على ساعة واحدة بشكل افتراضي.

  • إعدادات إشعار الملف الافتراضية TTL: مدة صلاحية إشعار رفع الملف قبل انتهاء صلاحيته. ضبطها على يوم واحد بشكل افتراضي.

  • أقصى عدد لإشعارات الملف في التسليم: عدد المرات التي يحاول فيها مركز إنترنت الأشياء تسليم إشعار رفع الملف. ضبطه على 10 بشكل افتراضي.

  • مدة قفل إشعار الملف: مدة القفل لقائمة انتظار إشعار الملف. تم ضبطه على 60 ثانية بشكل افتراضي.

  • نوع المصادقة: نوع المصادقة لجهاز IoT Hub لاستخدامه مع Azure Storage. هذا الإعداد يحدد كيفية مصادقة مركز إنترنت الأشياء الخاص بك وتفويضه باستخدام Azure Storage. الافتراضي هو المصادقة القائمة على المفاتيح؛ ومع ذلك، يوصى بخيارات المصادقة المدارة للهوية المعينة من النظام أو المستخدم. توفر الهويات المدارة خدمات Azure بهوية مدارة تلقائيا في معرف Microsoft Entra بطريقة آمنة.

    إشعار

    يقوم إعداد نوع المصادقة بتكوين كيفية مصادقة مركز IoT باستخدام حساب تخزين Azure الخاص بك. تصادق الأجهزة دائما باستخدام تخزين Azure باستخدام SAS URI الذي تحصل عليه من مركز IoT.

الأوامر التالية توضح كيفية ضبط إعدادات رفع الملفات على مركز إنترنت الأشياء الخاص بك. تظهر هذه الأوامر بشكل منفصل للتوضيح، لكن عادة ما تصدر أمرا واحدا يحتوي على جميع المعايير المطلوبة لسيناريوك. أدرج علامات اقتباس حيث تظهر في سطر الأوامر. لا تضع التقويم. يمكن العثور على مزيد من التفاصيل حول كل معلمة في وثائق Azure CLI الخاصة بأمر az iot hub update .

الأمر التالي يضبط حساب التخزين وحاوية الكتلة (blob).

az iot hub update --name {your iot hub name} \
    --fileupload-storage-connectionstring "{your storage account connection string}" \
    --fileupload-storage-container-name "{your container name}"

الأمر التالي يضبط وقت SAS URI ليعيش على الافتراضي (ساعة واحدة).

az iot hub update --name {your iot hub name} \
    --fileupload-sas-ttl 1

الأمر التالي يفعل إشعارات الملفات ويضبط خصائص إشعارات الملف إلى قيمها الافتراضية. (وقت إشعار رفع الملف إلى البث المباشر مضبوط على ساعة واحدة ومدة القفل مضبوطة على 60 ثانية.)

az iot hub update --name {your iot hub name} \
    --fileupload-notifications true  \
    --fileupload-notification-max-delivery-count 10 \
    --fileupload-notification-ttl 1 \
    --fileupload-notification-lock-duration 60

الأمر التالي يشكل المصادقة القائمة على المفاتيح:

az iot hub update --name {your iot hub name} \
    --fileupload-storage-auth-type keyBased

الأمر التالي يشكل المصادقة باستخدام هوية الإدارة المعينة من قبل النظام في مركز إنترنت الأشياء. قبل أن تتمكن من تشغيل هذا الأمر، تحتاج إلى تفعيل الهوية المدارة المعينة من النظام لمركز إنترنت الأشياء الخاص بك ومنحها الدور الصحيح للتحكم في الوصول القائم على الدور على حساب Azure Storage الخاص بك. لمعرفة الطريقة، راجع دعم IoT Hub للهويات المدارة.

az iot hub update --name {your iot hub name} \
    --fileupload-storage-auth-type identityBased \
    --fileupload-storage-identity [system]

الأوامر التالية تسترجع الهويات المدارة المعينة من قبل المستخدم والمكونة على مركز إنترنت الأشياء الخاص بك وتهيئة المصادقة بإحدى هذه الهويات. قبل أن تتمكن من استخدام هوية مدارة معينة من قبل المستخدم للمصادقة، يجب تكوينها على مركز إنترنت الأشياء الخاص بك ومنحها دور تحكم وصول مناسب قائم على الدور على حساب Azure Storage الخاص بك. لمزيد من التفاصيل والخطوات، راجع دعم IoT Hub للهويات المدارة.

للاستفسار عن هويات مدارة معينة من قبل المستخدم في مركز إنترنت الأشياء الخاص بك، استخدم أمر az iot hub identity show .

az iot hub identity show --name {your iot hub name} --query userAssignedIdentities

يعيد الأمر مجموعة من الهويات المدارة المعينة من قبل المستخدم المكونة على مركز إنترنت الأشياء الخاص بك. يظهر المخرج التالي مجموعة تحتوي على هوية مدارة واحدة معينة من قبل المستخدم.

{
  "/subscriptions/{your subscription ID}/resourcegroups/{your resource group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{your user-assigned managed identity name}": 
  {
    "clientId": "<client ID GUID>",
    "principalId": "<principal ID GUID>"
  }
}

الأمر التالي يضبط المصادقة لاستخدام الهوية المعينة من قبل المستخدم أعلاه.

az iot hub update --name {your iot hub name} \
    --fileupload-storage-auth-type identityBased \
    --fileupload-storage-identity  "/subscriptions/{your subscription ID}/resourcegroups/{your resource group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{your user-assigned managed identity name}"

يمكنك مراجعة الإعدادات في مركز إنترنت الأشياء الخاص بك باستخدام الأمر التالي:

az iot hub show --name {your iot hub name}

لمراجعة إعدادات رفع الملف فقط، استخدم الأمر التالي:

az iot hub show --name {your iot hub name}
    --query '[properties.storageEndpoints, properties.enableFileUploadNotifications, properties.messagingEndpoints.fileNotifications]'

في معظم الحالات، استخدام المعلمات المسماة في أوامر Azure CLI هو الأسهل؛ ومع ذلك، يمكنك أيضا ضبط إعدادات رفع الملفات باستخدام المعلمة --set . الأوامر التالية يمكن أن تساعدك على فهم كيفية ذلك.

az iot hub update --name {your iot hub name} \
  --set properties.storageEndpoints.'$default'.connectionString="{your storage account connection string}"

az iot hub update --name {your iot hub name} \
  --set properties.storageEndpoints.'$default'.containerName="{your storage container name}"

az iot hub update --name {your iot hub name} \
  --set properties.storageEndpoints.'$default'.sasTtlAsIso8601=PT1H0M0S

az iot hub update --name {your iot hub name} \
  --set properties.enableFileUploadNotifications=true

az iot hub update --name {your iot hub name} \
  --set properties.messagingEndpoints.fileNotifications.maxDeliveryCount=10

az iot hub update --name {your iot hub name} \
  --set properties.messagingEndpoints.fileNotifications.ttlAsIso8601=PT1H0M0S

المتطلبات الأساسية

سجل الدخول وقم بتعيين حساب Azure الخاص بك

سجل الدخول إلى حسابك في Azure، وحدد اشتراكك. إذا كنت تستخدم Azure Cloud Shell، يجب أن تكون مسجلا بالفعل؛ ومع ذلك، قد تحتاج إلى اختيار اشتراكك في Azure إذا كان لديك عدة اشتراكات.

  1. عند موجه PowerShell، شغل ملف Connect-AzAccount cmdlet:

    Connect-AzAccount

  2. إذا كان لديك عدة اشتراكات في Azure، فإن تسجيل الدخول إلى Azure يمنحك الوصول إلى جميع الاشتراكات المرتبطة ببيانات اعتمادك. استخدم أمر Get-AzSubscription لسرد الاشتراكات المتاحة لك في Azure لاستخدامها:

    Get-AzSubscription

    استخدم الأمر التالي لاختيار الاشتراك الذي تريد استخدامه لتشغيل أوامر إدارة مركز إنترنت الأشياء الخاص بك. يمكنك استخدام اسم الاشتراك، أو معرف ID من إخراج الأمر السابق:

    Select-AzSubscription `
    -Name "{your subscription name}"

    إشعار

    أمر Select-AzSubscription هو اسم مستعار لأمر Select-AzContext يسمح لك باستخدام اسم الاشتراك (Name) أو معرف الاشتراك (Id) الذي يعيده أمر Get-AzSubscription بدلا من اسم السياق الأكثر تعقيدا المطلوب لأمر Select-AzContext .

استرجع تفاصيل حساب التخزين الخاص بك

تفترض الخطوات التالية أنك أنشأت حساب التخزين الخاص بك باستخدام نموذج نشر مدير الموارد ، وليس نموذج النشر الكلاسيكي .

لتكوين رفع الملفات من أجهزتك، تحتاج إلى سلسلة اتصال لحساب تخزين Azure. يجب أن يكون حساب التخزين في نفس الاشتراك مع مركز إنترنت الأشياء الخاص بك. تحتاج أيضا إلى اسم حاوية blob في حساب التخزين. استخدم أمر Get-AzStorageAccountKey لاسترجاع مفاتيح حساب التخزين الخاص بك:

Get-AzStorageAccountKey `
  -Name {your storage account name} `
  -ResourceGroupName {your storage account resource group}

دون ملاحظة لقيمة مفتاح حساب التخزين key1 . تحتاجه في الخطوات التالية.

يمكنك إما استخدام حاوية blob موجودة لرفع ملفاتك أو إنشاء حاوية جديدة:

  • لإدراج حاويات blob الموجودة في حساب التخزين الخاص بك، استخدم أوامر New-AzStorageContext و Get-AzStorageContainer :

    $ctx = New-AzStorageContext `
    -StorageAccountName {your storage account name} `
    -StorageAccountKey {your storage account key}
Get-AzStorageContainer -Context $ctx

  • لإنشاء حاوية blob في حساب التخزين الخاص بك، استخدم أوامر New-AzStorageContext و New-AzStorageContainer :

    $ctx = New-AzStorageContext `
    -StorageAccountName {your storage account name} `
    -StorageAccountKey {your storage account key}
New-AzStorageContainer `
    -Name {your new container name} `
    -Permission Off `
    -Context $ctx

تكوين مركز IoT الأشياء الخاص بك

يمكنك الآن تكوين مركز إنترنت الأشياء الخاص بك لرفع الملفات إلى مركز إنترنت الأشياء باستخدام تفاصيل حساب التخزين الخاص بك.

يتطلب التكوين القيم التالية:

  • حاوية التخزين: حاوية blob في حساب تخزين Azure ضمن اشتراكك الحالي في Azure لربطها بمركز إنترنت الأشياء الخاص بك. لقد استرجعت معلومات حساب التخزين اللازمة في القسم السابق. يقوم IoT Hub تلقائيا بإنشاء معرفات URI لـ SAS مع أذونات الكتابة إلى حاوية الكائن الثنائي كبير الحجم هذه للأجهزة لاستخدامها عند تحميل الملفات.

  • استلام الإشعارات للملفات المرفوعة: تفعيل أو تعطيل إشعارات رفع الملفات.

  • SAS TTL: هذا الإعداد هو وقت البقاء لواجهات SAS URIs التي تم إرجاعها إلى الجهاز عن طريق IoT Hub. ضبطها على ساعة واحدة بشكل افتراضي.

  • إعدادات إشعار الملف الافتراضية TTL: مدة صلاحية إشعار رفع الملف قبل انتهاء صلاحيته. ضبطها على يوم واحد بشكل افتراضي.

  • أقصى عدد لإشعارات الملف في التسليم: عدد المرات التي يحاول فيها مركز إنترنت الأشياء تسليم إشعار رفع الملف. ضبطه على 10 بشكل افتراضي.

استخدم أمر Set-AzIotHub لتكوين إعدادات رفع الملفات على مركز إنترنت الأشياء الخاص بك:

Set-AzIotHub `
    -ResourceGroupName "{your iot hub resource group}" `
    -Name "{your iot hub name}" `
    -FileUploadNotificationTtl "01:00:00" `
    -FileUploadSasUriTtl "01:00:00" `
    -EnableFileUploadNotifications $true `
    -FileUploadStorageConnectionString "DefaultEndpointsProtocol=https;AccountName={your storage account name};AccountKey={your storage account key};EndpointSuffix=core.windows.net" `
    -FileUploadContainerName "{your blob container name}" `
    -FileUploadNotificationMaxDeliveryCount 10

إشعار

افتراضيا، يقوم IoT Hub بالتحقق باستخدام Azure Storage باستخدام مفتاح الحساب في سلسلة الاتصال. كما تتوفر المصادقة باستخدام هويات مدارة معينة من النظام أو من قبل المستخدم. توفر الهويات المدارة خدمات Azure بهوية مدارة تلقائيا في معرف Microsoft Entra بطريقة آمنة. لمعرفة المزيد، راجع دعم IoT Hub للهويات المدارة. حاليا، لا توجد معلمات على أمر Set-AzIotHub لتعيين نوع المصادقة.

  • Last updated on