المصادقة والمفاتيحAPI
API Gatewayيقبل مفاتيحCHAMPREPAPI محددة النطاق لتكامل الخوادم و الأتمتة. تُستخدم جلسات الحساب المستندة إلى المتصفح لإدارة المفاتيح، ولكن يجب على التكامل المخصص مصادقة طلبات الخدمة الخاصة به باستخدام مفتاحAPI .
إنشاء مفتاح
Section titled “إنشاء مفتاح”- فتح API المفاتيح.
- اختر اسمًا يحدد حمل العمل والبيئة.
- بالنسبة لكل خدمة، اختر مستوى وصول، ثم قم بتضييق نطاقه ليقتصر على النطاقات التي يحتاجها عبء العمل.
- أضف قائمة عناوين IP المسموح بها عندما يكون لحمل العمل عناوين صادرة ثابتة.
- انسخ المفتاح مرة واحدة واحفظه في مدير الأسرار أو سلسلة المفاتيح.
لا تقم بإنشاء مفتاح واحد واسع النطاق لكل تطبيق. فالمفاتيح المنفصلة تجعل التناوب، ومراجعة التدقيق، والاستجابة للحوادث أكثر أمانًا.
إرسال بيانات الاعتماد
Section titled “إرسال بيانات الاعتماد”Authorization: Bearer YOUR_API_KEYللحصول على أمثلة على شل، احتفظ بالقيمة في متغير بيئة:
curl --fail-with-body \ --header "Authorization: Bearer $CHAMPREP_TOKEN" \ https://api.champrep.com/v1/auth/whoamiلا تضع مفتاحًا في عنوان URL، أو معلمة استعلام، أو حزمة JavaScript للواجهة الأمامية، أو تطبيق جوال، أو سطر سجل، أو حدث تحليلي.
كتالوج النطاقات
Section titled “كتالوج النطاقات”تقوم شاشة API«المفاتيح» بتجميع الخدمات في أربعة مجالات: مساحة العمل، الاتصال، المطور، والإدارة. لكل خدمة، اختر مستوى وصول، ثم أضف أو أزل نطاقات فردية إذا كان عبء العمل يتطلب نطاقًا أضيق:
- لا يوجد: لا يمكن للمفتاح استخدام الخدمة.
- قراءة: النطاقات الموجودة في عمود «القراءة».
- قراءة وكتابة: القراءة بالإضافة إلى النطاقات الموجودة في عمود «الكتابة».
- المسؤول: كل ما سبق بالإضافة إلى النطاقات الموجودة في عمود «الإدارة»، بالنسبة للخدمات التي تحتوي على مفتاح API.
النطاقات المحددة الاشتراك الاختياري لا يتم تحديدها أبدًا حسب المستوى. حددها حسب الاسم. تظهر الخدمة التي لا تشملها خطتك مقفلة، مع رابط للترقية. تعرض الشاشة دائمًا الكتالوج الذي يتم عرضه حاليًا.
مساحة العمل
Section titled “مساحة العمل”| الخدمة | قراءة | الكتابة | المسؤول |
|---|---|---|---|
| Drive | drive:read | drive:write, drive:delete | — |
| المستندات | docs:read, docs:export | docs:write, docs:share, docs:delete | — |
| جداول البيانات | sheets:read, sheets:export | sheets:write, sheets:share, sheets:delete | — |
| Notes | notes:read | notes:write | — |
| Calendar | calendar:read | calendar:write | — |
| Contacts | contacts:read | contacts:write | — |
| Work | work:read | work:write, work:delete | — |
| Forms | forms:read | forms:write | — |
| Invoice | invoice:read | invoice:write, invoice:send, invoice:delete | — |
| المخططات التنظيمية | charts:read | charts:write, charts:delete | — |
| Learn | courses:read | courses:write | — |
| المدرسة LMS | غير متاح عبر APIمفتاح API حتى الآن |
الاتصال
Section titled “الاتصال”| الخدمة | قراءة | الكتابة | المسؤول |
|---|---|---|---|
mail:read | mail:write, mail:send | — | |
| Chat | chat:read | chat:write | — |
| Meet | meet:read | meet:write | — |
| RTC | قريبًا. تستخدم RTC APIمفاتيح API للمشروع |
المطور
Section titled “المطور”| الخدمة | قراءة | الكتابة | المسؤول |
|---|---|---|---|
| CHAMPREP Code | code:read_api, code:read_repository, code:read_registry, code:read_package_registry | code:write_repository, code:write_registry, code:write_package_registry | code:api؛ الاشتراك الاختياري code:admin_mode |
| CHAMPREP QA | qa:read | qa:write | — |
| مزرعة Runner | runner_farm:read | runner_farm:write | — |
| CLI | — | cli:use | — |
| CHAMPREP AI | — | ai:chat؛ الاشتراك الاختياري ai:actions, ai:agent | — |
المسؤول
Section titled “المسؤول”| الخدمة | قراءة | الكتابة | المسؤول |
|---|---|---|---|
| الأعمال | business:read | — | business:manage |
| الفوترة | billing:read | — | billing:manage |
| المطور API | api:read | — | api:manage, webhooks:manage |
| الملف الشخصي | users:read | — | — |
لا تتوفر إدارة المنصة أبدًا لمفتاحAPI ؛ فهي تتطلب وجود مسؤول مسجل الدخول.
Notes في نطاقات محددة
Section titled “Notes في نطاقات محددة”- CHAMPREP Code. كل
code:يتطابق نطاقها مع نطاق رمز الوصول الشخصي الذي يحمل نفس الاسم في CHAMPREPCode، ويقوم Code بالتحقق منه في كل نقطة نهاية.code:apiهي صلاحية كاملة للقراءة والكتابة لكل ما يمكن لحسابك الوصول إليه في Code، لذا فهي تقع على مستوى «Admin»؛ يُفضل استخدام الصلاحيات الأضيق نطاقًاread_وwrite_النطاقات. تحتاج نقاط نهاية إدارة الكود إلى مفتاح يحتوي علىcode:admin_modeبالاسم، وحسابًا يكون مسؤولًا عن Code. - مزرعة Runner.
runner_farm:writeتقوم بتسجيل وإدارة المشغلات، والمجموعات، والاتصالات. ولا تقوم أبدًا بشراء أرصدة أو تغيير إعدادات الدفع، كما أنها لا تصدر أبدًا سر الموصل أو رمز المشغل، ولا تستبدلهما، ولا تختبرهما. تتطلب هذه الإجراءات شخصًا مسجلاً للدخول. - Docs و Sheets. المشاركة (المتعاونون، مشاركة الروابط، النشر)، الحذف الدائم أو الإزالة، والتصدير، كل منها يحتاج إلى نطاق خاص به. مفتاح يحتوي فقط على
docs:writeأوsheets:writeيمكنها تحرير المحتوى ولكن لا يمكنها مشاركته، أو حذفه، أو تصديره. - CHAMPREP AI.
ai:agentتتيح CLI وكيل الذكاء الاصطناعي تستخدم الأدوات المحلية وتتضمنai:chat.ai:actionsتوافق على أو ترفض الإجراءات التي يقترحها الذكاء الاصطناعي في CHAMPREPخدماتك، ولا شيء غير ذلك.
نطاق البدل
Section titled “نطاق البدل”نطاق البدل * (وصول كامل) تغطي كل خدمة تتضمنها خطتك، بما في ذلك CodeCHAMPREP و Runner Farm و Docs. تتعامل CHAMPREPCode معها على أنها
code:api، وهو وصول كامل للقراءة والكتابة. ولا يشمل
ai:agent أو code:admin_mode؛ يجب دائمًا تحديدها بالاسم.
احتفظ بالرمز البديل للتكاملات الإدارية الخاضعة لرقابة صارمة، و قلل نطاق مفاتيح الوصول الكامل الحالية إذا لم تكن بحاجة إلى الخدمات الأحدث. يسمح النطاق بفئة معينة من الإجراءات؛ ولا يتجاوز أذونات الخطة أو الدور أو المؤسسة أو المورد.
دورة حياة المفتاح
Section titled “دورة حياة المفتاح”
التناوب
Section titled “التناوب”قم بإنشاء مفتاح بديل أو إعادة إنشائه، ونشره، وتأكيد أن حمل العمل يستخدمه، ثم قم بإلغاء المفتاح السابق. تجنب إجراء التناوب الذي يترك حمل عمل غير مراقب بدون بيانات اعتماد صالحة.
الإلغاء
Section titled “الإلغاء”قم بإلغاء المفتاح فورًا إذا تم الكشف عنه، أو نسخه إلى نظام غير موثوق به، أو إذا لم يعد ينتمي إلى حمل عمل نشط. يجب أن يُرجع المفتاح الملغى 401 ويجب ألا تُعاد المحاولة إلى ما لا نهاية.
مراجعة
Section titled “مراجعة”قم بمراجعة أسماء المفاتيح ونطاقاتها وقيود عناوين IP ومعلومات آخر استخدام و أنشطة التدقيق بانتظام. احذف المفاتيح غير المستخدمة بدلاً من الاحتفاظ بها لاستخدامها في نصوص برمجية محتملة في المستقبل.
تسجيل الدخول عبر المتصفح و CLIتسجيل الدخول
Section titled “تسجيل الدخول عبر المتصفح و CLIتسجيل الدخول”champrep auth login يستخدم مسار الموافقة عبر المتصفح للمستخدم على جهاز طرفي.
champrep auth token يخزن APIمفتاحًا محدد النطاق للأتمتة. ويحميCLI بيانات الاعتماد المخزنة باستخدام سلسلة المفاتيح الخاصة بنظام التشغيل ويرسل جميع الأوامر الشبكية عبر البوابة.
انظر CLI المصادقة و API مفاتيح الأتمتةCLI لتلك سير العمل.