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: 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: ScribbleMaps இல் SCIM ஐ இயக்கவும்

1. team.scribblemaps.com இல் உள்நுழையவும்
2. SCIM Provisioning (இடது பக்கப்பட்டி) க்குச் செல்லவும்
3. Enable SCIM ஐ ON ஆக மாற்றவும்

குறிப்பு: SCIM முழுமையாக இயக்கப்படுவதற்கு முன்பு நீங்கள் ஒரு bearer token ஐ உருவாக்க வேண்டும்.

படி 2: Bearer Token ஐ உருவாக்கு

Bearer token உங்கள் அடையாள வழங்குநரை ScribbleMaps உடன் அங்கீகரிக்கிறது.

1. SCIM அமைப்புகள் பக்கத்தில், உருவாக்கு Token ஐ கிளிக் செய்க
2. Token ஐ உடனடியாக நகலெடுத்து பாதுகாப்பாக சேமிக்கவும்

முக்கியமான பாதுகாப்பு குறிப்புகள்:

• Token ஒருமுறை மட்டுமே காட்டப்படும் - அதை இழந்தால், புதிய ஒன்றை உருவாக்க வேண்டும்
• இந்த token ஐ கடவுச்சொல் போல் கருதுங்கள் - token உள்ள எவரும் உங்கள் குழுவின் பயனர்களை நிர்வகிக்க முடியும்
• அது சமரசம் செய்யப்பட்டால் எந்த நேரத்திலும் token ஐ ரத்துசெய்து மீண்டும் உருவாக்கலாம்
• Token ஐ ரத்துசெய்தால், புதிய token உள்ளமைக்கப்படும் வரை அனைத்து SCIM செயல்பாடுகளும் உடனடியாக நிறுத்தப்படும்

படி 3: உங்கள் அடையாள வழங்குநரை உள்ளமைக்கவும்

உங்கள் IdP இல் ScribbleMaps ஐ SCIM பயன்பாடாக உள்ளமைக்க பின்வரும் விவரங்களைப் பயன்படுத்தவும்:

SCIM Endpoints குறிப்பு

படி 4: இயல்புநிலை தயாரிப்பு ஒதுக்கீட்டை அமை (விருப்பத்தேர்வு)

SCIM வழியாக பயனர்கள் வழங்கப்படும்போது அவர்களுக்கு ஒரு தயாரிப்பு உரிமத்தை தானாக ஒதுக்கலாம்:

1. SCIM அமைப்புகள் பக்கத்தில், இயல்புநிலை தயாரிப்பு ஒதுக்கீடு ஐக் கண்டறியவும்
2. ஒரு தயாரிப்பைத் தேர்ந்தெடு:
   • ஏதுமில்லை - பயனர்கள் தயாரிப்பு இல்லாமல் உருவாக்கப்படுவார்கள் (பின்னர் கைமுறையாக ஒதுக்கவும்)
   • பார்வையாளர் - பார்வை மட்டும் அணுகல்
   • Pro Basic - நிலையானது திருத்தும் அம்சங்கள்
   • Pro Business - முழு அம்ச அணுகல்
3. சேமி ஐ கிளிக் செய்க

குறிப்பு: இருக்கைகள் கிடைக்கும்போது மட்டுமே பயனர்களுக்கு தயாரிப்பு ஒதுக்கப்படும். இருக்கைகள் எதுவும் கிடைக்கவில்லை என்றால், பயனர் உருவாக்கப்படுவார் ஆனால் ஒதுக்கப்படாமல் விடப்படுவார்.

படி 5: சோதித்து பயனர்களை ஒதுக்கவும்

1. உங்கள் அடையாள வழங்குநரில், 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 தாவல் > Configure API Integration க்குச் செல்லவும்
4. Enable API integration ஐத் தேர்வுசெய்யவும்
5. உள்ளமைக்கவும்:
   • SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
   • OAuth Bearer Token: உங்கள் ScribbleMaps SCIM token ஐ ஒட்டு
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. நிர்வாகி Credentials இன் கீழ்:
   • Tenant URL: https://api.scribblemaps.com/scim/v2
   • Secret Token: உங்கள் ScribbleMaps SCIM token ஐ ஒட்டு
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 token ஐ ஒட்டு
5. Provisioning தாவலுக்குச் சென்று provisioning ஐ இயக்கவும்
6. பயனர்களை ஒதுக்க பயனர்கள் தாவலுக்குச் செல்லவும்

JumpCloud

1. JumpCloud Admin இல், SSO Applications க்குச் செல்லவும்
2. புதிய பயன்பாட்டைச் சேர்க்க + ஐ கிளிக் செய்க
3. Custom SCIM ஐத் தேர்ந்தெடு
4. உள்ளமைக்கவும்:
   • Base URL: https://api.scribblemaps.com/scim/v2
   • Token Key: உங்கள் ScribbleMaps SCIM token ஐ ஒட்டு
   • அங்கீகாரம்: Bearer Token
5. Test Connection ஐ கிளிக் செய்க
6. பண்புக்கூறு mappings ஐ உள்ளமைக்கவும்
7. பயன்பாட்டிற்கு பயனர் குழுக்களை ஒதுக்கவும்

ஆதரிக்கப்படும் SCIM செயல்பாடுகள்

பயனர் செயல்பாடுகள்

குழு செயல்பாடுகள்

ஆதரிக்கப்படும் பயனர் பண்புக்கூறுகள்

ஆதரிக்கப்படும் வடிகட்டிகள்

பயனர் வாழ்க்கைச் சுழற்சி மேலாண்மை

ஒரு பயனர் வழங்கப்படும்போது

1. ScribbleMaps இல் புதிய குழு உறுப்பினர் கணக்கு உருவாக்கப்படுகிறது
2. பயனர் தகவல் (பெயர், மின்னஞ்சல்) உங்கள் IdP இலிருந்து நிரப்பப்படுகிறது
3. இயல்புநிலை தயாரிப்பு உள்ளமைக்கப்பட்டு இருக்கைகள் கிடைத்தால், உரிமம் தானாக ஒதுக்கப்படுகிறது
4. பயனர் உடனடியாக SSO வழியாக உள்நுழையலாம் (உள்ளமைக்கப்பட்டிருந்தால்)

ஒரு பயனர் புதுப்பிக்கப்படும்போது

1. பயனர் பண்புக்கூறுகள் (பெயர், காட்சிப் பெயர்) உங்கள் IdP உடன் பொருந்தும்படி புதுப்பிக்கப்படுகின்றன
2. மின்னஞ்சல் மாற்றங்கள் ஒத்திசைக்கப்படுகின்றன (பயனர் தனது கணக்கை இணைத்திருந்தால் தவிர)

ஒரு பயனரின் வழங்கல் நீக்கப்படும்போது

1. பயனரின் கணக்கு செயலிழக்கச் செய்யப்படுகிறது (மென்மையான நீக்கம்)
2. அனைத்து தயாரிப்பு உரிமங்களும் அகற்றப்பட்டு, இருக்கைகள் விடுவிக்கப்படுகின்றன
3. அனைத்து செயலில் உள்ள அமர்வுகளும் உடனடியாக செல்லாததாக்கப்படுகின்றன
4. பயனரால் இனி உள்நுழைய முடியாது
5. பயனர் தரவு மற்றும் வரைபடங்கள் பாதுகாக்கப்படுகின்றன (நீக்கப்படுவதில்லை)
6. பயனர் மீண்டும் வழங்கப்பட்டால் கணக்கு மீண்டும் செயல்படுத்தப்படலாம்

குழுக்கள் வழியாக பங்கு மேலாண்மை

ScribbleMaps SCIM வழியாக இரண்டு பங்கு குழுக்களை வெளிப்படுத்துகிறது:

ஒரு பயனரை நிர்வாகியாக ஒதுக்க, SCIM PATCH வழியாக அவர்களை admin குழுவில் சேர்க்கவும். உரிமையாளர் பங்கை SCIM வழியாக மாற்ற முடியாது.

சிக்கல் தீர்வு

பொதுவான சிக்கல்கள்

"401 Unauthorized" அல்லது "Invalid token"

• Bearer token சரியானது மற்றும் ரத்து செய்யப்படவில்லை என்பதைச் சரிபார்க்கவும்
• Token ஆனது Authorization தலைப்புப் பகுதியில் Bearer YOUR_TOKEN ஆக அனுப்பப்படுவதை உறுதிசெய்யவும்
• Token காலாவதியாகிவிட்டதா எனச் சரிபார்க்கவும் (காலாவதி அமைக்கப்பட்டிருந்தால்)
• தேவைப்பட்டால் புதிய token ஐ உருவாக்கவும்

"409 Conflict" - பயனர் ஏற்கனவே உள்ளார்

• அந்த மின்னஞ்சலுடன் ஒரு பயனர் ஏற்கனவே உங்கள் குழுவில் உள்ளார்
• ஏற்கனவே உள்ள பயனர் செயலிழக்கச் செய்யப்பட்டிருந்தால், SCIM அவர்களை தானாக மீண்டும் செயல்படுத்தும்
• உங்கள் IdP இல் நகல் மின்னஞ்சல் முகவரிகள் உள்ளனவா எனச் சரிபார்க்கவும்

"400 Bad Request" - தேவையான புலம் இல்லை

• கோரிக்கையில் userName (மின்னஞ்சல்) சேர்க்கப்பட்டுள்ளதை உறுதிசெய்யவும்
• மின்னஞ்சல் வடிவம் சரியானது என்பதைச் சரிபார்க்கவும்
• உங்கள் IdP இன் பண்புக்கூறு mapping உள்ளமைவைச் சரிபார்க்கவும்

பயனர்கள் உருவாக்கப்பட்டனர் ஆனால் தயாரிப்பு ஒதுக்கப்படவில்லை

• SCIM அமைப்புகளில் இயல்புநிலை தயாரிப்பு உள்ளமைக்கப்பட்டுள்ளதா எனச் சரிபார்க்கவும்
• இயல்புநிலை தயாரிப்புக்கு உங்களிடம் கிடைக்கும் இருக்கைகள் உள்ளன என்பதைச் சரிபார்க்கவும்
• குழு அமைப்புகளில் பயனர்களுக்கு தயாரிப்புகளை கைமுறையாக ஒதுக்கலாம்

பயனர் மாற்றங்கள் ஒத்திசைக்கப்படவில்லை

• சில IdP கள் அட்டவணைப்படி ஒத்திசைக்கின்றன (எ.கா., Azure AD க்கு ஒவ்வொரு 40 நிமிடங்களுக்கும்)
• உங்கள் IdP இல் கைமுறை ஒத்திசைவைத் தூண்ட முயற்சிக்கவும்
• SCIM இன்னும் இயக்கப்பட்டுள்ளது மற்றும் token செல்லுபடியாகும் என்பதைச் சரிபார்க்கவும்

Test connection தோல்வியடைகிறது

• SCIM Base URL சரியாக https://api.scribblemaps.com/scim/v2 என்பதைச் சரிபார்க்கவும்
• பின்னால் சாய்வுக்கோடுகள் அல்லது எழுத்துப்பிழைகள் இல்லை என்பதை உறுதிசெய்யவும்
• உங்கள் நெட்வொர்க்/ஃபயர்வால் api.scribblemaps.com க்கு வெளிச்செல்லும் HTTPS ஐ அனுமதிக்கிறதா எனச் சரிபார்க்கவும்
   

உதவி தேவையா?

SCIM வழங்கலில் உங்களுக்கு சிக்கல்கள் இருந்தால், பின்வருவனவற்றுடன் எங்கள் ஆதரவுக் குழுவைத் தொடர்புகொள்ளவும்:

• உங்கள் குழு பெயர்
• நீங்கள் பயன்படுத்தும் அடையாள வழங்குநர்
• உங்கள் IdP இன் provisioning பதிவுகளிலிருந்து ஏதேனும் பிழைச் செய்திகள்
• உங்கள் SCIM உள்ளமைவின் திரைப்பிடிப்புகள் (token மறைக்கப்பட்டு)

உங்கள் நிறுவனத்திற்கு SCIM வழங்கலை உள்ளமைக்க உங்களுக்கு உதவ நாங்கள் இங்கே இருக்கிறோம்.