การตั้งค่า SSO

เชื่อมต่อ Okta, Microsoft Entra ID หรือ Google Workspace เพื่อให้ทีมของคุณลงชื่อเข้าใช้ผ่านผู้ให้บริการข้อมูลประจำตัว (identity provider) ของคุณ

การตั้งค่า SSO

คู่มือนี้สำหรับผู้ดูแลระบบ IT ที่เชื่อมต่อผู้ให้บริการข้อมูลประจำตัว (IdP) ขององค์กรกับ InterMIND หลังตั้งค่าเสร็จ สมาชิกจะเข้าสู่ระบบจากหน้าเข้าสู่ระบบตามปกติ: Sign in with SSO → อีเมลที่ใช้ทำงาน → IdP ของคุณ → กลับเข้า InterMIND สำหรับภาพรวมที่ไม่เน้นด้านเทคนิค ดูหน้าฟีเจอร์ Single Sign-On

ใช้งานได้ในแผน: Business และ Enterprise ผู้ตั้งค่า: เจ้าของทีมหรือผู้ดูแลระบบ โปรโตคอล: OpenID Connect (OIDC) เท่านั้น ไม่รองรับ SAML 2.0 — Okta, Microsoft Entra ID และ Google Workspace รองรับ OIDC ทั้งหมด

การ์ด SSO ในหน้า Integrations

ข้อกำหนดเบื้องต้น

  1. โดเมนที่ผ่านการยืนยันแล้ว — ยืนยันโดเมนอีเมลของคุณผ่านเรคคอร์ด DNS TXT ก่อน (ดูการจัดการโดเมน) การเข้าสู่ระบบด้วย SSO รับเฉพาะบัญชีที่โดเมนอีเมลผ่านการยืนยันโดยทีมของคุณแล้วเท่านั้น ซึ่งเป็นขอบเขตของ tenant
  2. IdP ที่รองรับ OIDC พร้อม discovery — ต้องให้บริการ /.well-known/openid-configuration ภายใต้ Issuer URL ซึ่ง Okta, Microsoft Entra ID และ Google รองรับทั้งหมด

สิ่งที่ต้องลงทะเบียนใน IdP ของคุณ

สร้าง OIDC Web Application ใน IdP ของคุณโดยใช้ค่าต่อไปนี้:

การตั้งค่าค่า
Redirect URI (callback)https://intermind.com/api/auth/sso/callback — แสดงในการ์ด SSO เช่นกันหลังจากคุณเลือก OIDC
Grant typeAuthorization Code (ระบบใช้ PKCE S256 โดยอัตโนมัติ)
Scopesopenid email profile

ID token ที่ IdP ของคุณออกให้ต้องมี email ของผู้ใช้ และโดเมนของอีเมลต้องเป็นหนึ่งในโดเมนที่ผ่านการยืนยันของคุณ มิฉะนั้นระบบจะปฏิเสธการเข้าสู่ระบบ

จากนั้นกรอกข้อมูลในการ์ด SSO บนหน้า Integrations:

ช่องสิ่งที่ต้องวาง
Display Nameชื่อใดก็ได้ที่สมาชิกของคุณจำได้
Issuer URLissuer ของ IdP ของคุณ — URL ที่ให้บริการ /.well-known/openid-configuration
Authorization URLค่า authorization_endpoint จากเอกสาร discovery นั้น
Client ID / Client Secretจากแอปที่คุณลงทะเบียนไว้

Client secret จะถูกเข้ารหัสขณะจัดเก็บ และจะไม่ถูกส่งกลับไปยังเบราว์เซอร์อีกหลังบันทึก

Okta

  1. Admin console → Applications → Create App Integration → sign-in method เลือก OIDC, application type เลือก Web Application
  2. Sign-in redirect URI: https://intermind.com/api/auth/sso/callback
  3. กำหนดผู้ใช้หรือกลุ่มที่ควรมีสิทธิ์เข้าถึง
  4. คัดลอก Client ID และ Client Secret
  5. ใน InterMIND: Issuer URL = URL องค์กร Okta ของคุณ (เช่น https://acme.okta.com หรือ issuer ของ authorization server ของคุณ เช่น https://acme.okta.com/oauth2/default หากคุณใช้) ส่วน Authorization URL = authorization_endpoint จาก <issuer>/.well-known/openid-configuration

Microsoft Entra ID (Azure AD)

  1. Entra admin center → App registrations → New registration
  2. Platform เลือก Web, redirect URI คือ https://intermind.com/api/auth/sso/callback
  3. Certificates & secrets → New client secret — คัดลอก Value ของ secret ทันที
  4. Client ID = Application (client) ID ในหน้า Overview
  5. ตรวจสอบให้แน่ใจว่า ID token มีอีเมลของผู้ใช้: Token configuration → Add optional claim → ID → email
  6. ใน InterMIND: Issuer URL = https://login.microsoftonline.com/<tenant-id>/v2.0; Authorization URL = https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/authorize

Google Workspace

ไม่ต้องลงทะเบียนแอป ในการ์ด SSO ให้เลือกผู้ให้บริการประเภท Google Workspace แล้วบันทึก สมาชิกในโดเมนที่ผ่านการยืนยันของคุณจะเข้าสู่ระบบด้วยบัญชี Google และเข้าร่วมทีมของคุณโดยอัตโนมัติ (นอกจากนี้ยังเชื่อมต่อ Google เป็นผู้ให้บริการ OIDC ทั่วไปได้ โดยใช้ issuer https://accounts.google.com หากคุณต้องการระบุ client credentials เอง)

ทดสอบการเชื่อมต่อ

  1. เปิดหน้าเข้าสู่ระบบในหน้าต่างส่วนตัว/incognito
  2. คลิก Sign in with SSO แล้วกรอกอีเมลที่ใช้ทำงานในโดเมนที่ผ่านการยืนยันของคุณ
  3. ระบบจะเปลี่ยนเส้นทางไปยัง IdP ของคุณ หลังยืนยันตัวตนเสร็จ คุณจะกลับมายัง InterMIND พร้อมเข้าสู่ระบบแล้ว
  4. การเข้าสู่ระบบจะถูกบันทึกในบันทึกการตรวจสอบของทีม (ส่งออกได้จากหน้า Users) เป็น auth.login ด้วยวิธี sso

การแก้ไขปัญหา

อาการสาเหตุ
"SSO is not configured" หลังกรอกอีเมลไม่มีการตั้งค่า SSO ที่เปิดใช้งานซึ่งตรงกับโดเมนอีเมลนั้น — ตรวจสอบว่าโดเมนผ่านการยืนยันแล้วและบันทึกการ์ด SSO แล้ว
SSO login is not available: planแผนของทีมไม่รวม SSO อีกต่อไป
SSO login is not available: domain-not-verifiedโดเมนยังรอการยืนยัน DNS
SSO login is not available: config-incompleteไม่มี Client ID หรือ Client Secret — บันทึกการ์ด SSO ใหม่อีกครั้ง
SSO login is not available: type-unsupportedประเภทผู้ให้บริการที่จัดเก็บไว้ไม่ใช่ประเภทที่ขั้นตอนการเข้าสู่ระบบรองรับ — ลบการตั้งค่า SSO แล้วสร้างใหม่เป็น OIDC หรือ Google Workspace
SSO IdP discovery failedIssuer URL ไม่ถูกต้อง หรือไม่ได้ให้บริการ /.well-known/openid-configuration
"login session expired, start again"เวลาผ่านไปเกิน 5 นาทีระหว่างการเริ่มเข้าสู่ระบบกับ callback จาก IdP
ถูกปฏิเสธการเข้าสู่ระบบหลังจาก IdP เปลี่ยนเส้นทางกลับมาIdP ส่งอีเมลที่อยู่นอกโดเมนที่ผ่านการยืนยันของคุณกลับมา หรือไม่มี email claim เลย (Entra: เพิ่ม optional claim สำหรับอีเมล)

คุณสมบัติด้านความปลอดภัย

สำหรับแบบสอบถามด้านความปลอดภัย: ขั้นตอน SSO ใช้ Authorization Code พร้อม PKCE (S256), state และ nonce; ลายเซ็นของ ID token ได้รับการตรวจสอบกับ JWKS ของ IdP รวมถึง issuer และ audience; IdP มีอำนาจกำหนดเฉพาะโดเมนที่ยืนยันผ่าน DNS เท่านั้น — assertion สำหรับอีเมลอื่นใดจะไม่สร้างเซสชันเด็ดขาด; client secret ของ OIDC ถูกเข้ารหัสขณะจัดเก็บ; การเข้าสู่ระบบด้วย SSO ทุกครั้งจะถูกบันทึกในบันทึกการตรวจสอบ (audit log) ของทีม ระบบบังคับใช้เงื่อนไขด้านแผน โดเมน และการตั้งค่าที่ฝั่งเซิร์ฟเวอร์ทั้งตอนเริ่มเข้าสู่ระบบและตอน callback