የScribble Maps የእገዛ ማዕከል
ቋንቋ ይቀይሩ

SCIM ማቅረብ (Provisioning)

SCIM የተጠቃሚ ማቅረብን ማዋቀር

ScribbleMaps ለራስ-ሰር የተጠቃሚ ማቅረብ እና ማስወገድ SCIM 2.0 (System for Cross-domain Identity Management) ይደግፋል። ይህ ተጠቃሚዎችን ከማንነት አቅራቢዎ (IdP) ወደ ScribbleMaps በራስ-ሰር እንዲያመሳስሉ ያስችልዎታል፣ የቡድን አባልነትም ከድርጅትዎ ማውጫ ጋር በተመሳሳይ ሁኔታ እንዲቆይ ያደርጋል።

SCIM ማቅረብ በ team.scribblemaps.com ላይ ይገኛል እና ሙሉ በሙሉ ነፃ ነው።

ማውጫ

  1. SCIM ምንድን ነው?
  2. ከመጀመርዎ በፊት
  3. ደረጃ 1፡ SCIM ን በScribbleMaps ውስጥ ማንቃት
  4. ደረጃ 2፡ Bearer Token አመንጭ
  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፡ SCIM ን በScribbleMaps ውስጥ ማንቃት

  1. ወደ team.scribblemaps.com ይግቡ
  2. ወደ SCIM ማቅረብ (በግራ ጎን አሞሌ) ይሂዱ
  3. SCIM አንቃ የሚለውን ወደ ON ይቀይሩ

ማስታወሻ፦ SCIM ሙሉ በሙሉ እንዲነቃ በመጀመሪያ bearer token ማመንጨት ያስፈልግዎታል።

ደረጃ 2፡ Bearer Token አመንጭ

Bearer token የማንነት አቅራቢዎን ከScribbleMaps ጋር ያረጋግጣል።

  1. በSCIM ቅንብሮች ገጽ ላይ Token አመንጭ የሚለውን ጠቅ ያድርጉ
  2. ቶከኑን ወዲያውኑ ቅዳ እና በደህንነት አስቀምጥ

አስፈላጊ የጥበቃ ማስታወሻዎች፦

  • ቶከኑ የሚታየው አንድ ጊዜ ብቻ ነው - ከጠፋብዎት አዲስ ማመንጨት ያስፈልግዎታል
  • ይህንን ቶከን እንደ የይለፍ ቃል ይያዙት - ቶከኑ ያለው ማንኛውም ሰው የቡድንዎን ተጠቃሚዎች ማስተዳደር ይችላል
  • ከተበላሸ በማንኛውም ጊዜ ቶከኑን መሰረዝ እና እንደገና ማመንጨት ይችላሉ
  • ቶከን መሰረዝ አዲስ ቶከን እስኪዋቀር ድረስ ሁሉንም የSCIM ክዋኔዎች ወዲያውኑ ያቆማል

ደረጃ 3፡ የማንነት አቅራቢዎን ማዋቀር

ScribbleMaps ን በIdP ዎ ውስጥ እንደ SCIM መተግበሪያ ለማዋቀር የሚከተሉትን ዝርዝሮች ይጠቀሙ፦

ቅንብር ዋጋ
SCIM Base URL https://api.scribblemaps.com/scim/v2
የማረጋገጫ ዘዴ HTTP Header / Bearer Token
Authorization ራስጌ Bearer YOUR_TOKEN_HERE
ልዩ (Unique) መለያ userName (የኢሜይል አድራሻ)

የSCIM Endpoints ማጣቀሻ

Endpoint ዓላማ
/scim/v2/Users የተጠቃሚ ማቅረብ እና አስተዳደር
/scim/v2/Groups የሚና/ቡድን አባልነት አስተዳደር
/scim/v2/ServiceProviderConfig የSCIM ችሎታዎች (ግኝት)
/scim/v2/ResourceTypes የሚደገፉ የሀብት ዓይነቶች (ግኝት)
/scim/v2/Schemas የተጠቃሚ እና ቡድን ስኬማዎች (ግኝት)

ደረጃ 4፡ ነባሪ የምርት ምደባ አዘጋጅ (አማራጭ)

ተጠቃሚዎች በSCIM ሲቀርቡ የምርት ፈቃድ በራስ-ሰር መመደብ ይችላሉ፦

  1. በSCIM ቅንብሮች ገጽ ላይ ነባሪ የምርት ምደባ ያግኙ
  2. ምርት ይምረጡ፦
    • ምንም - ተጠቃሚዎች ያለ ምርት ይፈጠራሉ (በኋላ በእጅ ይመድቡ)
    • ተመልካች (Viewer) - የእይታ-ብቻ መዳረሻ
    • Pro Basic - መደበኛ የአርትዖት ባህሪያት
    • Pro Business - ሙሉ የባህሪ መዳረሻ
  3. አስቀምጥ ን ጠቅ ያድርጉ

ማስታወሻ፦ ተጠቃሚዎች ምርት የሚመደብላቸው መቀመጫዎች ካሉ ብቻ ነው። መቀመጫዎች ከሌሉ ተጠቃሚው ይፈጠራል ነገር ግን ሳይመደብ ይቀራል።

ደረጃ 5፡ ሞክር እና ተጠቃሚዎችን መድብ

  1. በማንነት አቅራቢዎ ውስጥ የSCIM ግንኙነትን ለማረጋገጥ ግንኙነት ሞክር ባህሪን ይጠቀሙ
  2. በIdP ዎ ውስጥ የሙከራ ተጠቃሚን ለScribbleMaps መተግበሪያ ይመድቡ
  3. ተጠቃሚው በScribbleMaps የቡድን አባላት ዝርዝር ውስጥ መታየቱን ያረጋግጡ
  4. ከተረጋገጠ በኋላ እንደ አስፈላጊነቱ ተጨማሪ ተጠቃሚዎችን ወይም ቡድኖችን ይመድቡ

የአቅራቢ-ተኮር መመሪያዎች

Okta

  1. በOkta Admin Console ውስጥ ወደ 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 Base URL፦ https://api.scribblemaps.com/scim/v2
    • OAuth Bearer Token፦ የ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 Admin ውስጥ ወደ Applications > Add App ይሂዱ
  2. "SCIM Provisioner with SAML (SCIM v2 Core)" ወይም ተመሳሳይ ይፈልጉ
  3. ወደ Configuration ትር ይሂዱ
  4. አዋቅር፦
    • SCIM Base URL፦ https://api.scribblemaps.com/scim/v2
    • SCIM Bearer Token፦ የScribbleMaps SCIM ቶከንዎን ለጥፍ
  5. ወደ Provisioning ትር ይሂዱ እና ማቅረብን ያንቁ
  6. ተጠቃሚዎችን ለመመደብ ወደ Users ትር ይሂዱ

JumpCloud

  1. በJumpCloud Admin ውስጥ ወደ SSO Applications ይሂዱ
  2. አዲስ መተግበሪያ ለመጨመር + ን ጠቅ ያድርጉ
  3. Custom SCIM ን ይምረጡ
  4. አዋቅር፦
    • Base URL፦ https://api.scribblemaps.com/scim/v2
    • Token Key፦ የScribbleMaps SCIM ቶከንዎን ለጥፍ
    • Authentication፦ Bearer Token
  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 ባህሪ (Attribute) የ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 ከተዋቀረ) ወዲያውኑ በSSO መግባት ይችላል

ተጠቃሚ ሲዘምን

  1. የተጠቃሚ ባህሪያት (ስም፣ የሚታይ ስም) ከIdP ዎ ጋር እንዲዛመዱ ይዘምናሉ
  2. የኢሜይል ለውጦች ይመሳሰላሉ (ተጠቃሚው መለያውን ካላገናኘ በስተቀር)

ተጠቃሚ ሲወገድ

  1. የተጠቃሚው መለያ ይቦዝናል (ለስላሳ ስረዛ)
  2. ሁሉም የምርት ፈቃዶች ይወገዳሉ፣ መቀመጫዎችም ነፃ ይሆናሉ
  3. ሁሉም ንቁ ክፍለ ጊዜዎች ወዲያውኑ ይሰረዛሉ
  4. ተጠቃሚው ከዚያ በኋላ መግባት አይችልም
  5. የተጠቃሚ ውሂብ እና ካርታዎች ይጠበቃሉ (አይሰረዙም)
  6. ተጠቃሚው እንደገና ከቀረበ መለያው እንደገና ሊነቃ ይችላል

በቡድኖች በኩል የሚና አስተዳደር

ScribbleMaps በSCIM በኩል ሁለት የሚና ቡድኖችን ያጋልጣል፦

የቡድን ID ሚና ፈቃዶች
admin አስተዳዳሪ የቡድን ቅንብሮችን፣ ተጠቃሚዎችን እና ክፍያን ያስተዳድራል
member አባል መደበኛ የቡድን አባል መዳረሻ

ተጠቃሚን እንደ አስተዳዳሪ ለመመደብ በSCIM PATCH በኩል ወደ admin ቡድን ያክሉት። ባለቤት ሚና በSCIM ሊቀየር አይችልም።

ችግር መፍታት

የተለመዱ ችግሮች

"401 Unauthorized" ወይም "Invalid token"

  • bearer token ትክክል መሆኑን እና አለመሰረዙን ያረጋግጡ
  • ቶከኑ በAuthorization ራስጌ ውስጥ እንደ Bearer YOUR_TOKEN መተላለፉን ያረጋግጡ
  • ቶከኑ ጊዜው ማለፉን ያረጋግጡ (የማብቂያ ጊዜ ከተቀናበረ)
  • አስፈላጊ ከሆነ አዲስ ቶከን አመንጭ

"409 Conflict" - ተጠቃሚው አስቀድሞ አለ

  • ያ ኢሜይል ያለው ተጠቃሚ በቡድንዎ ውስጥ አስቀድሞ አለ
  • ያለው ተጠቃሚ ከቦዘነ SCIM በራስ-ሰር እንደገና ያነቃዋል
  • በIdP ዎ ውስጥ የተባዙ የኢሜይል አድራሻዎችን ያረጋግጡ

"400 Bad Request" - የሚያስፈልግ መስክ ጠፍቷል

  • userName (ኢሜይል) በጥያቄው ውስጥ መካተቱን ያረጋግጡ
  • የኢሜይል ቅርጸት ትክክለኛ መሆኑን ያረጋግጡ
  • የIdP ዎን የባህሪ ካርታ ውቅር ያረጋግጡ

ተጠቃሚዎች ተፈጥረዋል ግን ምንም ምርት አልተመደበም

  • በSCIM ቅንብሮች ውስጥ ነባሪ ምርት መዋቀሩን ያረጋግጡ
  • ለነባሪው ምርት የሚገኙ መቀመጫዎች እንዳሉ ያረጋግጡ
  • ምርቶች በቡድን ቅንብሮች ውስጥ በእጅ ሊመደቡ ይችላሉ

የተጠቃሚ ለውጦች አይመሳሰሉም

  • አንዳንድ IdP ዎች በጊዜ ሰሌዳ ያመሳስላሉ (ለምሳሌ፣ ለAzure AD በየ40 ደቂቃው)
  • በIdP ዎ ውስጥ በእጅ ማመሳሰልን ለማስገደድ ይሞክሩ
  • SCIM አሁንም መንቃቱን እና ቶከኑ ትክክለኛ መሆኑን ያረጋግጡ

የግንኙነት ሙከራ አይሳካም

  • SCIM Base URL በትክክል https://api.scribblemaps.com/scim/v2 መሆኑን ያረጋግጡ
  • ምንም የመጨረሻ ስላሾች ወይም የፊደል ስህተቶች አለመኖራቸውን ያረጋግጡ
  • አውታረ መረብዎ/ፋየርዎልዎ ወደ api.scribblemaps.com የሚወጣ HTTPS እንደሚፈቅድ ያረጋግጡ
     

እገዛ ይፈልጋሉ?

በSCIM ማቅረብ ላይ ችግር እያጋጠመዎት ከሆነ፣ እባክዎ የድጋፍ ቡድናችንን በሚከተለው መረጃ ያግኙ፦

  • የቡድንዎ ስም
  • የሚጠቀሙበት የማንነት አቅራቢ
  • ከIdP ዎ የማቅረብ ምዝግብ ማስታወሻዎች ማንኛውም የስህተት መልዕክቶች
  • የSCIM ውቅርዎ ቅጽበታዊ ገጽ እይታዎች (ቶከኑ ተደብቆ)

ለድርጅትዎ SCIM ማቅረብን እንዲያዋቅሩ ለመርዳት እዚህ ነን።

መጨረሻ የተዘመነው