تخطَّ إلى المحتوى
Documentation

مصادقة RTC والمفاتيحAPI

ثلاث بيانات اعتماد متميزة

Section titled “ثلاث بيانات اعتماد متميزة”
بيانات الاعتمادمن يستخدمهاالمكان المناسب
CHAMPREP جلسة تسجيل الدخولالشخص الذي يدير وحدة التحكم في RTCتدفق تسجيل الدخول المركزي ووحدة التحكم
APIمفتاح مشروع RTCالخلفية الخاصة بتطبيقكتخزين السر من جانب الخادم فقط
بيانات اعتماد المشاركينانضمام عميل واحد إلى غرفة مصرح بهاتدفق الانضمام النشط لذلك العميل

لا تستبدل أبدًا جلسة حسابك الأساسي بمفتاح مشروع في أي عملية تكامل. لا ترسل أبدًا مفتاح مشروع إلى JavaScript في المتصفح، أو حزم الأجهزة المحمولة، أو مستودعات المصادر، أو أدوات التحليل، أو السجلات، أو عناوين URL العامة.

  1. في وحدة التحكم RTC، قم بإنشاء مشروع إذا لم تكن قد قمت بذلك بالفعل.
  2. فتح API المفاتيح واختر إنشاء مفتاح.
  3. أدخل اسمًا، واختر مشروعًا، وحدد الحد الأدنى من الأذونات المطلوبة.
  4. اختر إنشاء وانسخ السر من بيانات اعتماد جديدة dialog.
  5. قم بتخزينه في مدير الأسرار من جانب الخادم في تطبيقك.

يتم عرض السر الكامل فقط عند الإنشاء. تقوم وحدة التحكم الحالية بإنشاء مفاتيح تنتهي صلاحيتها بعد 90 يومًا. ولا توفر أداة لتعديل تاريخ انتهاء الصلاحية. إذا فقدت السر أو انتهت صلاحيته، فقم بإنشاء بديل؛ ولا يمكن استعادته من خلال قائمة المفاتيح.

النطاقيسمح بـ
rooms:readقائمة الغرف في مشروع المفتاح
rooms:writeإنشاء غرف وإنهاؤها في ذلك المشروع
tokens:writeإصدار بيانات اعتماد المشاركين لغرفة مفتوحة
recordings:readسرد تسجيلات المشروع وطلب تنزيل المقاطع الصوتية
recordings:writeبدء وإيقاف مهام تسجيل المشروع
webhooks:readقم بإدراج نقاط نهاية الويب هوك الخاصة بالمشروع وسجل التسليم
webhooks:writeقم بإنشاء نقاط نهاية ويبهوك المشروع وتغييرها واختبارها وإعادة تشغيلها

عادةً ما تحتاج الخلفية التي تنشئ المكالمات إلى rooms:write, tokens:write، و rooms:read. أضف أذونات التسجيل فقط عند الحاجة. لا يمكن لمفاتيح المشروع إنشاء مؤسسات، أو إنشاء مشاريع، أو إدارة المفاتيح أو مفاتيح التوقيع، أو إدارة المنصة. استخدم وحدة التحكم لتنفيذ مهام إعداد العملاء هذه. مع نطاقات webhook، يدير المفتاح فقط نقاط نهاية مشروعه الخاص.

ينتمي المفتاح إلى مشروع واحد فقط. تغيير projectId في الطلب لا يسمح له بالوصول إلى مشروع آخر. لا تزال حدود الوصول والميزات المسموح بها سارية ؛ فامتلاك مفتاح صالح لا يعتبر تجاوزًا للاشتراك.

قاعدةAPI عملاء RTC في بيئة الإنتاج هي https://api.rtc.champrep.com. وهي منفصلة عن بوابة واجهة برمجة التطبيقات (API) العامة CHAMPREPAPI Gatewayوتستخدم مفاتيح RTC.

Terminal window
# Set RTC_API_KEY securely in your server environment before running this.
curl --fail-with-body \
--header "Authorization: Bearer $RTC_API_KEY" \
https://api.rtc.champrep.com/v1/rooms

استخدم HTTPS ونصوص JSON. لا تضع المفتاح في سلاسل الاستعلام. يجب أن يقوم المتصفح بالاستدعاء الخلفية الخاصة بك، والذي يقوم بعد ذلك باستدعاء RTC؛ ولا ينبغي له استدعاء نقاط نهاية الإدارة مباشرةً باستخدام مفتاح الخادم.

قم بتفويض المستخدمين التابعين لك

Section titled “قم بتفويض المستخدمين التابعين لك”

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

الـ نقطة نهاية الرمز المميز تُرجع مجموعة بيانات اعتماد مؤقتة. قم بإصدار مجموعة جديدة لكل مشارك ولكل إعادة اتصال. canPublish: false يجعل المشارك في وضع «الاستلام فقط». الرمز المميز لا يحل محل عمليات التحقق من العضوية في تطبيقك. لإنشاء وصول للمشاركين دون إجراء APIاستدعاء لكل انضمام، استخدم رموز الانضمام موقعة بمفتاح توقيع المشروع.

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

لا ترسل أبدًا بيانات الاعتماد إلى الدعم الفني. بدلاً من ذلك، شارك العملية والطابع الزمني وحالة HTTP، وخطأ محجوب.