المؤسسات وSSO وSCIM

كل شيء في Bona Fide ينتمي إلى مؤسسة (مساحة عمل): القوالب، والمظاريف، وروابط التوقيع، ونقاط نهاية webhook، ومفاتيح API، والخطة. يحصل كل تسجيل جديد على مؤسسة شخصية، ويمكن أن يكون الشخص عضوًا في عدة مؤسسات. وتعمل مفاتيح API لحساب المؤسسة الوحيدة التي تملكها.

تعمل جلسات لوحة التحكم على المؤسسة النشطة للعضو؛ ويمكن للتكامل الذي يستدعي الـ API بملف تعريف ارتباط الجلسة أن يختار مؤسسة أخرى من مؤسسات المستخدم باستخدام الترويسة x-organization-id.

الأدوار والصلاحيات

لكل عضو دور واحد. وكل دور مجموعة ثابتة من الصلاحيات، وكل نقطة نهاية تتحقق من صلاحية:

الدور	الصلاحيات
`owner`	كل شيء
`admin`	كل شيء باستثناء `billing:manage`
`sender`	`envelope:read`، `envelope:send`، `envelope:void`، `template:read`
`template_manager`	`template:read`، `template:write`، `template:publish`، `envelope:read`
`auditor`	`envelope:read`، `template:read`، `audit:read`
`billing`	`billing:manage`

القائمة الكاملة للصلاحيات هي envelope:read، وenvelope:send، وenvelope:void، وtemplate:read، وtemplate:write، وtemplate:publish، وorg:manage، وmember:manage، وsso:manage، وapikey:manage، وbilling:manage، وaudit:read. وتحمل مفاتيح API مجموعة فرعية منها بصفتها نطاقات.

تُدار العضويات والدعوات والفرق والعلامة التجارية للمؤسسة في لوحة التحكم. وتُرفع شعارات المؤسسات باستخدام POST /v1/organization/logo (PNG أو JPEG أو SVG أو WebP، حتى 512 KB) من جلسة لوحة التحكم.

الدخول الموحّد (SSO)

يربط المالكون والمسؤولون مزوّد الهوية بأنفسهم في الإعدادات › الأمان › SSO، باستخدام SAML 2.0 أو OIDC:

سجّل الاتصال باستخدام البيانات الوصفية لمزوّد الهوية (IdP) لديك (يمكن للوحة التحكم جلب عنوان URL للبيانات الوصفية لـ SAML نيابةً عنك).
تحقّق من نطاق بريدك الإلكتروني بسجل DNS من نوع TXT (يبدأ الرمز بـ bona-fide-verify).
اختر الإعدادات: التزويد الفوري (أول تسجيل دخول عبر IdP يُنشئ العضو)، والدور الافتراضي للأعضاء الجدد، والفرض: يجب على الأعضاء الذين يملكون بريدًا إلكترونيًا في النطاق المُتحقق منه تسجيل الدخول عبر IdP؛ ويحتفظ المالكون بوسيلة دخول للطوارئ.
نفّذ تسجيل دخول تجريبيًا من صفحة الاتصال قبل فرضه.

تُعرض حالة الاتصال (آخر تسجيل دخول، وعمليات الدخول خلال آخر 30 يومًا، وانتهاء صلاحية الشهادة) ومسار تدقيق لكل تغيير في SSO وSCIM (GET /v1/sso/audit) على الصفحات نفسها.

تسأل صفحة تسجيل الدخول GET /v1/sso/discover?email=… عمّا إذا كان عنوان ما يستخدم SSO الخاص بالشركة؛ وهي عامة ومحدودة المعدل. وعندما يكون SSO مفروضًا، يُرفض تسجيل الدخول بكلمة المرور ورمز البريد الإلكتروني والرابط السحري لذلك النطاق.

مزامنة الدليل عبر SCIM

مع SCIM 2.0، يُنشئ مزوّد الهوية الأعضاء ويحدّثهم ويعطّلهم تلقائيًا. في الإعدادات › الأمان › SCIM، أنشئ رمز Bearer (يُعرض مرة واحدة) وأعطِ مزوّد الهوية عنوان URL الأساسي لـ SCIM والرمز. عنوان URL الأساسي هو https://api.bonafidesign.com/api/auth/scim/v2. إنشاء رمز جديد يحل محل الرمز السابق؛ وإلغاؤه يوقف التزويد.