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. 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. اَکھ پروڈَکٹ چُنِو:
    • کانٛہہ نہٕ - صٲرِف بَنَن بغیر پروڈَکٹَس (بَعدَس منٛز ہَتھ سان اسائن کٔرِو)
    • ویوور - صِرف وُچھنہٕ رَسائی
    • پرو بیسک - معیاری ایڈِٹنگ خاصیتَن
    • Pro کاروبار - مُکَمَل خاصیتَن رَسائی
  3. مَحفوظ کٔرِو کِلِک کٔرِو

نوٹ: صٲرِفَن گَژھہِ پروڈَکٹ صِرف تِتھ وَختہٕ اسائن سَپدُن یتھ سیٹس دستیاب چھہ۔ اَگر سیٹس چھہ نہٕ دستیاب، صٲرِف چھہ بَنان مگر بغیر اسائنمَنٹَس۔

قدم 5: ٹیسٹ کٔرِو تہٕ صٲرِف اسائن کٔرِو

  1. پنُنہِ آئیڈینٹِٹی پرووائیڈَرَس مَنٛز SCIM کَنیکٹِوِٹی تَصدیٖق کَرنہٕ خٲطرٕ ٹیسٹ کَنیکشَن خاصیَت اِستِعمال کٔرِو
  2. ٹیسٹ صٲرِف پنُنہِ IdP مَنٛز ScribbleMaps اَیپلیکیشَنَس اسائن کٔرِو
  3. تَصدیٖق کٔرِو زِ صٲرِف تُہنٛدِ ScribbleMaps ٹیم ممبَرز لِسٹس مَنٛز ظاہِر چُھ سَپدان
  4. اکہِ لَٹہِ تَصدیٖق سَپدنہٕ پَتہٕ، ضَرورَت مُطابِق مَزید صٲرِف یا گروپ اسائن کٔرِو

پرووائیڈَر مُتَعَلَق گائیڈز

Okta

  1. Okta ایڈمن کَنسولَس مَنٛز Applications > Browse App Catalog پؠٹھ گَژھِو
  2. "SCIM 2.0 Test App (Header Auth)" تَلِاش کٔرِو یا حَسبِ ضَرورَت SCIM ایپ بَنٲوِو
  3. Provisioning ٹیب > کَنفِگَر کٔرِو 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 پورٹَل مَنٛز 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
    • Token Key: پنُن ScribbleMaps SCIM ٹوکَن پیسٹ کٔرِو
    • Authentication: بیئرَر ٹوکَن
  5. Test Connection کِلِک کٔرِو
  6. اَوصاف میپِنگس کَنفِگَر کٔرِو
  7. اَیپلیکیشَنَس صٲرِف گروپ اسائن کٔرِو

سَپورٹیڈ SCIM آپریشَنز

صٲرِف آپریشَنز

آپریشَن طَریٖقہٕ سَپورٹیڈ وضاحَت
List Users GET /Users آ سٲری صٲرِف پیٖجینیشَن تہٕ فِلٹَرِنگ سٍتۍ حاصِل کٔرِو
Get User GET /Users/{id} آ ID ہس مُطابِق مُخصوص صٲرِف حاصِل کٔرِو
Create User POST /Users آ نَو صٲرِف پروویژَن کٔرِو
Replace User PUT /Users/{id} آ صٲرِف اَوصاف مُکَمَل اَپڈیٹ
Update User PATCH /Users/{id} آ صٲرِف اَوصاف جُزوی اَپڈیٹ
Delete User DELETE /Users/{id} آ صٲرِف ڈی ایکٹیویٹ کٔرِو (سافٹ ڈیلیٹ)

گروپ آپریشَنز

آپریشَن طَریٖقہٕ سَپورٹیڈ وضاحَت
List Groups GET /Groups آ ایڈمن تہٕ ممبَر کِردار گروپ واپس دِوان چُھ
Get Group GET /Groups/{id} آ ممبَر لِسٹ سٍتۍ گروپ حاصِل کٔرِو
Update Group PATCH /Groups/{id} آ کِردار گروپَس مَنٛز ممبَر شٲمِل/ہَٹاوِو
Create Group 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 سیٹنگس مَنٛز ڈیفالٹ پروڈَکٹ کَنفِگَر چُھ
  • تَصدیٖق کٔرِو زِ ڈیفالٹ پروڈَکٹَس خٲطرٕ سیٹس چھِ دستیاب
  • صٲرِفَن ہیکِو ٹیم سیٹنگس مَنٛز ہَتھ سان پروڈَکٹ اسائن کَرِتھ

صٲرِف تَبدیٖلیٖ چھِ نہٕ سِنک سَپدان

  • کٔنہِ IdP چھِ شیڈیول پؠٹھ سِنک کَران (مَثلاً Azure AD خٲطرٕ ہَر 40 مِنَٹ)
  • پنُنہِ IdP مَنٛز ہَتھ سان سِنک زَبَردَستی کَرنُک کوشِش کٔرِو
  • تَصدیٖق کٔرِو زِ SCIM چُھ اَجی تہِ اِنیبل تہٕ ٹوکَن چُھ دُرُست

ٹیسٹ کَنیکشَن چُھ ناکام سَپدان

  • تَصدیٖق کٔرِو زِ SCIM بَنیا دی URL چُھ بِلکُل https://api.scribblemaps.com/scim/v2
  • یَقیٖن کٔرِو زِ کانٛہہ ٹریلنگ سلیش یا ٹائپو چھہ نہٕ
  • چیک کٔرِو زِ تُہنٛد نیٹ وَرک/فائروال چُھ api.scribblemaps.com ہس آؤٹ باؤنڈ HTTPS اِجازَتھ دِوان
     

مَدَتھ ضَروٗرَت چھہ؟

اَگر تُہہِ SCIM پروویژَنِنگ سٍتۍ مَسلہٕ چھِو تَجرُبہٕ کَران، مَہربٲنی کٔرِتھ پنُن سَپورٹ ٹیم سٍتۍ یِم رابطہٕ کٔرِو:

  • تُہنٛد ٹیم نام
  • تُہہِ کُس آئیڈینٹِٹی پرووائیڈَر چِھو اِستِعمال کَران
  • پنُنہِ IdP ہِنٛدِ پروویژَنِنگ لاگس نِشہِ کانٛہہ تہِ ایرَر میسیجز
  • پنُن SCIM کَنفِگَریشَنَس سکرین شاٹس (ٹوکَن چُھپٲوِتھ)

اسۍ چھِ تُہنٛدِس تنظیمَس خٲطرٕ SCIM پروویژَنِنگ کَنفِگَر کَرنَس مَنٛز مَدَتھ کَرنہٕ خٲطرٕ مَوجود۔

آخری اپ ڈیٹ