تكوين أمان الويب وقناة Direct Line

تحدد إعدادات أمان قناة الويب وDirect Line ما إذا كان يجب على العملاء توفير سر Direct Line أو رمزه المميز للاتصال بوكيل Copilot Studio الخاص بك. بدون وصول مؤمَّن، يمكن لأي شخص يعرف معرّف العَامِل الاتصال عبر قنوات موقع العرض التجريبي والموقع المخصص.

Note

في تجربة Teams فقط، لا يمكنك توليد الأسرار. يتم إنشاء رموز الوصول الآمن تلقائيا، ويكون الوصول الآمن مفعلا بشكل افتراضي. لمتطلبات الترخيص، راجع شروط منتجات Microsoft.

تشغيل طلب الوصول الآمن لمطالبة العملاء بتقديم سر أو رمز. هذه الاعتمادات تسمح بالوصول إلى قناة Direct Line؛ فهي لا تصادق المستخدم النهائي أو تقيد الوصول إلى موقع معين بمفردها. قم بتكوين مصادقة المستخدم بشكل منفصل عندما يحتاج المستخدمون لتسجيل الدخول.

يمكنك استبدال وإعادة توليد الأسرار، أو رموز التحديث، أو إيقاف الوصول الآمن عندما لا تكون هناك حاجة إليها.

يستخدم Copilot Studio قناة Direct Line Bot Framework لتوصيل صفحة الويب أو التطبيق بالعامل.

قم بتفعيل أو إيقاف أمان قناة الويب

يمكنك فرض استخدام الأسرار والرموز المميزة لكل عامل فردي.

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

لا تعمل محاولات الوصول إلى العامل الذي لا يوفر هذا الإجراء الأمني.

  1. انتقل إلى صفحة الإعدادات لوكيلك، وحدد الأمان، ثم حدد أمان قناة ويب.

    لقطة شاشة لأمان قناة ويب مميزة فِي الْقائمة الْمنبثقة للإعدادات.

  2. قم بتشغيل طلب الوصول الآمن.

Warning

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

خطط مسبقا لتجنب تعريض وكيلك عن غير قصد.

لإيقاف أمان قناة الويب، قم بإيقاف طلب الوصول المؤمن وتأكد مِن التغيير. قد يستغرق التغيير ما يصل إلى ساعتين ليدخل حيز التنفيذ.

لقطة شاشة لتأكيد أن إيقاف الوصول الآمن يجعل الموقع التجريبي وقنوات Direct Line غير المؤمنة متاحة.

استخدام الأسرار أو الرموز المميزة

بالنسبة لتطبيق خدمة إلى خدمة، حدد السر في رأس التفويض للطلبات الصادرة من خدمتك.

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

تعمل الرموز المميزة لمحادثة واحدة فقط وتنتهي صلاحيتها ما لم يتم تحديثها.

اختر نموذج الأمان الذي يعمل بشكل أفضل لموقفك.

Warning

لا تعرض السر في أي تعليمة برمجية يتم تشغيلها في المتصفح، إما مرمزة بشكل مضمن أو يتم نقلها من خلال مكالمة شبكة.

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

الحصول على الأسرار

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

  1. في قَائِمَة التنقل، تحت الاعدادات, حدد الامان. ثم حدد لوحة أمان قناة ويب .

  2. حدد نسخ لـإما Secret 1 أو Secret 2 لنسخه إلى الحافظة. لكشف السر، اختر أيقونة إظهار/إخفاء وراجع رسالة التحذير.

تبادل الأسرار

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

يوفر لك Copilot Studio سرين، يعملان في آن واحد. يمكنك تبديل السر الذي يستخدمه وكيلك مع الآخر. بعد تبديل الأسرار ويتم توصيل جميع المستخدمين باستخدام السر الجديد، يمكنك إعادة إنشاء السر.

إعادة إنشاء سر

لإعادة إنشاء سر، حدد إعادة إنشاء بجوار السر.

Warning

يتم قطع اتصال ملف تعريف المستخدم الذي يتصل باستخدام السر الأصلي أو الرمز المميز الذي تم الحصول عليه من هذا السر.

إنشاء رمز مميز

يمكنك إنشاء رمز لبدء محادثة مع وكيل واحد. تقوم هذه العملية باستبدال سر Direct Line برمز مميز للمحادثة فِي التعليمات البرمجية لخدمتك. لخيار نقطة نهاية رمز Copilot Studio، تعرف على المزيد في Get Direct Line token.

  1. الحصول على السر.

  2. في رمز الخدمة الخاص بك، أرسل طلب generate token التجريبي. استبدل <DirectLineSecret> بالسر الذي نسخته.

نموذج طلب إنشاء رمز مميز

POST https://directline.botframework.com/v3/directline/tokens/generate
Authorization: Bearer <DirectLineSecret>

نموذج استجابة إنشاء رمز مميز

HTTP/1.1 200 OK
[other headers]
{
  "conversationId": "abc123",
  "token": "<DirectLineToken>",
  "expires_in": 1800
}

إذا نجح الطلب، تحتوي الاستجابة على رمز مميز صالح لمحادثة واحدة وقيمة expires_in تشير إلى عدد الثوانى حتى انتهاء صلاحية الرمز المميز.

للحفاظ على الرمز المميز مفيدا، يجب تحديث الرمز المميز قبل انتهاء صلاحيته.

تحديث توكن

يمكنك تحديث رمز مميز لعدد غير محدود من المرات، طالما لم تنته صلاحيته.

لا يمكنك تحديث رمز منتهي الصلاحية.

أرسل طلب تحديث العينة. استبدل <DirectLineToken> بالرمز غير منتهي الصلاحية الذي تريد تحديثه. استخدم رمز المحادثة، وليس سر Direct Line.

نموذج طلب التحديث

POST https://directline.botframework.com/v3/directline/tokens/refresh
Authorization: Bearer <DirectLineToken>

نموذج استجابة التحديث

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

للحفاظ على الرمز المميز الجديد مفيدا، قم بتحديث الرمز المميز مرة أخرى قبل انتهاء صلاحيته.

HTTP/1.1 200 OK
[other headers]
{
  "conversationId": "abc123",
  "token": "<DirectLineToken>",
  "expires_in": 1800
}

تعرف على المزيد في Refresh a Direct Line token.