SAML அல்லது OIDC உடன் ஒற்றை உள்நுழைவை (SSO) உள்ளமைத்தல்

ScribbleMaps, SAML 2.0 அல்லது OpenID Connect (OIDC) ஆகிய இரண்டில் ஏதேனும் ஒன்றைப் பயன்படுத்தி நிறுவன ஒற்றை உள்நுழைவை ஆதரிக்கிறது. இது உங்கள் குழு உறுப்பினர்கள் Okta, Microsoft Entra ID (Azure AD), Google Workspace அல்லது Auth0 போன்ற உங்கள் நிறுவனத்தின் அடையாள வழங்குநர் (IdP) மூலம் அங்கீகரிக்க அனுமதிக்கிறது.

SSO உள்ளமைவு team.scribblemaps.com இல் கிடைக்கிறது, மேலும் இது முற்றிலும் இலவசம்.

பொருளடக்கம்

1. ஆதரிக்கப்படும் அம்சங்கள்
2. தொடங்குவதற்கு முன்
3. படி 1: உங்கள் மின்னஞ்சல் டொமைனைச் சரிபார்க்கவும்
4. படி 2: உங்கள் அடையாள வழங்குநரை உள்ளமைக்கவும்
5. படி 3: ScribbleMaps இல் SSO ஐ உள்ளமைக்கவும்
6. படி 4: உங்கள் உள்ளமைவைச் சோதிக்கவும்
7. படி 5: SSO ஐ இயக்கவும்
8. SP-தொடங்கிய SSO
9. OIN Universal Logout
10. வழங்குநர்-குறிப்பிட்ட வழிகாட்டிகள்
11. மேம்பட்ட விருப்பங்கள்
12. சிக்கல் தீர்வு

ஆதரிக்கப்படும் அம்சங்கள்

ScribbleMaps SSO ஒருங்கிணைப்பு பின்வரும் அம்சங்களை ஆதரிக்கிறது:

தொடங்குவதற்கு முன்

• SSO ஐ உள்ளமைக்க நீங்கள் ஒரு குழு உரிமையாளராக இருக்க வேண்டும்
• உங்கள் நிறுவனத்தின் அடையாள வழங்குநர் நிர்வாகி கன்சோலுக்கான அணுகல் உங்களுக்குத் தேவை
• உங்கள் மின்னஞ்சல் டொமைனைத் தயாராக வைத்திருங்கள் (எ.கா., yourcompany.com)

படி 1: உங்கள் மின்னஞ்சல் டொமைனைச் சரிபார்க்கவும்

SSO ஐ உள்ளமைப்பதற்கு முன், உங்கள் மின்னஞ்சல் டொமைனின் உரிமையைச் சரிபார்க்க வேண்டும். இந்தப் பாதுகாப்பு நடவடிக்கை, அங்கீகரிக்கப்பட்ட நிறுவனங்கள் மட்டுமே தங்கள் டொமைன்களுக்கு SSO ஐ உள்ளமைக்க முடியும் என்பதை உறுதி செய்கிறது.

1. team.scribblemaps.com இல் உள்நுழைக
2. அமைப்புகள் > ஒற்றை உள்நுழைவு என்பதற்குச் செல்லவும்
3. Domains தாவலுக்குச் செல்லவும்
4. Add Domain என்பதைக் கிளிக் செய்க, பின்னர் உங்கள் மின்னஞ்சல் டொமைனை உள்ளிடவும் (எ.கா., yourcompany.com)
5. ஒரு சரிபார்ப்பு முறையைத் தேர்ந்தெடுக்கவும்:

விருப்பம் A: DNS TXT பதிவு (பரிந்துரைக்கப்படுகிறது)

உங்கள் டொமைனின் DNS அமைப்புகளில் ஒரு TXT பதிவைச் சேர்க்கவும்:

குறிப்பு: DNS மாற்றங்கள் பரவுவதற்கு 48 மணி நேரம் வரை ஆகலாம்.

விருப்பம் B: கோப்பு பதிவேற்றம்

1. scribblemaps-verify.txt என்ற பெயரில் ஒரு உரைக் கோப்பை உருவாக்கவும்
2. உங்கள் சரிபார்ப்புக் குறியீட்டை மட்டுமே உள்ளடக்கமாகச் சேர்க்கவும்
3. இங்கே பதிவேற்றவும்: https://yourcompany.com/.well-known/scribblemaps-verify.txt

சரிபார்ப்பைச் சேர்த்த பிறகு, உரிமையை உறுதிப்படுத்த Verify Domain என்பதைக் கிளிக் செய்க.

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

உங்கள் அடையாள வழங்குநரில் ScribbleMaps ஐ ஒரு பயன்பாடாகச் சேர்க்கவும். நீங்கள் Okta ஐப் பயன்படுத்தினால், Okta Integration Network (OIN) பட்டியலிலிருந்து நேரடியாக ScribbleMaps ஐச் சேர்க்கலாம் — SAML SSO URL, SP Entity ID, ACS URL மற்றும் OIDC Redirect URI ஆகியவை தானாகவே முன்கூட்டியே உள்ளமைக்கப்பட்டிருக்கும்.

SAML 2.0 க்கு

OIDC க்கு

படி 3: ScribbleMaps இல் SSO ஐ உள்ளமைக்கவும்

SAML 2.0 ஐ உள்ளமைத்தல்

1. ScribbleMaps இல், அமைப்புகள் > ஒற்றை உள்நுழைவு > SAML தாவலுக்குச் செல்லவும்
2. உங்கள் அடையாள வழங்குநரிடமிருந்து பின்வரும் தகவலை உள்ளிடவும்:

3. அமைப்புகளைச் சேமி என்பதைக் கிளிக் செய்க

OIDC ஐ உள்ளமைத்தல்

1. ScribbleMaps இல், அமைப்புகள் > ஒற்றை உள்நுழைவு > OIDC தாவலுக்குச் செல்லவும்
2. உங்கள் Provider Type ஐத் தேர்ந்தெடுக்கவும் (Google, Microsoft, Okta, Auth0 அல்லது Custom)
3. பின்வரும் தகவலை உள்ளிடவும்:

4. அமைப்புகளைச் சேமி என்பதைக் கிளிக் செய்க

படி 4: உங்கள் உள்ளமைவைச் சோதிக்கவும்

எல்லாப் பயனர்களுக்கும் SSO ஐ இயக்குவதற்கு முன், உங்கள் உள்ளமைவைச் சோதிக்கவும்:

1. Test Connection பொத்தானைக் கிளிக் செய்க
2. SSO உள்நுழைவு செயல்முறையை உருவகப்படுத்த ஒரு புதிய சாளரம் திறக்கும்
3. உங்கள் அடையாள வழங்குநருடன் அங்கீகாரத்தை முடிக்கவும்
4. நீங்கள் வெற்றிகரமாக ScribbleMaps க்குத் திருப்பி அனுப்பப்பட்டதைச் சரிபார்க்கவும்

சோதனை தோல்வியடைந்தால், பிழைச் செய்தியை மதிப்பாய்வு செய்து உங்கள் உள்ளமைவு அமைப்புகளைச் சரிபார்க்கவும்.

படி 5: SSO ஐ இயக்கவும்

சோதனை வெற்றிகரமாக முடிந்ததும்:

1. Enable SSO சுவிட்சை ON ஆக மாற்றவும்
2. உங்கள் அமலாக்க விருப்பத்தைத் தேர்ந்தெடுக்கவும்:
   • Optional: பயனர்கள் SSO அல்லது கடவுச்சொல் உள்நுழைவைத் தேர்ந்தெடுக்கலாம்
   • Enforced: சரிபார்க்கப்பட்ட மின்னஞ்சல் டொமைன்களைக் கொண்ட பயனர்கள் SSO ஐப் பயன்படுத்த வேண்டும் (கடவுச்சொல் உள்நுழைவு முடக்கப்படும்)

குறிப்பு: SSO அமல்படுத்தப்பட்டிருந்தாலும், குழு உரிமையாளர்கள் காப்புப் பிரதியாக எப்போதும் கடவுச்சொல் உள்நுழைவைப் பயன்படுத்தலாம்.

SP-தொடங்கிய SSO

ScribbleMaps, SP-தொடங்கிய SSO ஐ ஆதரிக்கிறது, இது பயனர்கள் ScribbleMaps உள்நுழைவுப் பக்கத்திலிருந்து உள்நுழைவு செயல்முறையைத் தொடங்க அனுமதிக்கிறது. இது எவ்வாறு செயல்படுகிறது என்பது இங்கே:

1. scribblemaps.com/account/login க்குச் செல்லவும்
2. உங்கள் மின்னஞ்சல் முகவரியை உள்ளிடவும் (எ.கா., [email protected])
3. Sign in with SSO என்பதைக் கிளிக் செய்க
4. அங்கீகரிக்க உங்கள் நிறுவனத்தின் அடையாள வழங்குநருக்கு (எ.கா., Okta) நீங்கள் திருப்பி அனுப்பப்படுவீர்கள்
5. வெற்றிகரமான அங்கீகாரத்திற்குப் பிறகு, நீங்கள் தானாகவே ScribbleMaps க்குத் திருப்பி அனுப்பப்பட்டு உள்நுழைந்துவிடுவீர்கள்

உங்கள் நிறுவனத்தில் SSO அமல்படுத்தப்பட்டிருந்தால், உள்நுழைவுப் பக்கத்தில் உங்கள் மின்னஞ்சலை உள்ளிடுவது தானாகவே உங்களை உங்கள் அடையாள வழங்குநருக்குத் திருப்பிவிடும் — கடவுச்சொல் புலம் காட்டப்படாது.

OIN Universal Logout

Okta வழங்கும் Universal logout ஆதரிக்கப்படுகிறது. உள்ளமைவு வழிமுறைகளுக்கு, இந்த இணைப்பை பார்வையிடவும்.

வழங்குநர்-குறிப்பிட்ட வழிகாட்டிகள்

Okta

1. Okta Admin Console இல், Applications > Browse App Catalog என்பதற்குச் செல்லவும்
2. ScribbleMaps ஐத் தேடி, Add Integration என்பதைக் கிளிக் செய்க
3. SSO URL, Entity ID மற்றும் Redirect URI ஆகியவை தானாகவே முன்கூட்டியே உள்ளமைக்கப்பட்டிருக்கும்
4. உங்கள் IdP உள்ளமைவு விவரங்களைக் காண Sign On தாவலுக்குச் செல்லவும்:
   • X.509 Certificate ஐப் பதிவிறக்கு
   • Identity Provider Issuer ஐ (Entity ID) நகலெடு
   • Single Sign-On URL ஐ நகலெடு
5. இந்த மதிப்புகளை ScribbleMaps SSO அமைப்புகளில் உள்ளிடவும் (படி 3 ஐப் பார்க்கவும்)

Microsoft Entra ID (Azure AD)

1. Azure Portal இல், Microsoft Entra ID > App registrations > New registration என்பதற்குச் செல்லவும்
2. உள்ளமைக்கவும்:
   • Redirect URI: https://api.scribblemaps.com/oidc/callback (Web தளம்)
3. Certificates & secrets என்பதற்குச் சென்று > புதிய Client secret ஐ உருவாக்கவும்
4. Application (client) ID மற்றும் Client secret value ஐ நகலெடுக்கவும்
5. Authority URL: https://login.microsoftonline.com/YOUR-TENANT-ID/v2.0

Google Workspace

1. Google Cloud Console இல், APIs & Services > Credentials என்பதற்குச் செல்லவும்
2. Create Credentials > OAuth client ID என்பதைக் கிளிக் செய்க
3. Web application ஐத் தேர்ந்தெடுக்கவும்
4. Authorized redirect URI ஐச் சேர்க்கவும்: https://api.scribblemaps.com/oidc/callback
5. Client ID மற்றும் Client Secret ஐ நகலெடுக்கவும்
6. Authority URL: https://accounts.google.com

குறிப்பு: Google Workspace க்கு MFA ஐக் கட்டாயமாக்க, அதை உங்கள் Google Workspace Admin Console இல் உள்ளமைக்கவும்.

Auth0

1. Auth0 Dashboard இல், Applications > Create Application என்பதற்குச் செல்லவும்
2. Regular Web Applications ஐத் தேர்ந்தெடுக்கவும்
3. உள்ளமைக்கவும்:
   • Allowed Callback URLs: https://api.scribblemaps.com/oidc/callback
   • Allowed Logout URLs: https://api.scribblemaps.com/oidc/logout-callback
4. Settings தாவலில் இருந்து Client ID மற்றும் Client Secret ஐ நகலெடுக்கவும்
5. Authority URL: https://YOUR-DOMAIN.auth0.com

மேம்பட்ட விருப்பங்கள்

Just-In-Time (JIT) வழங்குதல்

இயக்கப்பட்டிருக்கும்போது, முதல் SSO உள்நுழைவின்போது ScribbleMaps இல் பயனர்கள் தானாக உருவாக்கப்படுகிறார்கள். அவர்களின் சுயவிவரத் தகவல் (பெயர், மின்னஞ்சல்) அடையாள வழங்குநரிடமிருந்து நிரப்பப்படுகிறது.

பல-காரணி அங்கீகாரத்தைக் கட்டாயமாக்கு (OIDC மட்டும்)

உள்நுழைவை அனுமதிப்பதற்கு முன் MFA சரிபார்ப்பைக் கட்டாயமாக்க இந்த விருப்பத்தை இயக்கவும். பயனருக்கு உங்கள் IdP MFA ஐ அமல்படுத்தியுள்ளதா என்பதை ScribbleMaps சரிபார்க்கும்.

Okta க்கு, பின்வருபவை போன்ற தனிப்பயன் ACR மதிப்புகளை நீங்கள் குறிப்பிடலாம்:

• urn:okta:loa:2fa:any - ஏதேனும் இரண்டாம் காரணி
• phr - ஃபிஷிங்-எதிர்ப்பு அங்கீகாரம்
• phrh - ஃபிஷிங்-எதிர்ப்பு வன்பொருள்-பிணைக்கப்பட்ட அங்கீகாரம்

பண்புக்கூறு/Claim வரைபடமாக்கல்

உங்கள் IdP இலிருந்து வரும் பயனர் பண்புக்கூறுகள் ScribbleMaps பயனர் புலங்களுடன் எவ்வாறு வரைபடமாக்கப்படுகின்றன என்பதைத் தனிப்பயனாக்கவும்:

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

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

"Domain not verified"

• உங்கள் DNS TXT பதிவு அல்லது சரிபார்ப்புக் கோப்பு சரியாக உள்ளமைக்கப்பட்டுள்ளதை உறுதிசெய்யவும்
• DNS மாற்றங்கள் பரவுவதற்கு 48 மணி நேரம் வரை ஆகலாம்
• சரிபார்ப்புக் குறியீட்டில் எழுத்துப் பிழைகள் இல்லை என்பதைச் சரிபார்க்கவும்

"Invalid certificate"

• -----BEGIN CERTIFICATE----- மற்றும் -----END CERTIFICATE----- உட்பட முழுமையான சான்றிதழைப் பயன்படுத்துவதை உறுதிசெய்யவும்
• சான்றிதழ் காலாவதியாகவில்லை என்பதைச் சரிபார்க்கவும்
• குறியாக்கச் சான்றிதழை அல்ல, கையொப்பச் சான்றிதழையே நகலெடுத்தீர்கள் என்பதை உறுதிசெய்யவும்

"Invalid signature"

• சான்றிதழ் உங்கள் IdP இன் தற்போதைய கையொப்பச் சான்றிதழுடன் பொருந்துகிறதா என்பதைச் சரிபார்க்கவும்
• கையொப்ப அல்காரிதம் பொருந்துகிறதா எனச் சரிபார்க்கவும் (SHA-256 vs SHA-1)

"User not found" அல்லது "Email mismatch"

• உங்கள் IdP திருப்பியளிக்கும் மின்னஞ்சல் ஒரு சரிபார்க்கப்பட்ட டொமைனுடன் பொருந்துகிறது என்பதை உறுதிசெய்யவும்
• NameID format மின்னஞ்சல் முகவரி ஆக அமைக்கப்பட்டுள்ளதா எனச் சரிபார்க்கவும்
• பண்புக்கூறு/claim வரைபடமாக்கல் சரியாக உள்ளதா எனச் சரிபார்க்கவும்

"Security error: Your Identity Provider is not authorized for this email domain"

• IdP உள்ளமைவு சரிபார்க்கப்பட்ட டொமைனுடன் பொருந்தாதபோது இது ஏற்படுகிறது
• மின்னஞ்சல் டொமைன் உங்கள் குழுவின் கீழ் சரிபார்க்கப்பட்டுள்ளதை உறுதிசெய்யவும்
• சரிபார்க்கப்பட்ட டொமைனில் இருந்து வரும் மின்னஞ்சலுடன் உள்நுழைகிறீர்களா எனச் சரிபார்க்கவும்

தணிக்கைப் பதிவுகளைப் பார்த்தல்

அமைப்புகள் > ஒற்றை உள்நுழைவு > Audit Logs இல் SSO செயல்பாட்டைக் கண்காணிக்கவும். நீங்கள்:

• நிகழ்வு வகையின்படி வடிகட்டலாம் (Login, Logout, Failed Login)
• தேதி வரம்பின்படி வடிகட்டலாம்
• இணக்க அறிக்கையிடலுக்காக பதிவுகளை CSV ஆக ஏற்றுமதி செய்யலாம்

உதவி தேவையா?

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

• உங்கள் குழுவின் பெயர்
• நீங்கள் பயன்படுத்தும் அடையாள வழங்குநர்
• நீங்கள் காணும் ஏதேனும் பிழைச் செய்திகள்
• உங்கள் IdP உள்ளமைவின் ஸ்கிரீன்ஷாட்கள் (முக்கியமான தரவு நீக்கப்பட்டவை)

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