Scribble Maps Help Center
Change language

SCIM ፕሮቪዥኒንግ

SCIM ናይ ተጠቃሚ ፕሮቪዥኒንግ ምቕዳሕ

ScribbleMaps ንውቑዕ ናይ ተጠቃሚ ፕሮቪዥኒንግን ደፋሕ ፕሮቪዥኒንግን SCIM 2.0 (System for Cross-domain Identity Management) ይድግፍ። እዚ ንተጠቐምቲ ካብ ናይ Identity Provider (IdP) ናብ ScribbleMaps ብኣውቶማቲክ ንኽተሳሰሩ የኽእል፣ ኣባልነት ጉጅለ ድማ ምስ ናይ ውድባትካ ዳይሬክተሪ ሓደ ምዃኑ የረጋግጽ።

SCIM ፕሮቪዥኒንግ ኣብ team.scribblemaps.com ይርከብ፣ ሙሉእ ብሙሉእ ድማ ብነጻ እዩ።

ዝርዝር ትሕዝቶ

  1. SCIM እንታይ እዩ?
  2. ቅድሚ ምጅማርካ
  3. ስጉምቲ 1፦ SCIM ኣብ ScribbleMaps ኣንቅሕ
  4. ስጉምቲ 2፦ Bearer Token ፍጠር
  5. ስጉምቲ 3፦ Identity Provider ኣዋቕር
  6. ስጉምቲ 4፦ ናይ ቀዳምነት ፕሮዳክት ምምዳብ ኣቐምጥ
  7. ስጉምቲ 5፦ ፈትንን ተጠቐምቲ መድብን
  8. ናይ ፕሮቫይደር ፍሉይ መምርሒታት
  9. ዝድገፉ SCIM ተግባራት
  10. ናይ ተጠቃሚ ዕድመ ምሕደራ
  11. ጸገማት ምፍታሕ

SCIM እንታይ እዩ?

SCIM (System for Cross-domain Identity Management) ብኣውቶማቲክ ንኸም ዝስዕብ ዝገብር ክፉት መዐቀኒ እዩ፦

  • ተጠቐምቲ ፕሮቪዥን ምግባር - ተጠቐምቲ ኣብ IdP ክምደቡ ከለዉ ናይ ScribbleMaps ሕሳባት ብኣውቶማቲክ ይፍጠር
  • ተጠቐምቲ ምምሕያሽ - ሓበሬታ ተጠቃሚ (ስም፣ ኢሜይል) ሓደ ኮይኑ ይጸንሕ
  • ተጠቐምቲ ደፋሕ ፕሮቪዥን ምግባር - ተጠቐምቲ ካብ IdP ክወጹ ከለዉ ሕሳባት ብኣውቶማቲክ ይእገዱ
  • ግደታት ምሕደራ - ተጠቐምቲ ብኣባልነት ጉጅለ ናብ Admin ወይ Member ግደታት ይምደቡ

SCIM ምስ SSO (SAML/OIDC) ብሓባር ይሰርሕ፣ ምሉእ ናይ ማንነት ዕድመ ምሕደራ ድማ የቕርብ።

ቅድሚ ምጅማርካ

  • SCIM ንምውቓር Team Owner ክትከውን ኣለካ
  • ናይ Identity Provider ኣድሚን ኮንሶል ክትሓቁፍ ኣለካ
  • IdP ካብ SCIM 2.0 ክድግፍ ኣለዎ (Okta፣ Microsoft Entra ID፣ OneLogin፣ JumpCloud፣ ወዘተ)
  • ንዝበለጸ ተሞክሮ ተጠቃሚ ቅድሚ SCIM ንSSO ከተዋቕር ንሰፍር

ስጉምቲ 1፦ SCIM ኣብ ScribbleMaps ኣንቅሕ

  1. ናብ team.scribblemaps.com ኣተዉ
  2. ናብ SCIM Provisioning (ኣብ ጸጋማይ ጎኒ ባር) ኣቕንዕ
  3. Enable SCIM ናብ ON ቀይሮ

ጠንቂ፦ SCIM ሙሉእ ብሙሉእ ቅድሚ ምንቃሑ bearer token ክትፈጥር ኣለካ።

ስጉምቲ 2፦ Bearer Token ፍጠር

Bearer token ንIdentity Provider ምስ ScribbleMaps የረጋግጽ።

  1. ኣብ SCIM ቅጥዕታት ገጽ፣ Generate Token ጠውቅ
  2. ቶከን ብቕልጡፍ ቀዲሕካ ብውሑስ ኣቐምጦ

ኣገዳሲ ናይ ድሕነት ምልክታት፦

  • ቶከን ሓንሳብ ጥራይ እዩ ዝርኣይ - እንተ ሃሰስካዮ ሓድሽ ክትፈጥር ኣለካ
  • ነዚ ቶከን ከም ፓስዎርድ ሓዝ - ቶከን ዘለዎ ዝዀነ ሰብ ተጠቐምቲ ጉጅለኻ ከመሓድር ይኽእል
  • እንተ ተጋሊጹ ኣብ ዝዀነ እዋን ቶከን ክትሰርዝን ከም ሓድሽ ክትፈጥርን ትኽእል
  • ቶከን ምስራዝ ሓድሽ ቶከን ክሳብ ዝዋቀር ኩሎም SCIM ተግባራት ቅጽበታዊ የቋርጽ

ስጉምቲ 3፦ Identity Provider ኣዋቕር

ScribbleMaps ከም SCIM ኣፕሊኬሽን ኣብ IdP ንምውቓር እዞም ዝስዕቡ ዝርዝራት ተጠቐም፦

ቅጥዕታት ዋጋ
SCIM Base URL https://api.scribblemaps.com/scim/v2
ናይ ምርግጋጽ ዘዴ HTTP Header / Bearer Token
Authorization Header Bearer YOUR_TOKEN_HERE
ፍሉይ መለለዪ userName (ኢሜይል ኣድራሻ)

SCIM Endpoints መወከሲ

Endpoint ዕላማ
/scim/v2/Users ናይ ተጠቃሚ ፕሮቪዥኒንግን ምሕደራን
/scim/v2/Groups ናይ ግደ/ጉጅለ ኣባልነት ምሕደራ
/scim/v2/ServiceProviderConfig SCIM ክእለታት (ምልላይ)
/scim/v2/ResourceTypes ዝድገፉ ዓይነታት ሃብቲ (ምልላይ)
/scim/v2/Schemas ናይ ተጠቃሚን ጉጅለን ስኪማታት (ምልላይ)

ስጉምቲ 4፦ ናይ ቀዳምነት ፕሮዳክት ምምዳብ ኣቐምጥ (ኣማራጺ)

ተጠቐምቲ ብSCIM ክፕሮቪዥኑ ከለዉ ብኣውቶማቲክ ናይ ፕሮዳክት ፍቓድ ክትመድበሎም ትኽእል፦

  1. ኣብ SCIM ቅጥዕታት ገጽ፣ Default Product Assignment ርኸብ
  2. ፕሮዳክት ምረጽ፦
    • None - ተጠቐምቲ ብዘይ ፕሮዳክት ይፍጠሩ (ኣብ ድሕሪ ብኢድ መድብ)
    • Viewer - ምርኣይ ጥራይ ዝፈቅድ ምድራስ
    • Pro Basic - ስሩዕ ናይ ኤዲት ባህርያት
    • Pro Business - ምሉእ ናይ ባህርያት ምድራስ
  3. Save ጠውቅ

ጠንቂ፦ ተጠቐምቲ ፕሮዳክት ዝምደቡ ክፍተታት እንተሎ ጥራይ እዩ። ክፍተታት እንተ ዘየለ፣ ተጠቃሚ ይፍጠር ግን ብዘይ ምምዳብ ይተርፍ።

ስጉምቲ 5፦ ፈትንን ተጠቐምቲ መድብን

  1. ኣብ Identity Provider፣ SCIM ምትእስሳር ንምርግጋጽ Test Connection ባህሪ ተጠቐም
  2. ሓደ መፈተኒ ተጠቃሚ ናብ ScribbleMaps ኣፕሊኬሽን ኣብ IdP መድብ
  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 > Get Started ኪድ
  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 እወ ናይ Admin ን Member ን ግደ ጉጅለታት ይመልስ
ጉጅለ ምምጻእ 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 ጉጅለ ወስኽዎ። ናይ Owner ግደ ብSCIM ክቕየር ኣይክእልን።

ጸገማት ምፍታሕ

ልሙድ ጸገማት

"401 Unauthorized" ወይ "Invalid token"

  • bearer token ቅኑዕ ምዃኑን ዘይተሰርዘ ምዃኑን ኣረጋግጽ
  • ቶከን ኣብ Authorization header ከም Bearer YOUR_TOKEN ምምጻኡ ኣረጋግጽ
  • ቶከን ዘመን ሓሊፍዎ እንተሎ (ዘመን እንተ ተቐሚጡ) ርአ
  • እንተድሊ ሓድሽ ቶከን ፍጠር

"409 Conflict" - ተጠቃሚ ድሮ ኣሎ

  • ብዚ ኢሜይል ዘሎ ተጠቃሚ ድሮ ኣብ ጉጅለኻ ኣሎ
  • እቲ ዘሎ ተጠቃሚ እንተ ተኣጊዱ፣ SCIM ብኣውቶማቲክ ደጊሙ የንቅሖ
  • ኣብ IdPካ ድግሙ ኢሜይል ኣድራሻታት ርአ

"400 Bad Request" - ዘድሊ ሜዳ ጎዲሉ

  • userName (ኢሜይል) ኣብ ሕቶ ምዃኑ ኣረጋግጽ
  • ቅርጺ ኢሜይል ትኽክል ምዃኑ ኣረጋግጽ
  • ናይ IdPካ ባህሪ ምስሕሓብ ኣወቓቕራ ርአ

ተጠቐምቲ ተፈጢሮም ግን ፕሮዳክት ኣይተመደበን

  • ኣብ SCIM ቅጥዕታት ናይ ቀዳምነት ፕሮዳክት ተዋሪዱ ከም ዘሎ ርአ
  • ንናይ ቀዳምነት ፕሮዳክት ዝርከቡ ክፍተታት ከም ዘለዉ ኣረጋግጽ
  • ተጠቐምቲ ኣብ Team Settings ብኢድ ፕሮዳክት ክምደቡ ይኽእሉ

ለውጥታት ተጠቃሚ ኣይተሳሰሩን

  • ገለ IdPs ብጊዜ ሰሌዳ እዮም ዝሳሰሉ (ንኣብነት፣ ንAzure AD ነፍሲ ወከፍ 40 ደቓይቅ)
  • ኣብ IdPካ ብኢድ ምስሳል ኣስገድድ
  • SCIM ገና ዝንቁሕ ምዃኑን ቶከን ቅኑዕ ምዃኑን ኣረጋግጽ

Test connection ይወድቕ

  • SCIM Base URL ብትክክል https://api.scribblemaps.com/scim/v2 ምዃኑ ኣረጋግጽ
  • ደሓሪ ስላሽ ወይ ጌጋ ምጽሓፍ ከም ዘየለ ኣረጋግጽ
  • መርበብካ/ፋየርዎል ናብ api.scribblemaps.com ወጻኢ HTTPS ከም ዝፈቅድ ርአ
     

ሓገዝ ትደልዩ ዲኹም?

ብSCIM ፕሮቪዥኒንግ ጸገማት እንተ ኣጋጢምኩም፣ በጃኹም ምስ ጉጅለ ሓገዝና ብዝስዕብ ሓበሬታ ተወከሱ፦

  • ስም ጉጅለኹም
  • እትጥቀምዎ Identity Provider
  • ካብ ናይ IdPኩም ፕሮቪዥኒንግ ሎጎታት ዝመጹ ዝዀነ ዓይነት መልእኽቲ ጌጋ
  • ናይ SCIM ኣወቓቕራኹም ስክሪንሾታት (ቶከን ተሸፊኑ)

SCIM ፕሮቪዥኒንግ ንውድባትኩም ንኽተዋቕሩ ንሕግዘኩም ኣሎና።

Last updated