تأمین کاربر با SCIM

پیکربندی تأمین کاربر با SCIM

ScribbleMaps از SCIM 2.0 (سامانه مدیریت هویت میان‌دامنه‌ای) برای تأمین و لغو تأمین خودکار کاربران پشتیبانی می‌کند. این امکان به شما اجازه می‌دهد کاربران را به‌طور خودکار از ارائه‌دهنده هویت (IdP) خود با ScribbleMaps همگام کنید و مطمئن شوید عضویت تیم با دایرکتوری سازمان شما همگام می‌ماند.

تأمین کاربر با SCIM در team.scribblemaps.com در دسترس است و کاملاً رایگان است.

SCIM چیست؟

SCIM (سامانه مدیریت هویت میان‌دامنه‌ای) یک استاندارد باز است که به شما اجازه می‌دهد به‌طور خودکار:

کاربران را تأمین کنید - وقتی کاربران در IdP شما تخصیص داده می‌شوند، حساب‌های ScribbleMaps به‌طور خودکار ایجاد می‌شوند
کاربران را به‌روزرسانی کنید - اطلاعات کاربر (نام، ایمیل) همگام نگه داشته می‌شود
تأمین کاربران را لغو کنید - وقتی کاربران از IdP شما حذف می‌شوند، حساب‌ها به‌طور خودکار غیرفعال می‌شوند
نقش‌ها را مدیریت کنید - کاربران از طریق عضویت در گروه به نقش‌های مدیر یا عضو تخصیص داده می‌شوند

SCIM در کنار SSO (‏SAML/OIDC‏) کار می‌کند تا مدیریت کامل چرخه عمر هویت را فراهم کند.

قبل از شروع

برای پیکربندی SCIM باید مالک تیم باشید
به کنسول مدیریت ارائه‌دهنده هویت خود نیاز به دسترسی دارید
IdP شما باید از SCIM 2.0 پشتیبانی کند (Okta، Microsoft Entra ID، OneLogin، JumpCloud و غیره)
برای بهترین تجربه کاربری توصیه می‌کنیم پیش از SCIM، SSO را پیکربندی کنید

گام ۱: فعال‌سازی SCIM در ScribbleMaps

وارد team.scribblemaps.com شوید
به SCIM Provisioning (نوار کناری سمت چپ) بروید
گزینه Enable SCIM را روشن کنید

یادداشت: برای اینکه SCIM به‌طور کامل فعال شود، باید ابتدا یک توکن Bearer تولید کنید.

گام ۲: تولید توکن Bearer

توکن Bearer ارائه‌دهنده هویت شما را نزد ScribbleMaps احراز هویت می‌کند.

در صفحه تنظیمات SCIM، روی تولید توکن کلیک کنید
توکن را بلافاصله کپی کنید و در جای امنی نگه دارید

نکات مهم امنیتی:

توکن فقط یک‌بار نمایش داده می‌شود - اگر آن را گم کنید، باید توکن جدیدی تولید کنید
با این توکن مانند یک گذرواژه رفتار کنید - هر کسی که توکن را داشته باشد می‌تواند کاربران تیم شما را مدیریت کند
در صورت نشت توکن می‌توانید هر زمان آن را باطل و دوباره تولید کنید
باطل کردن توکن بلافاصله همه عملیات SCIM را متوقف می‌کند تا زمانی که توکن جدیدی پیکربندی شود

گام ۳: پیکربندی ارائه‌دهنده هویت شما

از جزئیات زیر برای پیکربندی ScribbleMaps به‌عنوان یک برنامه SCIM در IdP خود استفاده کنید:

تنظیم	مقدار
SCIM Base URL	`https://api.scribblemaps.com/scim/v2`
روش احراز هویت	سرعنوان HTTP / توکن Bearer
سرعنوان Authorization	`Bearer YOUR_TOKEN_HERE`
شناسه یکتا	`userName` (نشانی ایمیل)

مرجع نقاط پایانی SCIM

نقطه پایانی	هدف
`/scim/v2/Users`	تأمین و مدیریت کاربران
`/scim/v2/Groups`	مدیریت نقش/عضویت در گروه
`/scim/v2/ServiceProviderConfig`	قابلیت‌های SCIM (کشف)
`/scim/v2/ResourceTypes`	انواع منبع پشتیبانی‌شده (کشف)
`/scim/v2/Schemas`	طرح‌واره‌های کاربر و گروه (کشف)

گام ۴: تنظیم تخصیص محصول پیش‌فرض (اختیاری)

می‌توانید هنگام تأمین کاربران از طریق SCIM، به‌طور خودکار یک مجوز محصول به آن‌ها تخصیص دهید:

در صفحه تنظیمات SCIM، بخش تخصیص محصول پیش‌فرض را پیدا کنید
یک محصول انتخاب کنید:
- هیچ‌کدام - کاربران بدون محصول ایجاد می‌شوند (بعداً دستی تخصیص دهید)
- بیننده - دسترسی فقط‌خواندنی
- حرفه‌ای پایه - قابلیت‌های ویرایش استاندارد
- حرفه‌ای کسب‌وکار - دسترسی کامل به قابلیت‌ها
روی ذخیره کلیک کنید

یادداشت: فقط در صورتی به کاربران محصول تخصیص داده می‌شود که صندلی در دسترس باشد. اگر صندلی در دسترس نباشد، کاربر ایجاد می‌شود اما بدون تخصیص باقی می‌ماند.

گام ۵: آزمایش و تخصیص کاربران

در ارائه‌دهنده هویت خود، از قابلیت Test Connection برای تأیید اتصال SCIM استفاده کنید
یک کاربر آزمایشی را به برنامه ScribbleMaps در IdP خود تخصیص دهید
بررسی کنید که کاربر در فهرست اعضای تیم ScribbleMaps شما ظاهر شده باشد
پس از تأیید، در صورت نیاز کاربران یا گروه‌های بیشتری را تخصیص دهید

راهنماهای ویژه هر ارائه‌دهنده

Okta

در Okta Admin Console به Applications > Browse App Catalog بروید
عبارت «SCIM 2.0 Test App (Header Auth)» را جستجو کنید یا یک برنامه SCIM سفارشی ایجاد کنید
به تب Provisioning > Configure API Integration بروید
گزینه Enable API integration را علامت بزنید
پیکربندی کنید:
- SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
- OAuth Bearer Token: توکن SCIM مربوط به ScribbleMaps را جای‌گذاری کنید
برای تأیید روی Test API Credentials کلیک کنید
به Provisioning > To App بروید و موارد زیر را فعال کنید:
- Create Users
- Update User Attributes
- Deactivate Users
برای تخصیص کاربران یا گروه‌ها به تب Assignments بروید

Microsoft Entra ID (Azure AD)

در Azure Portal به Microsoft Entra ID > Enterprise Applications بروید
برنامه ScribbleMaps خود را انتخاب کنید (یا یکی ایجاد کنید)
به Provisioning > شروع کنید بروید
Provisioning Mode را روی Automatic تنظیم کنید
در بخش Admin Credentials:
- Tenant URL: https://api.scribblemaps.com/scim/v2
- Secret Token: توکن SCIM مربوط به ScribbleMaps را جای‌گذاری کنید
برای تأیید روی Test Connection کلیک کنید
نگاشت‌های (Mappings) ویژگی‌های کاربر را پیکربندی کنید
Provisioning Status را روی On تنظیم کنید
برای تخصیص کاربران به Users and groups بروید

OneLogin

در OneLogin Admin به Applications > Add App بروید
عبارت «SCIM Provisioner with SAML (SCIM v2 Core)» یا مشابه آن را جستجو کنید
به تب Configuration بروید
پیکربندی کنید:
- SCIM Base URL: https://api.scribblemaps.com/scim/v2
- SCIM Bearer Token: توکن SCIM مربوط به ScribbleMaps را جای‌گذاری کنید
به تب Provisioning بروید و تأمین کاربر را فعال کنید
برای تخصیص کاربران به تب Users بروید

JumpCloud

در JumpCloud Admin به SSO Applications بروید
برای افزودن برنامه جدید روی + کلیک کنید
Custom SCIM را انتخاب کنید
پیکربندی کنید:
- Base URL: https://api.scribblemaps.com/scim/v2
- Token Key: توکن SCIM مربوط به ScribbleMaps را جای‌گذاری کنید
- Authentication: Bearer Token
روی Test Connection کلیک کنید
نگاشت ویژگی‌ها را پیکربندی کنید
گروه‌های کاربری را به برنامه تخصیص دهید

عملیات SCIM پشتیبانی‌شده

عملیات کاربر

عملیات	روش	پشتیبانی‌شده	توضیحات
فهرست کاربران	GET /Users	بله	دریافت همه کاربران با صفحه‌بندی و فیلتر
دریافت کاربر	GET /Users/{id}	بله	دریافت یک کاربر مشخص با شناسه
ایجاد کاربر	POST /Users	بله	تأمین یک کاربر جدید
جایگزینی کاربر	PUT /Users/{id}	بله	به‌روزرسانی کامل ویژگی‌های کاربر
به‌روزرسانی کاربر	PATCH /Users/{id}	بله	به‌روزرسانی جزئی ویژگی‌های کاربر
حذف کاربر	DELETE /Users/{id}	بله	غیرفعال‌سازی کاربر (حذف نرم)

عملیات گروه

عملیات	روش	پشتیبانی‌شده	توضیحات
فهرست گروه‌ها	GET /Groups	بله	گروه‌های نقش مدیر و عضو را برمی‌گرداند
دریافت گروه	GET /Groups/{id}	بله	دریافت گروه همراه با فهرست اعضا
به‌روزرسانی گروه	PATCH /Groups/{id}	بله	افزودن/حذف اعضا از گروه‌های نقش
ایجاد گروه	POST /Groups	خیر	پشتیبانی نمی‌شود (نقش‌ها ثابت هستند)

ویژگی‌های کاربر پشتیبانی‌شده

ویژگی SCIM	فیلد ScribbleMaps	الزامی
`userName`	نشانی ایمیل	بله
`externalId`	شناسه خارجی IdP	خیر
`name.givenName`	نام	خیر
`name.familyName`	نام خانوادگی	خیر
`displayName`	نام نمایشی	خیر
`active`	وضعیت حساب	خیر
`emails[].value`	نشانی ایمیل	خیر

فیلترهای پشتیبانی‌شده

فیلتر	نمونه
فیلتر بر اساس ایمیل	`userName eq "[email protected]"`
فیلتر بر اساس شناسه خارجی	`externalId eq "12345"`
فیلتر بر اساس وضعیت	`active eq true`

مدیریت چرخه عمر کاربر

وقتی کاربری تأمین می‌شود

یک حساب عضو تیم جدید در ScribbleMaps ایجاد می‌شود
اطلاعات کاربر (نام، ایمیل) از IdP شما پر می‌شود
اگر محصول پیش‌فرض پیکربندی شده باشد و صندلی در دسترس باشد، مجوز به‌طور خودکار تخصیص داده می‌شود
کاربر بلافاصله می‌تواند از طریق SSO وارد شود (در صورت پیکربندی)

وقتی کاربری به‌روزرسانی می‌شود

ویژگی‌های کاربر (نام، نام نمایشی) مطابق با IdP شما به‌روزرسانی می‌شوند
تغییرات ایمیل همگام می‌شوند (مگر اینکه کاربر حساب خود را پیوند داده باشد)

وقتی تأمین کاربری لغو می‌شود

حساب کاربر غیرفعال می‌شود (حذف نرم)
همه مجوزهای محصول برداشته می‌شوند و صندلی‌ها آزاد می‌شوند
همه نشست‌های فعال بلافاصله بی‌اعتبار می‌شوند
کاربر دیگر نمی‌تواند وارد شود
داده‌ها و نقشه‌های کاربر حفظ می‌شوند (حذف نمی‌شوند)
در صورت تأمین مجدد کاربر، حساب می‌تواند دوباره فعال شود

مدیریت نقش از طریق گروه‌ها

ScribbleMaps دو گروه نقش را از طریق SCIM ارائه می‌کند:

شناسه گروه	نقش	مجوزها
`admin`	مدیر	مدیریت تنظیمات تیم، کاربران و صورتحساب
`member`	عضو	دسترسی استاندارد عضو تیم

برای تخصیص یک کاربر به‌عنوان مدیر، او را از طریق SCIM PATCH به گروه admin اضافه کنید. نقش مالک از طریق SCIM قابل تغییر نیست.

عیب‌یابی

مشکلات رایج

«401 Unauthorized» یا «Invalid token»

بررسی کنید توکن Bearer درست باشد و باطل نشده باشد
مطمئن شوید توکن در سرعنوان Authorization به‌صورت Bearer YOUR_TOKEN ارسال می‌شود
بررسی کنید توکن منقضی نشده باشد (در صورتی که انقضا تنظیم شده بود)
در صورت نیاز توکن جدیدی تولید کنید

«409 Conflict» - کاربر از قبل وجود دارد

کاربری با آن ایمیل از قبل در تیم شما وجود دارد
اگر کاربر موجود غیرفعال شده بود، SCIM به‌طور خودکار او را دوباره فعال می‌کند
نشانی‌های ایمیل تکراری را در IdP خود بررسی کنید

«400 Bad Request» - فیلد الزامی وجود ندارد

مطمئن شوید userName (ایمیل) در درخواست گنجانده شده است
بررسی کنید قالب ایمیل معتبر باشد
پیکربندی نگاشت ویژگی‌ها را در IdP خود بررسی کنید

کاربران ایجاد شده‌اند اما محصولی تخصیص داده نشده است

بررسی کنید که در تنظیمات SCIM یک محصول پیش‌فرض پیکربندی شده باشد
مطمئن شوید برای محصول پیش‌فرض صندلی در دسترس دارید
محصولات را می‌توان به‌صورت دستی در تنظیمات تیم به کاربران تخصیص داد

تغییرات کاربر همگام نمی‌شود

برخی IdPها طبق زمان‌بندی همگام‌سازی می‌کنند (مثلاً در Azure AD هر ۴۰ دقیقه)
سعی کنید در IdP خود همگام‌سازی دستی را اجباری کنید
بررسی کنید SCIM هنوز فعال و توکن معتبر باشد

آزمایش اتصال ناموفق است

بررسی کنید SCIM Base URL دقیقاً https://api.scribblemaps.com/scim/v2 باشد
مطمئن شوید اسلش انتهایی یا غلط تایپی وجود ندارد
بررسی کنید شبکه/فایروال شما اتصال HTTPS خروجی به api.scribblemaps.com را مجاز می‌کند

به کمک نیاز دارید؟

اگر در تأمین کاربر با SCIM با مشکل روبه‌رو هستید، لطفاً با تیم پشتیبانی ما تماس بگیرید و این موارد را ارسال کنید:

نام تیم شما
ارائه‌دهنده هویتی که استفاده می‌کنید
هرگونه پیام خطا از گزارش‌های تأمین IdP شما
تصاویر از پیکربندی SCIM شما (با توکن پنهان‌شده)

ما اینجا هستیم تا به شما در پیکربندی تأمین کاربر با SCIM برای سازمانتان کمک کنیم.

آخرین به‌روزرسانی 12 مهر 1405