Scribble Maps સહાય કેન્દ્ર
ભાષા બદલો

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: ScribbleMaps માં SCIM સક્ષમ કરો
  4. પગલું 2: Bearer ટોકન જનરેટ કરો
  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: ScribbleMaps માં SCIM સક્ષમ કરો

  1. team.scribblemaps.com માં લૉગ ઇન કરો
  2. SCIM Provisioning (ડાબી બાજુની સાઇડ બાર) પર જાઓ
  3. Enable SCIM ને ON પર ટૉગલ કરો

નોંધ: SCIM સંપૂર્ણપણે સક્ષમ થાય તે પહેલાં તમારે bearer ટોકન જનરેટ કરવું પડશે.

પગલું 2: Bearer ટોકન જનરેટ કરો

Bearer ટોકન તમારા Identity Provider ને ScribbleMaps સાથે પ્રમાણિત કરે છે.

  1. SCIM સેટિંગ્સ પેજ પર, જનરેટ કરો Token પર ક્લિક કરો
  2. ટોકન તરત જ કૉપિ કરો અને તેને સુરક્ષિત રીતે સંગ્રહિત કરો

મહત્વપૂર્ણ સુરક્ષા નોંધો:

  • ટોકન ફક્ત એક જ વાર દર્શાવવામાં આવે છે - જો તમે તેને ગુમાવો, તો તમારે નવું જનરેટ કરવું પડશે
  • આ ટોકનને પાસવર્ડની જેમ ગણો - ટોકન ધરાવનાર કોઈપણ તમારી ટીમના વપરાશકર્તાઓને વ્યવસ્થાપિત કરી શકે છે
  • જો ટોકન જોખમમાં આવે તો તમે કોઈપણ સમયે તેને રદ કરી શકો છો અને ફરીથી જનરેટ કરી શકો છો
  • ટોકન રદ કરવાથી નવું ટોકન ગોઠવાય ત્યાં સુધી બધી SCIM કામગીરીઓ તરત જ બંધ થઈ જાય છે

પગલું 3: તમારો Identity Provider ગોઠવો

તમારા IdP માં ScribbleMaps ને SCIM એપ્લિકેશન તરીકે ગોઠવવા માટે નીચેની વિગતોનો ઉપયોગ કરો:

સેટિંગ મૂલ્ય
SCIM Base URL https://api.scribblemaps.com/scim/v2
Authentication Method HTTP Header / Bearer Token
Authorization Header Bearer YOUR_TOKEN_HERE
અનન્ય (Unique) Identifier userName (ઇમેઇલ એડ્રેસ)

SCIM એન્ડપોઇન્ટ્સ સંદર્ભ

એન્ડપોઇન્ટ હેતુ
/scim/v2/Users વપરાશકર્તા પ્રોવિઝનિંગ અને મેનેજમેન્ટ
/scim/v2/Groups ભૂમિકા/ગ્રુપ સભ્યપદ મેનેજમેન્ટ
/scim/v2/ServiceProviderConfig SCIM ક્ષમતાઓ (ડિસ્કવરી)
/scim/v2/ResourceTypes સપોર્ટેડ રિસોર્સ પ્રકારો (ડિસ્કવરી)
/scim/v2/Schemas User અને Group સ્કીમાઓ (ડિસ્કવરી)

પગલું 4: ડિફોલ્ટ પ્રોડક્ટ અસાઇનમેન્ટ સેટ કરો (વૈકલ્પિક)

SCIM દ્વારા વપરાશકર્તાઓને પ્રોવિઝન કરવામાં આવે ત્યારે તમે આપમેળે તેમને પ્રોડક્ટ લાઇસન્સ અસાઇન કરી શકો છો:

  1. SCIM સેટિંગ્સ પેજ પર, Default Product Assignment શોધો
  2. એક પ્રોડક્ટ પસંદ કરો:
    • કોઈ નહીં - વપરાશકર્તાઓ પ્રોડક્ટ વિના બનાવવામાં આવે છે (પછીથી મેન્યુઅલી અસાઇન કરો)
    • દર્શક (Viewer) - ફક્ત જોવા માટેની ઍક્સેસ
    • Pro Basic - માનક એડિટિંગ સુવિધાઓ
    • Pro વ્યવસાય - સંપૂર્ણ સુવિધા ઍક્સેસ
  3. સાચવો પર ક્લિક કરો

નોંધ: સીટ્સ ઉપલબ્ધ હોય તો જ વપરાશકર્તાઓને પ્રોડક્ટ અસાઇન કરવામાં આવશે. જો કોઈ સીટ્સ ઉપલબ્ધ ન હોય, તો વપરાશકર્તા બનાવવામાં આવે છે પરંતુ અસાઇન કર્યા વિનાનો રહે છે.

પગલું 5: ટેસ્ટ કરો અને વપરાશકર્તાઓને અસાઇન કરો

  1. તમારા Identity Provider માં, SCIM કનેક્ટિવિટી ચકાસવા માટે Test Connection સુવિધાનો ઉપયોગ કરો
  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 ટેબ > ગોઠવો 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 સ્થિતિ ને 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 કામગીરીઓ

વપરાશકર્તા કામગીરીઓ

કામગીરી (ઓપરેશન) પદ્ધતિ સપોર્ટેડ વર્ણન
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 હા Admin અને Member ભૂમિકા ગ્રુપ્સ પરત કરે છે
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 ગ્રુપમાં ઉમેરો. Owner ભૂમિકા SCIM દ્વારા બદલી શકાતી નથી.

મુશ્કેલીનિવારણ

સામાન્ય સમસ્યાઓ

"401 Unauthorized" અથવા "Invalid token"

  • ચકાસો કે bearer ટોકન સાચું છે અને રદ કરવામાં આવ્યું નથી
  • ખાતરી કરો કે ટોકન Authorization હેડરમાં Bearer YOUR_TOKEN તરીકે પસાર થાય છે
  • ટોકન સમાપ્ત થઈ ગયું છે કે નહીં તે તપાસો (જો સમાપ્તિ સેટ કરી હોય)
  • જરૂર પડે તો નવું ટોકન જનરેટ કરો

"409 Conflict" - વપરાશકર્તા પહેલેથી અસ્તિત્વમાં છે

  • તમારી ટીમમાં તે ઇમેઇલ સાથેનો વપરાશકર્તા પહેલેથી અસ્તિત્વમાં છે
  • જો હાલનો વપરાશકર્તા નિષ્ક્રિય કરવામાં આવ્યો હોય, તો SCIM આપમેળે તેમને ફરીથી સક્રિય કરશે
  • તમારા IdP માં ડુપ્લિકેટ ઇમેઇલ એડ્રેસ તપાસો

"400 Bad Request" - આવશ્યક ફીલ્ડ ખૂટે છે

  • ખાતરી કરો કે રિક્વેસ્ટમાં userName (ઇમેઇલ) શામેલ છે
  • ચકાસો કે ઇમેઇલ ફોર્મેટ માન્ય છે
  • તમારા IdP ની એટ્રિબ્યુટ મેપિંગ ગોઠવણી તપાસો

વપરાશકર્તાઓ બનાવાયા પણ કોઈ પ્રોડક્ટ અસાઇન થઈ નથી

  • SCIM સેટિંગ્સમાં ડિફોલ્ટ પ્રોડક્ટ ગોઠવેલી છે કે નહીં તે તપાસો
  • ચકાસો કે ડિફોલ્ટ પ્રોડક્ટ માટે તમારી પાસે ઉપલબ્ધ સીટ્સ છે
  • Team Settings માં વપરાશકર્તાઓને મેન્યુઅલી પ્રોડક્ટ્સ અસાઇન કરી શકાય છે

વપરાશકર્તા ફેરફારો સિંક થતા નથી

  • કેટલાક IdP શેડ્યૂલ પર સિંક કરે છે (દા.ત., Azure AD માટે દર 40 મિનિટે)
  • તમારા IdP માં મેન્યુઅલ સિંક ફોર્સ કરવાનો પ્રયાસ કરો
  • ચકાસો કે SCIM હજુ સક્ષમ છે અને ટોકન માન્ય છે

ટેસ્ટ કનેક્શન નિષ્ફળ જાય છે

  • ચકાસો કે SCIM Base URL બરાબર https://api.scribblemaps.com/scim/v2 છે
  • ખાતરી કરો કે કોઈ ટ્રેલિંગ સ્લેશ અથવા ટાઇપો નથી
  • તપાસો કે તમારું નેટવર્ક/ફાયરવોલ api.scribblemaps.com પર આઉટબાઉન્ડ HTTPS ની મંજૂરી આપે છે
     

મદદ જોઈએ છે?

જો તમને SCIM પ્રોવિઝનિંગ સાથે સમસ્યાઓ આવી રહી હોય, તો કૃપા કરીને નીચેની માહિતી સાથે અમારી સપોર્ટ ટીમનો સંપર્ક કરો:

  • તમારી Team નું નામ
  • તમે જે Identity Provider વાપરી રહ્યા છો તે
  • તમારા IdP ના પ્રોવિઝનિંગ લૉગ્સમાંથી કોઈપણ ભૂલ સંદેશાઓ
  • તમારી SCIM ગોઠવણીના સ્ક્રીનશૉટ્સ (ટોકન છુપાવીને)

તમારી સંસ્થા માટે SCIM પ્રોવિઝનિંગ ગોઠવવામાં તમને મદદ કરવા માટે અમે અહીં છીએ.

છેલ્લે અપડેટ કર્યું