الانتقال إلى المحتوى الرئيسي
أنشئ مفتاح إدارة لاستدعاء واجهات API الإدارية في Phaseo من خوادمك: الأرصدة والنشاط ومساحات العمل والمفاتيح والإعدادات المسبقة والإعدادات وضوابط الحماية. لا يمكن لمفاتيح الإدارة إرسال طلبات الاستدلال. أنشئ مفتاحًا من لوحة التحكم ضمن الإعدادات → مفاتيح الإدارة. لا يظهر السر إلا مرة واحدة، فاحفظه في مدير الأسرار. أرسله من الشيفرة التي تعمل على الخادم فقط، إلى عنوان URL الأساسي نفسه الذي يستخدمه الـ Gateway (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 بإدارة المفاتيح، لكن التحقق من الدور هو ما يقرر ما إذا كان المستدعي يستطيع إدارة المفاتيح في تلك المساحة. لا يمكن للمفتاح استخدام صلاحية للوصول إلى مساحة عمل أخرى أو لتخطي تحققات المالك والمسؤول.

حافظ على أمان المفاتيح

  • أبقِ مفاتيح الإدارة بعيدًا عن المتصفحات وسجلات سطح المكتب وأنظمة التحكم في المصدر والمحادثات.
  • استخدم مفتاحًا واحدًا لكل تكامل، مع أضيق قالب يفي بالغرض.
  • حدّد تاريخ انتهاء صلاحية عندما لا يحتاج التكامل إلى وصول دائم.
  • أوقف المفاتيح غير المستخدمة مؤقتًا أو احذفها فورًا.
  • غيّر المفتاح المسرّب قبل أن تتابع التحقيق.
آخر تعديل في ٧ نوفمبر ٢٠٢٦