السماح بإجراء "إرسال ويب هوك" أو حظره

الإصدارات المتوافقة مع هذه الميزة: Business Starter وBusiness Standard وBusiness Plus وEnterprise Standard وEnterprise Plus وEducation Fundamentals وEducation Standard وإضافة Teaching and Learning وEducation Plus. الإضافات المتوافقة مع هذه الميزة: Google AI Pro for Education.

هذه الميزة متوفّرة في نسخة حصرية.

تسمح إجراءات الويب هوك بتلقّي البيانات أو إرسالها باستخدام رابط خارجي أو واجهة برمجة تطبيقات. تتيح خطوة الويب هوك للمستخدمين الربط بموارد داخلية وخارجية لا يتيحها Google Workspace Studio مباشرةً. ومع ذلك، يجب أن يكون المستخدمون حذرين عند مشاركة بيانات مؤسستك خارجيًا.

لحماية بيانات مؤسستك، يتضمّن Workspace Studio تدابير وقائية أمنية متعدّدة:

  • إيقافها تلقائيًا: يتم إيقاف خطافات الويب إلى أن يفعّلها المشرف صراحةً لوحدة تنظيمية.
  • قائمة عناوين URL المسموح بها: في الإصدارات المتوافقة، لا ترسل الويب هوك البيانات إلا إلى النطاقات ونقاط النهاية المحدّدة في قائمة عناوين URL المسموح بها في مؤسستك.
  • موافقة المستخدم: بشكلٍ تلقائي، يجب أن يراجع أحد الأشخاص كل خطوة من خطوات Webhook ويؤكّدها قبل تنفيذها.
  • تسجيل التدقيق: يتم تسجيل طلبات تنفيذ Webhook ورموز حالة استجابة HTTP في سجلات تدقيق المشرف.

الخطوة 1: تفعيل خطافات الويب أو إيقافها

  1. في "وحدة تحكّم المشرف في Google"، انتقِل إلى "القائمة" ثم التطبيقات ثم Google Workspace ثم Workspace Studio.

    يجب الحصول على امتياز مشرف "إعدادات الخدمة".

  2. انقر على إعدادات إجراءات الويب هوك.
  3. (اختياري) لتطبيق الإعداد على قسم أو فريق، اختَر وحدة تنظيمية من جانب الصفحة.
  4. اختَر تفعيل للسماح للمستخدمين في الوحدة التنظيمية المحدّدة باستخدام خطوات webhook في التدفقات، أو اختَر إيقاف لحظر خطوات webhook.
  5. انقر على حفظ. أو انقر على إلغاء بالنسبة إلى الوحدات التنظيمية.

    لاستعادة القيمة المكتسَبة لاحقًا، انقر على اكتساب.

الخطوة 2: (اختيارية) حصر استخدام خطافات الويب على قائمة مسموح بها من عناوين URL

الإصدارات المتوافقة مع هذه الميزة: Business Plus وEnterprise Standard وEnterprise Plus وEducation Standard وEducation Plus. مقارنة إصدارك.

يمكنك حصر خطوات Webhook على إرسال البيانات أو تلقّيها من نطاقات وعناوين URL محدّدة في قائمة السماح فقط. ويتم ذلك باستخدام قائمة السماح المشتركة لعناوين URL في Google Drive و"مستندات Google" و"جداول بيانات Google" و"برمجة تطبيقات Google".

ملاحظة: بالنسبة إلى الإصدارات التي لا تتوافق مع قوائم عناوين URL المسموح بها، يمكن ربط خطافات الويب بجميع عناوين URL الصالحة عند تفعيل الميزة.

إدارة قائمة عناوين URL المسموح بها

  1. في "وحدة تحكّم المشرف في Google"، انتقِل إلى "القائمة" ثم التطبيقات ثم Google Workspace ثم ‏Drive و"مستندات Google" ثم الميزات والتطبيقات.

    يجب الحصول على امتياز مشرف "إعدادات الخدمة".

  2. انقر على الاستيراد والاسترجاع من عناوين URL.
  3. اختَر السماح بالاستيراد والاسترجاع من عناوين URL التالية فقط.
  4. أدخِل عناوين URL أو النطاقات المصرّح بها (مثلاً، https://api.example.com).
  5. انقر على حفظ.

موافقة المستخدم على خطوات الويب هوك

بما أنّ خطوات Webhook تتواصل مع نقاط نهاية خارجية، يتم التعامل معها كإجراءات حساسة. عندما يستخدم مسار العمل خطوة webhook، يطلب Workspace Studio من المستخدم الذي ينفّذ مسار العمل أو يبدأه مراجعة الإجراء وتأكيده قبل تنفيذه.

يمكنك إدارة إعدادات موافقة المستخدمين في "وحدة تحكّم المشرف". لمزيد من التفاصيل، يُرجى الانتقال إلى اشتراط الموافقة على التدفقات التي تتضمّن مستخدمين خارجيين.

مراقبة نشاط Webhook في سجلّات التدقيق

يمكنك مراجعة استخدام webhooks وتحديد وحلّ المشاكل المتعلقة بأعطال سير العمل باستخدام أحداث سجلّ Workspace Studio في "وحدة تحكّم المشرف".

  1. في "وحدة تحكّم المشرف في Google"، انتقِل إلى "القائمة" ثم إعداد التقارير ثم التدقيق والتحقيق ثم أحداث سجلّ Workspace Studio.

    يتطلّب هذا الإجراء الحصول على امتيازات المشرف في أداة التدقيق والتحقيق.

  2. الفلترة حسب اسم الحدث:

    • workflow_execution_success
    • workflow_execution_failure

  3. فحص مَعلمات الحدث:

    • عنوان URL لطلب الويب هوك: عنوان URL المستهدف الذي يتم استدعاؤه من خلال خطوة الويب هوك.
    • رمز استجابة ويب هوك: هو رمز حالة HTTP الذي تعرضه نقطة النهاية المستهدَفة. على سبيل المثال، 200 و404 و500.