انتقل إلى المحتوى
NanoFlags
ابدأ مجانًا

المرجع

الأمان

كيف يُحدَّد نطاق الوصول، وما الذي يغادر عملياتك، وكم يُحتفظ به، ومن يستطيع تغيير ما يصل إلى مستخدميك. وللنظرة العامة على مستوى الشركة انظر صفحة الأمان.

المفاتيح ونطاقاتها

كل مفتاح ينتمي إلى بيئة واحدة في مشروع واحد. وهناك أربعة أنواع:

النوعالبادئةلـيستطيعلا يستطيع
العميلnf_pub_المتصفحات وتطبيقات الجوالقراءة عرض العميل (الأعلام المكشوفة للعميل والشرائح التي تشير إليها فقط)، والتحديثات الحيّة، وإرسال القياس، وحلّ جلسات الاختبارقراءة الأعلام الخاصة بالخادم أو الشرائح التي لا تستخدمها إلا هي؛ وأي نقطة نهاية لـ CI أو المدير
الخادمnf_srv_الخوادم الموثوقةقراءة الإعداد الكامل، والتحديثات الحيّة، وإرسال القياس، وحلّ جلسات الاختبارأي نقطة نهاية لـ CI أو المدير
CInf_ci_خطوط التكاملتشغيل السيناريوهات المحفوظة، ورفع مراجع الشيفرة، وتصدير التعريفات، وقراءة النسخة المنشورةالنشر أو تغيير الإعداد؛ وجلب حزم SDK
المديرnf_adm_أداة سطر الأوامركل ما يستطيعه مفتاح CI، إضافة إلى نشر البيئات التي لا تشترط تغييرًا مراجَعًانشر البيئات التي تشترط الموافقة؛ وجلب حزم SDK
  • مفاتيح الخادم وCI والمدير أسرار: لا تضعها أبدًا في شيفرة المتصفح أو الجوال.
  • لا تستطيع المفاتيح تجاوز المراجعة: البيئة التي تشترط الموافقة لا تُنشر إلا من لوحة التحكم عبر تغيير موافَق عليه.
  • تفحص الحافة نوع المفتاح قبل أي شيء، وتجيب بـ 403 عندما لا يحق لنوع ما استخدام نقطة نهاية (انظر مصفوفة نقاط النهاية).

مفاتيح العميل والخادم

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

  • لا تجعل العلم مكشوفًا للعميل إلا إذا جاز أن تكون قواعده علنية. ولا تضع قوائم العملاء أو عناوين البريد الداخلية أو الأسرار في قواعد الأعلام المكشوفة للعميل ولا في الشرائح التي تشير إليها.
  • لا تستخدم علم المتصفح للتفويض أبدًا. قرّر صلاحيات الوصول على الخادم.
  • قد تظهر مفاتيح العميل في عناوين الطلبات (?key= في مجرى الأحداث)، وبالتالي في سجلات الطلبات.

الإنشاء والتدوير والإلغاء

  • ينشئ المديرون المفاتيح من الإعدادات ← مفاتيح SDK (Settings → SDK keys). ويظهر المفتاح كاملًا مرة واحدة؛ إذ لا تخزّن NanoFlags إلا بصمة SHA-256 وبادئة قصيرة، فلا يمكن عرضه أو استعادته لاحقًا.
  • التدوير (مفاتيح العميل والخادم وCI): أنشئ بديلًا من النوع نفسه والبيئة نفسها، وحدّث تطبيقك، ثم ألغِ المفتاح السابق. وتعرض قائمة المفاتيح آخر استخدام لكل مفتاح.
  • الإلغاء: تتوقف الحافة عن قبول المفتاح خلال نحو دقيقة (المفاتيح التي تحقّقت منها تُخزَّن مؤقتًا حتى 60 ثانية). وأثناء تعذّر الوصول إلى خادم NanoFlags الأصلي، تواصل الحافة تقديم آخر إعداد للمفاتيح التي تحقّقت منها خلال آخر 24 ساعة، فقد يواصل مفتاح ملغى استلام الإعداد حتى 24 ساعة في تلك الحالة.
  • الاتصال الحي المفتوح يُصادق عليه عند فتحه؛ وبعد الإلغاء يتوقف عن استلام النسخ الجديدة عندما يستبدله الـ SDK (نحو كل 50 دقيقة) وبعد ساعتين على الأكثر.
  • الإلغاء يوقف التحديثات، ولا يمحو الإعداد الذي وصل فعلًا إلى عملية ما: تواصل حِزم SDK تقييم آخر حزمة لديها.
  • يُسجَّل إنشاء المفاتيح وإلغاؤها في سجل النشاط، ويمكن أن يطلقا webhook من نوع key.lifecycle.

التوقيع

كل نسخة منشورة توقَّع بخوارزمية Ed25519 قبل التوزيع، مع عرض عميل موقّع بشكل منفصل لمفاتيح العميل. وتقدّم الحافة البايتات الموقّعة دون تعديل. وتسرد GET /v1/keys المفاتيح العامة، لكل منها kid وstatus (‏active أو retiring)، فيمكن تدوير مفتاح التوقيع دون تعطيل حِزم SDK التي ما زالت تحمل حزمًا موقّعة بالمفتاح السابق.

  • بدءًا من SDK جافاسكريبت 0.4.0، وفي حزمتي Python وGo منذ 0.1.0، وفي حزم Java و.NET وPHP وRuby، تتحقق حِزم SDK من التواقيع افتراضيًا عندما تقرأ من حافة NanoFlags (https://edge.nanoflags.io) وترفض الحزم غير الموقّعة هناك. وفي جافاسكريبت يحتاج التحقق إلى Ed25519 في WebCrypto (‏Node.js 20+‎ والمتصفحات الحالية)؛ وعلى بيئات التشغيل الأخرى اضبط verify: false.
  • يستطيع أي عميل آخر التحقق من الحزم كما هو موصوف في التواقيع. ثبّت المفتاح العام في البناء إن كانت الحافة نفسها ضمن نموذج التهديد لديك؛ فالمفاتيح المجلوبة من /v1/keys موثوقة بقدر الحافة التي قدّمتها فقط.
  • حزم جلسات الاختبار غير موقّعة، والتوقيع لا يثبت الحداثة.
  • وتُسجَّل كل مراجعة منشورة أيضًا في سجلّ موقّع لا يقبل إلا الإضافة تستطيع حزم SDK وأداة سطر الأوامر التحقق منه، مع توقيع مشترك اختياري من العميل: انظر السجل القابل للتحقق.

الإخفاء الافتراضي

  • قياس الـ SDK لا يرسل قيم السياق افتراضيًا. الحدث المأخوذ كعيّنة لا يحمل إلا أسماء خصائص السياق التي تشير إليها قواعد العلم مقرونة بأنواعها ({ "region": "string" }). وتُسقط الخصائص التي لا تستخدمها أي قاعدة. ويمكنك الاشتراك في المزيد عبر events.redact، أو تعطيل القياس بـ events: false. انظر القياس.
  • قيم الأعلام تُرسل مع الأحداث المأخوذة كعيّنات. فلا تضع أسرارًا في قيم الأعلام.
  • لا يحفظ الـ SDK مفتاح SDK أبدًا؛ والحزمة المخزّنة مربوطة بالمفتاح وعنوان الحافة ببصمة غير سرية.
  • مراجع الشيفرة (refs scan) ترفع مسار الملف والسطر ونص ذلك السطر (حتى 240 حرفًا). وهي اختيارية.
  • لا تسجّل الحافة المفاتيح ولا بصماتها ولا رموز الجلسات أبدًا. وسجلات تسليم webhook والبريد تحتوي على المعرّفات والنتائج ورموز الحالة واسم المضيف المستهدف والمستلمين مُقنَّعين، ولا تحتوي على أسرار أو عناوين كاملة أبدًا.
  • حمولات webhook لا تتضمن أبدًا لقطات قبل التغيير وبعده لإعداد ما.

الاحتفاظ بالبيانات

البياناتمدة الاحتفاظ
أحداث التقييم المأخوذة كعيّناتمدة الاحتفاظ في خطتك: Explore 3 أيام، وTeam 14 يومًا، وScale 30 يومًا. وتُحذف الأحداث الأقدم بمهمة تعمل كل ساعة.
بلاغات الخدماتآخر بلاغ لكل خدمة وبيئة («آخر ظهور»): صف واحد يُحدَّث مع كل بلاغ.
النسخ المنشورةمحفوظة: فهي السجل الثابت الذي تستعيد منه.
مدخلات طابور webhook والبريدتُزال بعد 14 يومًا من انتهائها.
المشاريع المحذوفةتُزال فورًا مع أعلامها ونسخها ومفاتيحها وسجلها. وتتوقف مفاتيح المشروع المحذوف عن العمل خلال نحو دقيقة، وتُغلق الاتصالات الحيّة المفتوحة (انظر البيئات المحذوفة).
الحسابات والمؤسساتتُحذف عند الطلب؛ تواصل معنا. وانظر إشعار الخصوصية.

الأدوار والموافقات

الدوريستطيع
مشاهد (Viewer)قراءة كل شيء في مشاريع المؤسسة.
محرّر (Editor)الأعلام والإعدادات والشرائح والتغييرات والسيناريوهات؛ ونشر البيئات التي لا تشترط الموافقة.
مدير (Admin)كل ما يستطيعه المحرّر، إضافة إلى البيئات والأعضاء والمفاتيح وwebhooks، والموافقة على تغييرات الآخرين.
مالك (Owner)كل ما يستطيعه المدير، إضافة إلى إعدادات المؤسسة كاشتراط التحقق بخطوتين، وحذف المشاريع.
  • تفرض قاعدة البيانات الأدوار، لا لوحة التحكم وحدها.
  • في البيئة التي تشترط الموافقة، يحتاج التغيير إلى موافقات بالعدد المضبوط (من 1 إلى 5) من مديرين أو مالكين غير كاتبه. وترتبط الموافقة بالمسودة الدقيقة التي وافقت عليها؛ وأي تعديل لاحق يجعلها متقادمة.
  • كل نشر يسمّي النسخة التي يتوقع أن يحلّ محلها، فلا تستطيع علامة تبويب قديمة في المتصفح الكتابة فوق نسخة أحدث.
  • تُسجَّل التغييرات على الأعلام والمفاتيح والبيئات والأعضاء وعمليات النشر في سجل النشاط مع الفاعل والوقت.

التحقق بخطوتين

  • يستطيع أي عضو إضافة تطبيق مصادقة (TOTP) من الملف الشخصي والأمان (Profile & security). وبمجرد أن يكون للحساب تطبيق مصادقة مُتحقَّق منه، تشترط لوحة التحكم الخطوة الثانية عند تسجيل الدخول قبل فتح المنتج.
  • يستطيع المالكون تفعيل اشتراط التحقق بخطوتين للمالكين والمديرين في الإعدادات ← المؤسسة (Settings → Organization). عندها يُوجَّه المالكون والمديرون الذين لا يملكون تطبيق مصادقة لإعداده قبل استخدام المنتج.
التحقق بخطوتين يحمي تسجيل الدخول إلى لوحة التحكم. أمّا المفاتيح فبيانات اعتماد منفصلة: احمِها بمدير الأسرار لديك ودوّرها عند مغادرة الأشخاص.