সংস্থা, SSO ও SCIM

Bona Fide-এ সবকিছু কোনো সংস্থার (একটি ওয়ার্কস্পেসের): টেমপ্লেট, খাম, স্বাক্ষর লিংক, ওয়েবহুক এন্ডপয়েন্ট, 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-তে, SAML 2.0 বা OIDC দিয়ে:

আপনার IdP-এর মেটাডেটা দিয়ে সংযোগটি নিবন্ধন করুন (ড্যাশবোর্ড আপনার হয়ে একটি SAML মেটাডেটা URL থেকে তথ্য আনতে পারে)।
একটি DNS TXT রেকর্ড দিয়ে আপনার ইমেইল ডোমেন যাচাই করুন (টোকেনটি bona-fide-verify দিয়ে শুরু হয়)।
সেটিংস বেছে নিন: জাস্ট-ইন-টাইম প্রভিশনিং (IdP-তে প্রথম লগইন সদস্য তৈরি করে), নতুন সদস্যদের ডিফল্ট ভূমিকা, এবং বাধ্যতামূলক করা: যাচাইকৃত ডোমেনে ইমেইলধারী সদস্যদের IdP-এর মাধ্যমেই সাইন ইন করতে হবে; ওনাররা একটি জরুরি (break-glass) লগইন রাখেন।
বাধ্যতামূলক করার আগে সংযোগ পৃষ্ঠা থেকে একটি টেস্ট লগইন চালান।

সংযোগের অবস্থা (শেষ লগইন, গত 30 দিনের লগইন, সার্টিফিকেটের মেয়াদ) এবং প্রতিটি SSO ও SCIM পরিবর্তনের অডিট ট্রেইল (GET /v1/sso/audit) একই পৃষ্ঠাগুলোতে দেখানো হয়।

সাইন-ইন পৃষ্ঠা GET /v1/sso/discover?email=…-কে জিজ্ঞেস করে কোনো ঠিকানা কোম্পানির SSO ব্যবহার করে কিনা; এটি পাবলিক এবং রেট লিমিটযুক্ত। SSO বাধ্যতামূলক হলে সেই ডোমেনের জন্য পাসওয়ার্ড, ইমেইল কোড ও ম্যাজিক লিংক দিয়ে সাইন-ইন প্রত্যাখ্যান করা হয়।

SCIM ডিরেক্টরি সিঙ্ক

SCIM 2.0 দিয়ে আপনার IdP স্বয়ংক্রিয়ভাবে সদস্য তৈরি, হালনাগাদ ও নিষ্ক্রিয় করে। সেটিংস › নিরাপত্তা › SCIM-এ একটি বেয়ারার টোকেন তৈরি করুন (একবারই দেখানো হয়) এবং আপনার IdP-কে SCIM বেস URL ও টোকেনটি দিন। বেস URL হলো https://api.bonafidesign.com/api/auth/scim/v2। নতুন টোকেন তৈরি করলে আগেরটি প্রতিস্থাপিত হয়; প্রত্যাহার করলে প্রভিশনিং বন্ধ হয়ে যায়।