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 నుండి వినియోగదారులను తొలగించినప్పుడు ఖాతాలను ఆటోమేటిక్‌గా డీయాక్టివేట్ చేయండి
• పాత్రలను (Roles) నిర్వహించండి - గ్రూప్ సభ్యత్వం ద్వారా వినియోగదారులను అడ్మిన్ లేదా సభ్యుల పాత్రలకు అసైన్ చేయండి

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 ఎండ్‌పాయింట్‌ల రిఫరెన్స్

స్టెప్ 4: డిఫాల్ట్ ప్రొడక్ట్ అసైన్‌మెంట్‌ను సెట్ చేయండి (ఐచ్ఛికం)

SCIM ద్వారా వినియోగదారులను ప్రొవిజన్ చేసినప్పుడు వారికి ఆటోమేటిక్‌గా ప్రొడక్ట్ లైసెన్స్‌ను అసైన్ చేయవచ్చు:

1. SCIM సెట్టింగ్‌ల పేజీలో, డిఫాల్ట్ ప్రొడక్ట్ అసైన్‌మెంట్ను కనుగొనండి
2. ఒక ప్రొడక్ట్‌ను ఎంచుకోండి:
   • ఏదీ లేదు - వినియోగదారులు ప్రొడక్ట్ లేకుండా సృష్టించబడతారు (తర్వాత మాన్యువల్‌గా అసైన్ చేయండి)
   • వ్యూయర్ - వీక్షణ-మాత్రమే యాక్సెస్
   • Pro Basic - ప్రామాణికం ఎడిటింగ్ ఫీచర్‌లు
   • Pro Business - పూర్తి ఫీచర్ యాక్సెస్
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 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 అడ్మిన్‌లో, 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 అడ్మిన్‌లో, 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 ఆపరేషన్‌లు

యూజర్ ఆపరేషన్‌లు

గ్రూప్ ఆపరేషన్‌లు

మద్దతు ఉన్న యూజర్ ఆట్రిబ్యూట్‌లు

మద్దతు ఉన్న ఫిల్టర్‌లు

యూజర్ లైఫ్‌సైకిల్ నిర్వహణ

వినియోగదారును ప్రొవిజన్ చేసినప్పుడు

1. ScribbleMapsలో కొత్త బృందం సభ్యుని ఖాతా సృష్టించబడుతుంది
2. వినియోగదారు సమాచారం (పేరు, ఇమెయిల్) మీ IdP నుండి నింపబడుతుంది
3. డిఫాల్ట్ ప్రొడక్ట్ కాన్ఫిగర్ చేయబడి, సీట్లు అందుబాటులో ఉంటే, లైసెన్స్ ఆటోమేటిక్‌గా అసైన్ చేయబడుతుంది
4. వినియోగదారు వెంటనే SSO ద్వారా లాగిన్ అవ్వగలరు (కాన్ఫిగర్ చేయబడి ఉంటే)

వినియోగదారును అప్‌డేట్ చేసినప్పుడు

1. యూజర్ ఆట్రిబ్యూట్‌లు (పేరు, ప్రదర్శన పేరు) మీ IdPకి సరిపోయేలా అప్‌డేట్ చేయబడతాయి
2. ఇమెయిల్ మార్పులు సింక్ చేయబడతాయి (వినియోగదారు తమ ఖాతాను లింక్ చేసి ఉంటే తప్ప)

వినియోగదారును డీప్రొవిజన్ చేసినప్పుడు

1. వినియోగదారు ఖాతా డీయాక్టివేట్ చేయబడుతుంది (సాఫ్ట్ డిలీట్)
2. అన్ని ప్రొడక్ట్ లైసెన్స్‌లు తొలగించబడతాయి, సీట్లు ఖాళీ అవుతాయి
3. అన్ని యాక్టివ్ సెషన్‌లు వెంటనే చెల్లకుండా చేయబడతాయి
4. వినియోగదారు ఇకపై లాగిన్ అవ్వలేరు
5. వినియోగదారు డేటా మరియు మ్యాప్‌లు భద్రపరచబడతాయి (తొలగించబడవు)
6. వినియోగదారును మళ్లీ ప్రొవిజన్ చేస్తే ఖాతాను తిరిగి యాక్టివేట్ చేయవచ్చు

గ్రూప్‌ల ద్వారా పాత్ర (Role) నిర్వహణ

ScribbleMaps SCIM ద్వారా రెండు పాత్ర (Role) గ్రూప్‌లను అందుబాటులో ఉంచుతుంది:

ఒక వినియోగదారును అడ్మిన్‌గా అసైన్ చేయడానికి, SCIM PATCH ద్వారా వారిని admin గ్రూప్‌కు జోడించండి. ఓనర్ పాత్ర (Role)ను 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 ఇంకా ఎనేబుల్ చేయబడి ఉందని మరియు టోకెన్ చెల్లుబాటులో ఉందని ధృవీకరించండి

Test connection విఫలమవుతోంది

• SCIM బేస్ URL సరిగ్గా https://api.scribblemaps.com/scim/v2 అని ధృవీకరించండి
• ట్రైలింగ్ స్లాష్‌లు లేదా అక్షర దోషాలు లేవని నిర్ధారించుకోండి
• మీ నెట్‌వర్క్/ఫైర్‌వాల్ api.scribblemaps.comకు అవుట్‌బౌండ్ HTTPSను అనుమతిస్తున్నాయో లేదో తనిఖీ చేయండి
   

సహాయం కావాలా?

SCIM ప్రొవిజనింగ్‌తో మీకు సమస్యలు ఎదురైతే, దయచేసి కింది వాటితో మా సపోర్ట్ బృందాన్ని సంప్రదించండి:

• మీ బృందం పేరు
• మీరు ఉపయోగిస్తున్న ఐడెంటిటీ ప్రొవైడర్
• మీ IdP ప్రొవిజనింగ్ లాగ్‌ల నుండి ఏవైనా ఎర్రర్ సందేశాలు
• మీ SCIM కాన్ఫిగరేషన్ స్క్రీన్‌షాట్‌లు (టోకెన్ దాచబడి)

మీ సంస్థ కోసం SCIM ప్రొవిజనింగ్‌ను కాన్ఫిగర్ చేయడంలో మీకు సహాయపడటానికి మేము ఇక్కడ ఉన్నాము.