تنظیمیں، 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)۔

سنگل سائن آن

مالکان اور ایڈمنز اپنا شناختی فراہم کنندہ خود Settings › Security › SSO میں SAML 2.0 یا OIDC کے ساتھ جوڑتے ہیں:

اپنے IdP کے میٹا ڈیٹا کے ساتھ کنکشن رجسٹر کریں (ڈیش بورڈ آپ کے لیے SAML میٹا ڈیٹا URL حاصل کر سکتا ہے)۔
DNS TXT ریکارڈ کے ذریعے اپنے ای میل ڈومین کی تصدیق کریں (ٹوکن bona-fide-verify سے شروع ہوتا ہے)۔
سیٹنگز منتخب کریں: just-in-time پروویژننگ (IdP سے پہلا لاگ اِن رکن بنا دیتا ہے)، نئے اراکین کا ڈیفالٹ کردار، اور لازمی نفاذ: تصدیق شدہ ڈومین کے ای میل والے اراکین کو IdP کے ذریعے سائن اِن کرنا ہوگا؛ مالکان ہنگامی لاگ اِن برقرار رکھتے ہیں۔
لازمی کرنے سے پہلے کنکشن کے صفحے سے ایک ٹیسٹ لاگ اِن چلائیں۔

کنکشن کی صحت (آخری لاگ اِن، پچھلے 30 دنوں کے لاگ اِنز، سرٹیفکیٹ کی میعاد) اور ہر SSO اور SCIM تبدیلی کا آڈٹ ٹریل (GET /v1/sso/audit) انہی صفحات پر دکھائے جاتے ہیں۔

سائن اِن صفحہ GET /v1/sso/discover?email=… سے پوچھتا ہے کہ آیا کوئی ایڈریس کمپنی کا SSO استعمال کرتا ہے؛ یہ عوامی ہے اور ریٹ لمٹ کے تحت ہے۔ جب SSO لازمی ہو تو اس ڈومین کے لیے پاس ورڈ، ای میل کوڈ اور میجک لنک سے سائن اِن مسترد ہو جاتا ہے۔

SCIM ڈائریکٹری سنک

SCIM 2.0 کے ساتھ آپ کا IdP اراکین کو خودکار طور پر بناتا، اپ ڈیٹ کرتا اور غیر فعال کرتا ہے۔ Settings › Security › SCIM میں ایک bearer ٹوکن بنائیں (جو ایک بار دکھایا جاتا ہے) اور اپنے IdP کو SCIM بیس URL اور ٹوکن دیں۔ بیس URL یہ ہے: https://api.bonafidesign.com/api/auth/scim/v2۔ نیا ٹوکن بنانے سے پچھلا ٹوکن بدل جاتا ہے؛ اسے منسوخ کرنے سے پروویژننگ رک جاتی ہے۔