ארגונים, SSO ו-SCIM

כל דבר ב-Bona Fide שייך לארגון (סביבת עבודה): תבניות, מעטפות, קישורי חתימה, נקודות קצה של webhook, מפתחות API והתוכנית. כל הרשמה מקבלת ארגון אישי, ואנשים יכולים להיות חברים בכמה ארגונים. מפתחות API פועלים בשם הארגון היחיד שבבעלותו הם נמצאים.

סשנים של לוח הבקרה פועלים על הארגון הפעיל של החבר; אינטגרציה שקוראת ל-API עם קובץ cookie של סשן יכולה לבחור ארגון אחר מהארגונים של המשתמש באמצעות הכותרת 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 נושאים תת-קבוצה שלהן בתור scopes.

חברים, הזמנות, צוותים ומיתוג הארגון מנוהלים בלוח הבקרה. לוגו הארגון מועלה באמצעות 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. יצירת טוקן חדש מחליפה את הקודם; ביטולו עוצר את ההקצאה.