https://api.phaseo.app/v1):
مفاتيح الإدارة ومفاتيح API ورموز OAuth
لا تقبل مسارات الإدارة إلا مفاتيح الإدارة (أو رموز OAuth)؛ ولا يمكن لمفتاح API الخاص بالـ Gateway استدعاؤها.
ضوابط الحماية أداة تحكم منفصلة: تنطبق على مفاتيح API الخاصة بالـ Gateway وتحكم حركة الاستدلال، مثل قيود التوجيه والميزانيات ومعالجة حقن التعليمات وقواعد المعلومات الحساسة. أما صلاحيات مفتاح الإدارة فتحدد واجهات API الإدارية التي يمكنه استدعاؤها.
اختر مستوى الوصول
يتحوّل كل قالب إلى قائمة صريحة من الصلاحيات عند إنشاء المفتاح. لا يخزّن Phaseo أبدًا حرف بدل مثلall، لذا لا يكتسب المفتاح أي صلاحية تُضاف لاحقًا.
لا يتضمن أي قالب الصلاحية
billing:write التي تبدأ عمليات شحن الرصيد؛ اطلبها صراحةً باستخدام --scopes. لا تستخدم الكل إلا لأتمتة إدارية موثوقة.
لمنح صلاحيات أضيق، مرّر الصلاحيات التي تحتاجها باستخدام --scopes scope_a,scope_b:
الصلاحيات لا تتجاوز أدوار مساحة العمل
يتحقق Phaseo من أمرين في كل استدعاء: أن المفتاح يملك الصلاحية، وأن المفتاح أو مستخدم OAuth ينتمي إلى مساحة العمل بالدور الذي يتطلبه الإجراء. على سبيل المثال، تسمحkeys:write بإدارة المفاتيح، لكن التحقق من الدور هو ما يقرر ما إذا كان المستدعي يستطيع إدارة المفاتيح في تلك المساحة. لا يمكن للمفتاح استخدام صلاحية للوصول إلى مساحة عمل أخرى أو لتخطي تحققات المالك والمسؤول.
حافظ على أمان المفاتيح
- أبقِ مفاتيح الإدارة بعيدًا عن المتصفحات وسجلات سطح المكتب وأنظمة التحكم في المصدر والمحادثات.
- استخدم مفتاحًا واحدًا لكل تكامل، مع أضيق قالب يفي بالغرض.
- حدّد تاريخ انتهاء صلاحية عندما لا يحتاج التكامل إلى وصول دائم.
- أوقف المفاتيح غير المستخدمة مؤقتًا أو احذفها فورًا.
- غيّر المفتاح المسرّب قبل أن تتابع التحقيق.