مصادقة RTC والمفاتيحAPI
ثلاث بيانات اعتماد متميزة
Section titled “ثلاث بيانات اعتماد متميزة”| بيانات الاعتماد | من يستخدمها | المكان المناسب |
|---|---|---|
| CHAMPREP جلسة تسجيل الدخول | الشخص الذي يدير وحدة التحكم في RTC | تدفق تسجيل الدخول المركزي ووحدة التحكم |
| APIمفتاح مشروع RTC | الخلفية الخاصة بتطبيقك | تخزين السر من جانب الخادم فقط |
| بيانات اعتماد المشاركين | انضمام عميل واحد إلى غرفة مصرح بها | تدفق الانضمام النشط لذلك العميل |
لا تستبدل أبدًا جلسة حسابك الأساسي بمفتاح مشروع في أي عملية تكامل. لا ترسل أبدًا مفتاح مشروع إلى JavaScript في المتصفح، أو حزم الأجهزة المحمولة، أو مستودعات المصادر، أو أدوات التحليل، أو السجلات، أو عناوين URL العامة.
إنشاء مفتاح
Section titled “إنشاء مفتاح”- في وحدة التحكم RTC، قم بإنشاء مشروع إذا لم تكن قد قمت بذلك بالفعل.
- فتح API المفاتيح واختر إنشاء مفتاح.
- أدخل اسمًا، واختر مشروعًا، وحدد الحد الأدنى من الأذونات المطلوبة.
- اختر إنشاء وانسخ السر من بيانات اعتماد جديدة dialog.
- قم بتخزينه في مدير الأسرار من جانب الخادم في تطبيقك.
يتم عرض السر الكامل فقط عند الإنشاء. تقوم وحدة التحكم الحالية بإنشاء مفاتيح تنتهي صلاحيتها بعد 90 يومًا. ولا توفر أداة لتعديل تاريخ انتهاء الصلاحية. إذا فقدت السر أو انتهت صلاحيته، فقم بإنشاء بديل؛ ولا يمكن استعادته من خلال قائمة المفاتيح.
نطاقات الأذونات
Section titled “نطاقات الأذونات”| النطاق | يسمح بـ |
|---|---|
rooms:read | قائمة الغرف في مشروع المفتاح |
rooms:write | إنشاء غرف وإنهاؤها في ذلك المشروع |
tokens:write | إصدار بيانات اعتماد المشاركين لغرفة مفتوحة |
recordings:read | سرد تسجيلات المشروع وطلب تنزيل المقاطع الصوتية |
recordings:write | بدء وإيقاف مهام تسجيل المشروع |
webhooks:read | قم بإدراج نقاط نهاية الويب هوك الخاصة بالمشروع وسجل التسليم |
webhooks:write | قم بإنشاء نقاط نهاية ويبهوك المشروع وتغييرها واختبارها وإعادة تشغيلها |
عادةً ما تحتاج الخلفية التي تنشئ المكالمات إلى rooms:write, tokens:write، و rooms:read. أضف أذونات التسجيل فقط عند الحاجة. لا يمكن لمفاتيح المشروع إنشاء مؤسسات، أو إنشاء مشاريع، أو إدارة المفاتيح أو مفاتيح التوقيع، أو إدارة المنصة. استخدم وحدة التحكم لتنفيذ مهام إعداد العملاء هذه. مع نطاقات webhook، يدير المفتاح فقط نقاط نهاية مشروعه الخاص.
ينتمي المفتاح إلى مشروع واحد فقط. تغيير projectId في الطلب لا يسمح له بالوصول إلى مشروع آخر. لا تزال حدود الوصول والميزات المسموح بها سارية ؛ فامتلاك مفتاح صالح لا يعتبر تجاوزًا للاشتراك.
استدعاء الخادم API
Section titled “استدعاء الخادم API”قاعدةAPI عملاء RTC في بيئة الإنتاج هي https://api.rtc.champrep.com. وهي منفصلة عن بوابة واجهة برمجة التطبيقات (API) العامة CHAMPREPAPI Gatewayوتستخدم مفاتيح RTC.
# 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استدعاء لكل انضمام، استخدم رموز الانضمام موقعة بمفتاح توقيع المشروع.
التناوب والإلغاء
Section titled “التناوب والإلغاء”أنشئ مفتاحًا جديدًا بالنطاقات المطلوبة، وقم بتحديث مخزن الأسرار الخاص بخادمك، وتحقق من التكامل، ثم حدد إلغاء المفتاح على المفتاح القديم. قم بالإلغاء فورًا في حالة الكشف عن سر. يؤدي الإلغاء إلى حظر الطلبات اللاحقة و إبطال صلاحية أذونات التنزيل الصادرة عن هذا المفتاح؛ لا تفترض أنه يؤدي إلى قطع اتصال مشارك انضم بالفعل. قم بإنهاء الغرفة المتأثرة لإنهاء جلساتها.
لا ترسل أبدًا بيانات الاعتماد إلى الدعم الفني. بدلاً من ذلك، شارك العملية والطابع الزمني وحالة HTTP، وخطأ محجوب.