المؤسسة والمفاتيح
يدير مسؤولو مؤسستك مفاتيحها من التطبيق: ينشئون مفتاحًا لكل جهاز أو شخص، ويختارون دوره، ويغيّرون اسمه، ويلغونه. ويُستلم مفتاح المسؤول الأول مرة واحدة برمز الاستلام الخاص بطلب الوصول، بعد موافقة DeepLeaf عليه. راجع احصل على مفتاحك وسجّل الدخول.
مؤسستك
المؤسسة حساب عميل واحد في DeepLeaf Yield. تضم مزارعك وبيوتك المحمية وخطوطك ودوراتك الزراعية وجولاتك وسجلاتك. وينتمي كل مفتاح إلى مؤسسة واحدة بالضبط.
الأدوار
| ما يستطيع المفتاح فعله | مسؤول | عضو |
|---|---|---|
| تحليل الجولات، وحفظها في الدورات، وقراءة النتائج والتوقعات | نعم | نعم |
| إنشاء المزارع والبيوت المحمية والخطوط والدورات والسجلات وتعديلها وحذفها | نعم | نعم |
| عرض الفوترة: الخطة، والحالة، وجولات هذا الشهر، والفواتير | نعم | نعم |
| الدفع بالبطاقة، وإدارة البطاقة، والدفع بالتحويل البنكي، وطلب فاتورة حوالة | نعم | لا |
| عرض المفاتيح وإنشاؤها وتغيير أسمائها وإلغاؤها | نعم | لا |
يحصل مفتاح العضو الذي يحاول إجراءً خاصًا بالمسؤول على 403. والمفاتيح التي صدرت قبل وجود الأدوار مفاتيح مسؤول، فتحتفظ بالوصول الكامل.
إدارة المفاتيح في التطبيق
- سجّل الدخول إلى التطبيق بمفتاح مسؤول، وافتح مفاتيح الوصول من قائمة الحساب (
/app/settings/keys). - يعرض الجدول اسم كل مفتاح ودوره وتاريخ إنشائه وآخر استخدام له وما إذا كان ملغى. ويُحدَّث آخر استخدام مرة واحدة في الدقيقة على الأكثر.
- اختر إنشاء مفتاح. وفي مربع الحوار، امنحه اسمًا مثل «الجهاز اللوحي» أو «مكتب البيت المحمي»، واختر عضو أو مسؤول، ثم اختر إنشاء مفتاح.
- يظهر المفتاح الجديد مرة واحدة مع زر نسخ. احفظه في مدير كلمات المرور، ثم اختر تم. لا يحتفظ DeepLeaf Yield إلا ببصمة مشفّرة منه، ولا يستطيع عرضه مرة أخرى.
/app/settings/keys. لا تظهر قيم المفاتيح هنا أبدًا، بل الأسماء والأدوار فقط.لتغيير اسم مفتاح، اختر القلم بجانب اسمه واكتب اسمًا جديدًا. ويبقى المفتاح نفسه دون تغيير.
إلغاء مفتاح
اختر إلغاء المفتاح لمفتاح فُقد أو شورك أو يخص شخصًا غادر. يتوقف عن العمل من الطلب التالي، في التطبيق وفي البرامج النصية، حتى في المتصفحات التي سجّلت الدخول به من قبل.
تحتفظ المؤسسة دائمًا بمفتاح مسؤول نشط واحد على الأقل. ويُرفض إلغاء آخر مفتاح مسؤول مع رسالة توضيحية، فأنشئ مفتاح مسؤول آخر أولًا. وإذا فُقدت كل مفاتيح المسؤول، فراسل hello@deepleaf.io ليصدر DeepLeaf مفتاحًا جديدًا.
من يرى ماذا
- كل مفتاح، مسؤولًا كان أو عضوًا، لا يقرأ ولا يغيّر إلا بيانات مؤسسته.
- لا يستطيع أي مفتاح قراءة بيانات مؤسسة أخرى أو مفاتيحها. والمسارات التابعة لمؤسسة أخرى تُجيب بأنها غير موجودة.
من برنامج نصي
| الطريقة والمسار | ما يفعله |
|---|---|
GET /api/organizations/{org}/keys | مفاتيح المؤسسة، دون قيمها. |
POST /api/organizations/{org}/keys | ينشئ مفتاحًا (name، role). ويحتوي الرد على api_key، ويُعرض مرة واحدة. |
PATCH /api/organizations/{org}/keys/{id} | يغيّر اسم مفتاح (name). |
POST /api/organizations/{org}/keys/{id}/revoke | يلغي مفتاحًا. ويعيد 409 لآخر مفتاح مسؤول. |
لاحقًا
التسجيل الذاتي للمؤسسات الجديدة مدرج في خطة التطوير. وتجد الخطط والدفع في الفوترة والخطط.