Scribble Maps مدد مرکز
زبان تبدیل کریں

SCIM پروویژننگ

SCIM صارف پروویژننگ ترتیب دینا

ScribbleMaps خودکار صارف پروویژننگ اور ڈی پروویژننگ کے لیے SCIM 2.0 (System for Cross-domain Identity Management) کو سپورٹ کرتا ہے۔ اس سے آپ اپنے آئیڈینٹیٹی پروائیڈر (IdP) سے صارفین کو خودکار طور پر ScribbleMaps میں سنک کر سکتے ہیں، تاکہ ٹیم کی رکنیت آپ کی تنظیم کی ڈائریکٹری کے ساتھ ہم آہنگ رہے۔

SCIM پروویژننگ team.scribblemaps.com پر دستیاب ہے اور بالکل مفت ہے۔

فہرستِ مضامین

  1. SCIM کیا ہے؟
  2. شروع کرنے سے پہلے
  3. مرحلہ 1: ScribbleMaps میں SCIM فعال کریں
  4. مرحلہ 2: بیئرر ٹوکن تیار کریں
  5. مرحلہ 3: اپنا آئیڈینٹیٹی پروائیڈر ترتیب دیں
  6. مرحلہ 4: طے شدہ (ڈیفالٹ) پروڈکٹ اسائنمنٹ مقرر کریں
  7. مرحلہ 5: ٹیسٹ کریں اور صارفین کو اسائن کریں
  8. پروائیڈر کے مخصوص گائیڈز
  9. معاون SCIM آپریشنز
  10. صارف کے لائف سائیکل کا انتظام
  11. مسائل کا حل

SCIM کیا ہے؟

SCIM (System for Cross-domain Identity Management) ایک اوپن اسٹینڈرڈ ہے جو آپ کو درج ذیل کام خودکار طور پر کرنے کی سہولت دیتا ہے:

  • صارفین کی پروویژننگ - جب آپ کے IdP میں صارفین اسائن کیے جائیں تو ScribbleMaps اکاؤنٹس خودکار طور پر بن جاتے ہیں
  • صارفین کی اپ ڈیٹ - صارف کی معلومات (نام، ای میل) ہم آہنگ رہتی ہیں
  • صارفین کی ڈی پروویژننگ - جب صارفین آپ کے IdP سے ہٹائے جائیں تو اکاؤنٹس خودکار طور پر غیر فعال ہو جاتے ہیں
  • کرداروں کا انتظام - گروپ رکنیت کے ذریعے صارفین کو ایڈمن یا ممبر کردار تفویض کریں

SCIM، SSO (SAML/OIDC) کے ساتھ مل کر مکمل شناختی لائف سائیکل مینجمنٹ فراہم کرتا ہے۔

شروع کرنے سے پہلے

  • SCIM ترتیب دینے کے لیے آپ کا ٹیم اونر ہونا ضروری ہے
  • آپ کو اپنے آئیڈینٹیٹی پروائیڈر کے ایڈمن کنسول تک رسائی درکار ہے
  • آپ کے IdP کو SCIM 2.0 سپورٹ کرنا چاہیے (Okta، Microsoft Entra ID، OneLogin، JumpCloud وغیرہ)
  • بہترین صارف تجربے کے لیے ہم SCIM سے پہلے SSO ترتیب دینے کی سفارش کرتے ہیں

مرحلہ 1: ScribbleMaps میں SCIM فعال کریں

  1. team.scribblemaps.com پر لاگ اِن کریں
  2. SCIM پروویژننگ (بائیں جانب کی سائیڈ بار) پر جائیں
  3. Enable SCIM کو ON کریں

نوٹ: SCIM کو مکمل طور پر فعال کرنے سے پہلے آپ کو ایک بیئرر ٹوکن تیار کرنا ہوگا۔

مرحلہ 2: بیئرر ٹوکن تیار کریں

بیئرر ٹوکن آپ کے آئیڈینٹیٹی پروائیڈر کو ScribbleMaps کے ساتھ تصدیق کرتا ہے۔

  1. SCIM کی ترتیبات کے صفحے پر ٹوکن تیار کریں پر کلک کریں
  2. ٹوکن فوراً کاپی کریں اور اسے محفوظ جگہ پر رکھیں

اہم سیکیورٹی نوٹس:

  • ٹوکن صرف ایک بار دکھایا جاتا ہے - اگر آپ اسے کھو دیں تو نیا ٹوکن تیار کرنا ہوگا
  • اس ٹوکن کو پاس ورڈ کی طرح سمجھیں - ٹوکن رکھنے والا کوئی بھی شخص آپ کی ٹیم کے صارفین کا انتظام کر سکتا ہے
  • اگر ٹوکن سے سمجھوتہ ہو جائے تو آپ اسے کسی بھی وقت منسوخ کر کے دوبارہ تیار کر سکتے ہیں
  • ٹوکن منسوخ کرنے سے تمام SCIM آپریشنز فوراً رک جاتے ہیں جب تک نیا ٹوکن ترتیب نہ دیا جائے

مرحلہ 3: اپنا آئیڈینٹیٹی پروائیڈر ترتیب دیں

اپنے IdP میں ScribbleMaps کو SCIM ایپلیکیشن کے طور پر ترتیب دینے کے لیے درج ذیل تفصیلات استعمال کریں:

ترتیب قدر
SCIM بیس URL https://api.scribblemaps.com/scim/v2
تصدیق کا طریقہ HTTP ہیڈر / بیئرر ٹوکن
اتھرائزیشن ہیڈر Bearer YOUR_TOKEN_HERE
منفرد شناخت کنندہ userName (ای میل ایڈریس)

SCIM اینڈ پوائنٹس کا حوالہ

اینڈ پوائنٹ مقصد
/scim/v2/Users صارفین کی پروویژننگ اور انتظام
/scim/v2/Groups کردار/گروپ رکنیت کا انتظام
/scim/v2/ServiceProviderConfig SCIM کی صلاحیتیں (ڈسکوری)
/scim/v2/ResourceTypes معاون ریسورس اقسام (ڈسکوری)
/scim/v2/Schemas صارف اور گروپ اسکیمے (ڈسکوری)

مرحلہ 4: طے شدہ (ڈیفالٹ) پروڈکٹ اسائنمنٹ مقرر کریں (اختیاری)

SCIM کے ذریعے پروویژن ہونے پر آپ صارفین کو خودکار طور پر پروڈکٹ لائسنس اسائن کر سکتے ہیں:

  1. SCIM کی ترتیبات کے صفحے پر ڈیفالٹ پروڈکٹ اسائنمنٹ تلاش کریں
  2. ایک پروڈکٹ منتخب کریں:
    • کوئی نہیں - صارفین بغیر پروڈکٹ کے بنائے جاتے ہیں (بعد میں دستی طور پر اسائن کریں)
    • ناظر (Viewer) - صرف دیکھنے کی رسائی
    • پرو بیسک - معیاری ایڈیٹنگ فیچرز
    • پرو کاروبار - مکمل فیچرز تک رسائی
  3. محفوظ کریں پر کلک کریں

نوٹ: صارفین کو پروڈکٹ صرف اسی صورت میں اسائن کیا جائے گا جب سیٹیں دستیاب ہوں۔ اگر کوئی سیٹ دستیاب نہ ہو تو صارف بن جاتا ہے مگر بغیر اسائنمنٹ کے رہتا ہے۔

مرحلہ 5: ٹیسٹ کریں اور صارفین کو اسائن کریں

  1. اپنے آئیڈینٹیٹی پروائیڈر میں SCIM کنیکٹیویٹی کی تصدیق کے لیے Test Connection فیچر استعمال کریں
  2. اپنے IdP میں ایک ٹیسٹ صارف کو ScribbleMaps ایپلیکیشن میں اسائن کریں
  3. تصدیق کریں کہ صارف آپ کی ScribbleMaps ٹیم کے ممبرز کی فہرست میں ظاہر ہوتا ہے
  4. تصدیق ہونے کے بعد، ضرورت کے مطابق مزید صارفین یا گروپس کو اسائن کریں

پروائیڈر کے مخصوص گائیڈز

Okta

  1. Okta ایڈمن کنسول میں Applications > Browse App Catalog پر جائیں
  2. "SCIM 2.0 Test App (Header Auth)" تلاش کریں یا کسٹم SCIM ایپ بنائیں
  3. Provisioning ٹیب > Configure API Integration پر جائیں
  4. Enable API integration پر نشان لگائیں
  5. ترتیب دیں:
    • SCIM 2.0 بیس URL: https://api.scribblemaps.com/scim/v2
    • OAuth بیئرر ٹوکن: اپنا ScribbleMaps SCIM ٹوکن پیسٹ کریں
  6. تصدیق کے لیے Test API Credentials پر کلک کریں
  7. Provisioning > To App پر جائیں اور درج ذیل فعال کریں:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  8. صارفین یا گروپس کو اسائن کرنے کے لیے Assignments ٹیب پر جائیں

Microsoft Entra ID (Azure AD)

  1. Azure Portal میں Microsoft Entra ID > Enterprise Applications پر جائیں
  2. اپنی ScribbleMaps ایپلیکیشن منتخب کریں (یا نئی بنائیں)
  3. Provisioning > شروع کریں پر جائیں
  4. Provisioning Mode کو Automatic پر مقرر کریں
  5. Admin Credentials کے تحت:
    • Tenant URL: https://api.scribblemaps.com/scim/v2
    • Secret Token: اپنا ScribbleMaps SCIM ٹوکن پیسٹ کریں
  6. تصدیق کے لیے Test Connection پر کلک کریں
  7. صارف کی خصوصیات کے لیے Mappings ترتیب دیں
  8. Provisioning Status کو On پر مقرر کریں
  9. صارفین کو اسائن کرنے کے لیے Users and groups پر جائیں

OneLogin

  1. OneLogin ایڈمن میں Applications > Add App پر جائیں
  2. "SCIM Provisioner with SAML (SCIM v2 Core)" یا اس سے ملتی جلتی ایپ تلاش کریں
  3. Configuration ٹیب پر جائیں
  4. ترتیب دیں:
    • SCIM بیس URL: https://api.scribblemaps.com/scim/v2
    • SCIM بیئرر ٹوکن: اپنا ScribbleMaps SCIM ٹوکن پیسٹ کریں
  5. Provisioning ٹیب پر جائیں اور پروویژننگ فعال کریں
  6. صارفین کو اسائن کرنے کے لیے Users ٹیب پر جائیں

JumpCloud

  1. JumpCloud ایڈمن میں SSO Applications پر جائیں
  2. نئی ایپلیکیشن شامل کرنے کے لیے + پر کلک کریں
  3. Custom SCIM منتخب کریں
  4. ترتیب دیں:
    • بیس URL: https://api.scribblemaps.com/scim/v2
    • ٹوکن کی: اپنا ScribbleMaps SCIM ٹوکن پیسٹ کریں
    • تصدیق: بیئرر ٹوکن
  5. Test Connection پر کلک کریں
  6. خصوصیات کی میپنگز ترتیب دیں
  7. ایپلیکیشن کو صارف گروپس اسائن کریں

معاون SCIM آپریشنز

صارف آپریشنز

آپریشن طریقہ معاون تفصیل
صارفین کی فہرست GET /Users ہاں صفحہ بندی اور فلٹرنگ کے ساتھ تمام صارفین حاصل کریں
صارف حاصل کریں GET /Users/{id} ہاں 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]"
بیرونی ID کے ذریعے فلٹر کریں externalId eq "12345"
حیثیت کے ذریعے فلٹر کریں active eq true

صارف کے لائف سائیکل کا انتظام

جب کوئی صارف پروویژن کیا جائے

  1. ScribbleMaps میں ایک نیا ٹیم ممبر اکاؤنٹ بنتا ہے
  2. صارف کی معلومات (نام، ای میل) آپ کے IdP سے بھر دی جاتی ہیں
  3. اگر ڈیفالٹ پروڈکٹ ترتیب دیا گیا ہو اور سیٹیں دستیاب ہوں تو لائسنس خودکار طور پر اسائن ہو جاتا ہے
  4. صارف فوراً SSO کے ذریعے لاگ اِن کر سکتا ہے (اگر ترتیب دیا گیا ہو)

جب کوئی صارف اپ ڈیٹ کیا جائے

  1. صارف کی خصوصیات (نام، ڈسپلے نام) آپ کے IdP سے مطابقت کے لیے اپ ڈیٹ ہو جاتی ہیں
  2. ای میل کی تبدیلیاں ہم آہنگ ہو جاتی ہیں (سوائے اس کے کہ صارف نے اپنا اکاؤنٹ لنک کر رکھا ہو)

جب کسی صارف کی ڈی پروویژننگ کی جائے

  1. صارف کا اکاؤنٹ غیر فعال کر دیا جاتا ہے (سافٹ ڈیلیٹ)
  2. تمام پروڈکٹ لائسنس ہٹا دیے جاتے ہیں، جس سے سیٹیں خالی ہو جاتی ہیں
  3. تمام فعال سیشنز فوراً ختم کر دیے جاتے ہیں
  4. صارف مزید لاگ اِن نہیں کر سکتا
  5. صارف کا ڈیٹا اور نقشے محفوظ رہتے ہیں (حذف نہیں کیے جاتے)
  6. اگر صارف کو دوبارہ پروویژن کیا جائے تو اکاؤنٹ دوبارہ فعال کیا جا سکتا ہے

گروپس کے ذریعے کرداروں کا انتظام

ScribbleMaps، SCIM کے ذریعے دو کردار گروپس فراہم کرتا ہے:

گروپ ID کردار اجازتیں
admin منتظم ٹیم کی ترتیبات، صارفین اور بلنگ کا انتظام کریں
member ممبر ٹیم ممبر کی معیاری رسائی

کسی صارف کو ایڈمن بنانے کے لیے، SCIM PATCH کے ذریعے اسے admin گروپ میں شامل کریں۔ اونر کردار کو SCIM کے ذریعے تبدیل نہیں کیا جا سکتا۔

مسائل کا حل

عام مسائل

"401 Unauthorized" یا "Invalid token"

  • تصدیق کریں کہ بیئرر ٹوکن درست ہے اور منسوخ نہیں کیا گیا
  • یقینی بنائیں کہ ٹوکن Authorization ہیڈر میں Bearer YOUR_TOKEN کی شکل میں بھیجا جا رہا ہے
  • چیک کریں کہ ٹوکن کی میعاد ختم تو نہیں ہو گئی (اگر میعاد مقرر کی گئی تھی)
  • ضرورت ہو تو نیا ٹوکن تیار کریں

"409 Conflict" - صارف پہلے سے موجود ہے

  • اس ای میل کا صارف آپ کی ٹیم میں پہلے سے موجود ہے
  • اگر موجودہ صارف غیر فعال کیا گیا تھا تو SCIM اسے خودکار طور پر دوبارہ فعال کر دے گا
  • اپنے IdP میں ڈپلیکیٹ ای میل ایڈریس چیک کریں

"400 Bad Request" - لازمی فیلڈ غائب ہے

  • یقینی بنائیں کہ درخواست میں userName (ای میل) شامل ہے
  • تصدیق کریں کہ ای میل کی شکل درست ہے
  • اپنے IdP کی خصوصیات کی میپنگ کی ترتیب چیک کریں

صارفین بن گئے لیکن کوئی پروڈکٹ اسائن نہیں ہوا

  • چیک کریں کہ SCIM کی ترتیبات میں ڈیفالٹ پروڈکٹ ترتیب دیا گیا ہے یا نہیں
  • تصدیق کریں کہ ڈیفالٹ پروڈکٹ کے لیے آپ کے پاس سیٹیں دستیاب ہیں
  • صارفین کو ٹیم کی ترتیبات میں دستی طور پر پروڈکٹس اسائن کیے جا سکتے ہیں

صارف کی تبدیلیاں سنک نہیں ہو رہیں

  • کچھ IdPs شیڈول پر سنک کرتے ہیں (مثلاً Azure AD کے لیے ہر 40 منٹ بعد)
  • اپنے IdP میں دستی سنک زبردستی چلانے کی کوشش کریں
  • تصدیق کریں کہ SCIM اب بھی فعال ہے اور ٹوکن درست ہے

ٹیسٹ کنکشن ناکام ہو جاتا ہے

  • تصدیق کریں کہ SCIM بیس URL بالکل https://api.scribblemaps.com/scim/v2 ہے
  • یقینی بنائیں کہ آخر میں کوئی اضافی سلیش یا ٹائپنگ کی غلطی نہیں ہے
  • چیک کریں کہ آپ کا نیٹ ورک/فائر وال api.scribblemaps.com کی طرف آؤٹ باؤنڈ HTTPS کی اجازت دیتا ہے
     

مدد چاہیے؟

اگر آپ کو SCIM پروویژننگ میں مسائل کا سامنا ہے تو براہِ کرم ہماری سپورٹ ٹیم سے درج ذیل معلومات کے ساتھ رابطہ کریں:

  • آپ کی ٹیم کا نام
  • آپ جو آئیڈینٹیٹی پروائیڈر استعمال کر رہے ہیں
  • آپ کے IdP کے پروویژننگ لاگز سے کوئی بھی ایرر میسج
  • آپ کی SCIM ترتیب کے اسکرین شاٹس (ٹوکن چھپا کر)

ہم آپ کی تنظیم کے لیے SCIM پروویژننگ ترتیب دینے میں آپ کی مدد کے لیے حاضر ہیں۔

آخری تازہ کاری