تكوين طلب WebSocket

عنوان URL

لفتح اتصال WebSocket، يتعين عليك إدخال عنوان URL ل WebSocket لنقطة النهاية أو عنوان IP لعنوان URL الخاص ب WebSocket الذي ترغب في التحقق منه (يتم دعم بروتوكولات ws:// wss:// المشفرة). على سبيل المثال، wss://echo.websocket.org/

لتشغيل وضع إدخال أكثر ملاءمة للمرئيات، انقر على المفتاح “تفصيلي ” أعلى القسم.

يمكنك تحويل عنوان URL إلى قيمة ديناميكية أو معلمة سياق هنا. على سبيل المثال ، لتغيير عنوان URL المستهدف ديناميكيا.

إرسال البيانات

إذا كنت بحاجة إلى نقل البيانات إلى نقطة النهاية الهدف، في الحقل إرسال البيانات ، حدد رسالة بتنسيق سلسلة أو تنسيق ثنائي. سيقوم Dotcom-Monitor بإرسال الرسالة إلى نقطة النهاية المستهدفة باستخدام بروتوكول WebSocket وانتظر الاستجابة.

يدعم Dotcom-Monitor تعبيرات Razor في رسائل WebSocket. لإرسال سلسلة تحتوي على تعبير Razor، أدخلها في الحقل إرسال بيانات واستخدم إعداد البرنامج النصي لتعيين نوع الرسالة إلى تعبير Razor. خلاف ذلك ، سيتم تحليل الرسالة وإرسالها كنص. استخدم المقتطف التالي في الحقل “إعداد البرنامج النصي” لإعلام النظام بأنه يجب تحليل الرسالة باستخدام محرك Razor:

ProcessPostDataByRazor(currentTask);

بالإضافة إلى محرك Razor ، يتيح Dotcom-Monitor تغيير بيانات نص الطلب ديناميكيا باستخدام أقنعة البيانات. لمعرفة كيفية استخدام بناء جملة Razor وأقنعة البيانات في البيانات المرسلة، وتكوين الحمولة المتغيرة ديناميكيا، راجع كيفية تغيير الحمولة الصافية ديناميكيا في طلب HTTP.

التحقق من صحة الاستجابة (التحقق من صحة المحتوى)

للتحقق من صحة سلسلة رسائل تم تلقيها من WebSocket، يمكنك تأكيد الكلمات الأساسية في سيناريو تنفيذ المكالمات. سينتظر النظام الاستجابة من نقطة النهاية المستهدفة ، ويتحقق من الرسالة المستلمة لوجود الكلمة الأساسية المحددة في السلسلة. إذا لم يتم اكتشاف الكلمة الرئيسية في الردود الواردة من المقبس، إنشاء خطأ.

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

لاحظ أن الكلمة الرئيسية حساسة لحالة الأحرف.

إعداد البرنامج النصي والبرنامج النصي اللاحق

يمكن أن تحتوي الحقول على رمز C # ، والذي يمكن استخدامه لطلبات محددة وبيانات عنوان URL أو للتحقق من صحة الرؤوس المخصصة أو نشرها. يرجى الاطلاع على مقالة استخدام إعداد البرنامج النصي ونشر البرنامج النصي أو الاتصال بالدعم الفني للحصول على مزيد من التفاصيل حول الاستخدام.

يمكن تحديد السيناريو الديناميكي لتنفيذ استدعاء WebSocket في الحقل “إعداد البرنامج النصي “. يمكن أن يتضمن السيناريو الديناميكي عددا من العمليات ذات البيانات الثنائية أو السلسلة.

العمليات ذات التنسيق الثنائي (MSG كترميز Base64):

  • ValidateBinary(string msg) – يتحقق مما إذا كانت استجابة WebSocket تساوي البيانات الثنائية المحددة.
  • ValidateBinaryContains(سلسلة MSG) – يتحقق مما إذا كانت استجابة WebSocket تحتوي على بيانات ثنائية محددة.
  • SendBinary(string msg) – يرسل رسالة ثنائية إلى WebSocket.

العمليات المنسقة للنص:

  • SendText(string msg) – يرسل سلسلة نصية إلى WebSocket.
  • ValidateText (سلسلة رسالة) – يتحقق مما إذا كانت الاستجابة من WebSocket تساوي سلسلة محددة.
  • ValidateTextContains (سلسلة رسالة) – يتحقق مما إذا كانت استجابة WebSocket تحتوي على سلسلة محددة.

في الحالات التي تم فيها تحديد أي تأكيد في الحقل “إعداد البرنامج النصي”، سينتظر النظام التأكيد المحدد في الاستجابة ويتابع تنفيذ البرنامج النصي بمجرد نجاح التحقق من الصحة. إذا لم يتم تلقي رسالة مع التأكيد المحدد ، وتم الوصول إلى مهلة إكمال المهمة ، فسنقوم بإنشاء خطأ التحقق من الصحة.

يسمح لك Dotcom-Monitor بتضمين أكبر عدد ممكن من العمليات حسب الضرورة في البرنامج النصي Prepare. ومع ذلك، إذا تم الوصول إلى مهلة إكمال المهمة، سيتم إنهاء تنفيذ البرنامج النصي. يتم حساب وقت إكمال المهمة من بداية تنفيذ البرنامج النصي.

  • مثال: التحقق من صحة الاستجابة موافق

  • مثال: فشل التحقق من صحة الاستجابة

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

currentTask.SendText("This is a test");
currentTask.ValidateText("This is a test");

حيث لا تعتمد المعلمة currentTask على اسم مهمة ولها نوع المهمة التي تتم معالجتها حاليا.

SSL / فحص الشهادة

يتضمن التحقق من شهادة SSL لطبقة المقابس الآمنة خيارات التحقق التالية:

  • السلطة: تتحقق مما إذا كانت سلسلة الشهادات تحتوي على شهادة جذر موثوق بها أم غير موثوق بها.
  • الاسم الشائع (CN): يتحقق من أن العنوان الذي تنتقل إليه يطابق شهادة العنوان التي تم توقيع العنوان عليها.
  • التاريخ: يتحقق من تاريخ انتهاء صلاحية الشهادة.
  • الإلغاء: للتحقق من أن سلسلة الثقة الخاصة بالشهادة لا تحتوي على شهادة تم إلغاؤها.
  • الاستخدام: يتحقق من سلسلة الشهادات بحثا عن الاستخدام غير السليم لشهادة وسيطة.
  • تذكير انتهاء الصلاحية بالأيام: تذكير يخطر (كخطأ) بانتهاء صلاحية الشهادة.
  • شهادة العميل: اسم شهادة العميل.

عتبة التحقق من صحة الوقت (بالثواني)

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

المصادقة الأساسية

The Basic Authentication scheme is used to allow users to access content on some websites. Once provided, login credentials will be passed along with the request header to the web server.

  • Username: contains a username for HTTP/S basic or digest access authentication.
  • User Password: contains a password for HTTP/S basic or digest access authentication.

Do not confuse Basic Authentication with other authentication schemes such as Bearer Authentication that involves bearer tokens and OAuth 2.0 that uses access tokens.

Read the articles on Basic Authentication Username and Password and Monitoring OAuth 2.0-based APIs for more information.

رؤوس

يتيح الخيار إضافة أي رؤوس مخصصة إضافية إذا لزم الأمر.

  • اسم الرأس: حدد اسم المعلمة كما ستظهر في الطلب.
  • القيمة: أدخل القيمة المقترنة باسم المعلمة.

خيارات DNS

تتيح ميزة خيارات DNS للمستخدمين اختيار كيفية إجراء طلبات خادم اسم المجال (DNS) أثناء مهمة المراقبة.

لتحديد وضع حل أسماء المضيفين، في القسم وضع حل DNS ، حدد أحد الأوضاع المتوفرة. لمزيد من التفاصيل حول تكوين الميزة، راجع خيارات وضع DNS.

يسمح قسم مضيفات DNS المخصصة بإعداد تعيين عناوين IP لأسماء المضيفين. يتم دعم دقة DNS IPv6 و IPv4.

لتحديد التعيين، أدخل عنوان IP واسم المضيف في الحقول المقابلة.

امثله:

192.168.107.246 example.com user.example.com userauth.example.com tools.example.com
192.168.107.246 example.com
192.168.107.246 user.example.com
192.168.107.246 userauth.example.com

راجع أيضا: خيارات وضع DNS.

عامل تصفية الأخطاء

You can create filters that will ignore specific errors that you know may occur and are not relevant to the goal of a specific device. The system will not generate alerts on responses with error codes that match the filters. For example, DNS errors could be filtered out based on who is responsible for DNS server operations. In addition, you can configure the system to ignore a range of error codes using a dash, or multiple error codes using semicolons as a separator.

You can find a comprehensive list of Error Codes in the HTTP Status Codes List | HTTP Error Codes Explained article of this wiki.

For example, if you do not care about 404 errors on one particular device, you can filter them out so that you do not receive alerts when they the errors are detected. The error details will be available for review in the device reports.

If you want to ignore an error with a specific code and type while monitoring, you can configure the Ignore Error Codes option in the device settings. If the system detects a response with the specified error type and code, the response will be considered as successful and its status will be changed to OK. Note that ignored errors will not be reflected on the reports and can’t be tracked down.