باستخدام وحدات ماكرو ، يمكنك إرسال البيانات إلى خادم HTTPs في اي وقت تريد. يمكنك اختيار البيانات التي سيتم إرسالها وبناءها كما تحب. وبهذه الطريقة ، يمكنك تكييف البيانات في خدمه تم إنشاؤها بالفعل.

إجراءات الأمان:

  • يتم تعطيل ميزه طلب عميل HTTPs افتراضيا. يجب ان يقوم مسؤول النظام بتمكين الميزة بشكل صريح من خلال اعداد وضع > في وضع التشغيل ( xconfiguration mode: On ).

  • يمكن لمسؤول النظام منع استخدام HTTP من خلال اعداد هتبكلينت > اللووهتب إلى False ( xconfiguration هتبكلينت اللووهتب: False ).

  • يمكن لمسؤول النظام تحديد قائمه بخوادم HTTPs المسموح للجهاز بإرسال البيانات اليها. (ارجع إلى الأمر Xcommand السماح بأوامر اسم المضيف ).

  • يتم تحديد عدد طلبات HTTPs المتزامنة.

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

قائمه ملقمات HTTPs المسموح بها

يمكن لمسؤول النظام استخدام هذه الأوامر لاعداد وصيانة قائمه بما يصل إلى عشره ملقمات HTTPs المسموح بها (المضيفين):

  • هتبكلينت الأمر xcommand سماح باضافه اسم المضيف التعبير: < تعبير العادي الذي يطابق اسم المضيف أو عنوان الIP الخاص بخادم HTTPs >

  • xCommand Command Allow اسم المضيف واضحا

  • الأمر xCommand السماح بقائمه المضيف

  • السماح بالأمر xCommand معرف أزاله اسم المضيف: معرف ال< لإدخال في القائمة >

إذا كانت القائمة غير فارغه ، يمكنك إرسال طلبات HTTPs إلى الخوادم الموجودة في القائمة فقط. إذا كانت القائمة فارغه ، يمكنك إرسال الطلبات إلى اي خادم HTTPs.

يتم تنفيذ الفحص مقابل قائمه الخوادم المسموح بها عند استخدام ميزه نقل غير أمن (HTTP) وأمن (HTTPS) للبيانات.

HTTPS دون التحقق من صحة الشهادة

عند إرسال الطلبات عبر HTTPS ، يتحقق الجهاز من شهادة خادم HTTPS افتراضيا. في حاله عدم العثور علي شهادة خادم HTTPS لتكون صالحه ، ستظهر رسالة خطا. لا يرسل الجهاز اي بيانات إلى ذلك الملقم.

نوصي باستخدام HTTPS مع التحقق من صحة الشهادة. إذا لم يكن من الممكن التحقق من صحة الشهادة ، فيمكن لمسؤول النظام تعيين هتبكلينت > اللووينسيكوريهتبس إلى تشغيل ( xconfiguration تهيئه اللووينسيكوريهتبس: تشغيل ). يسمح هذا باستخدام HTTPS دون التحقق من صحة شهادة الملقم.

إرسال طلبات HTTPs

بمجرد تمكين ميزه طلب عميل HTTPs ، يمكنك استخدام الأوامر التالية لإرسال الطلبات إلى خادم HTTPs. < > الأسلوب هو اما نشر أو وضع أو تصحيح أو إحضار أو حذف .

  • الأمر xCommand < الأسلوب > [اللووينسيكوريهتبس: < True/False >] [العنوان: < نص الراس >] [ريسبونسيسيزيليميت: < الحد الأقصى لحجم الاستجابة >] [ريسولتبودي: < بلا/نص عادي/Base64 >] [: < المهلة الزمنيه >] Url: < URL لإرسال الطلب إلى >

تعتبر أضافه حقول العنوان اختياريه ، ولكن يمكنك أضافه 20 حقلا كعدد من الحقول.

تحتوي معلمه اللووينسيكوريهتبس علي تاثير فقط إذا سمح مسؤول النظام باستخدام HTTPS دون التحقق من صحة شهادة الملقم. إذا كان الأمر كذلك ، فيمكنك إرسال البيانات إلى الملقم دون التحقق من صحة شهادة الخادم إذا تم تعيين المعلمة علي True . إذا تركت المعلمة أو قمت بتعيينها إلى "خطا " ، فلا يتم إرسال البيانات في حاله فشل التحقق من صحة الشهادة.

المعلمة ريسبوسينسيزيليميت هي الحد الأقصى لحجم الحمولة (بايت) الذي يقبله الجهاز كاستجابة من الملقم. إذا كانت حموله الاستجابة أكبر من الحد الأقصى للحجم ، سيقوم الأمر بإرجاع خطا حاله. تدل رسالة الخطا علي انه قد تم تجاوز الحد الأقصى لحجم الملف. علي الرغم من ذلك ، لا يكون لهذا اي تاثير علي جانب الخادم; تلقي الملقم الطلب وقام بمعالجته بشكل صحيح.

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

  • بلا : عدم تضمين النص الأساسي لاستجابه HTTP في نتيجة الأمر.

  • Base64 : يقوم base64 بتشفير النص الأساسي قبل تضمينه في النتيجة.

  • نص عادي : تضمين النص الأساسي في النتيجة كنص عادي. إذا كانت الاستجابة تحتوي علي أحرف غير قابله للطباعة ، يقوم الأمر بإرجاع خطا حاله مع رسالة تفيد بان البيانات غير القابلة للطباعة تمت مصادفه.

استخدم معلمه المهلة لتعيين فتره المهلة (ثوان). في حاله عدم اكتمال الطلب اثناء هذه الفترة ، يقوم الAPI بإرجاع خطا.

ادخل الحمولة (البيانات) مباشره بعد إصدار الأمر. اي شيء تقوم بإدخاله ، بما في ذلك فواصل الخطوط ، يعتبر جزءا من الحمولة. عند الانتهاء ، قم بالإنهاء بفاصل الخط ("\n") وخط منفصل يحتوي علي نقطه متبوعه بفاصل الخط فقط (".\n"). يتم الآن تنفيذ الأمر ، ويتم إرسال البيانات إلى الملقم.

الأمثلة

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

مثال 1: التحكم في جهاز إيوت باستخدام HTTP Post

وفيما يلي داله ماكرو تقوم بتشغيل الضوء المتصل بجسر تدرج الفيليبس:

 الدالة hue_command (البيانات) {"عنوان url للدالة" = "http://192.0.2.10/api/'ZXlU4tUtQ23Pjbdyl-kiyCjTs0i5ANDEu1ypJq0-/lights/1/state"; رؤوس التباين = "المحتويات/json"; الأمر var = "{" في ": true}"; xapi. الأمر ("هتبكلينت" ، {"Url": url ، "Header": headers} ، command);} 

يمكنك القيام بنفس الاجراء في سطر الأوامر باستخدام API:

 الأمر xcommand وضع العنوان: "نوع المحتوي:" الخاص بالتطبيق/json "URL:" http://192.0.2.10/api/'ZXlU4tUtQ23Pjbdyl-kiyCjTs0i5ANDEu1ypJq0-/lights/1/state "{" on ": true}. 

مثال رقم 2: نشر البيانات إلى أداه المراقبة باستخدام HTTP Post

 الأمر xcommand Post: "نوع المحتوي:" التطبيق/json "URL:" https://mymonitoringserver.com/service/devicemonitoring "{" الرسالة ":" المستخدم الذي قام بالإبلاغ عن مشكله في هذا النظام "،" سيستيمنامي ":" بواردروم 4th "،" سوفتواريفيرسيون ":" ce 9.6.0 "،" سوفتواريريليسيداتي ":" 2018-12-13 "،" فيديومونيتورس " 

معلومات اضافيه

احصل علي مزيد من التفاصيل حول كيفيه استخدام طلبات عميل HTTP في دليل التخصيص . اختر أحدث إصدار.

لا يدعم دعم Cisco (TAC) تصحيح رمز الجهة الخارجية ، بما في ذلك وحدات الماكرو. الرجاء التحقق من مجتمع Cisco تعاون المطور إذا كنت في حاجه إلى مساعده في استخدام وحدات الماكرو ورمز الجهة الخارجية. كما يوجد العديد من الموارد المطورة والإينتيجراتوره في هذا الموقع.