ตั้งค่า OIDC SSO
OIDC เป็นอีกทางเลือกหนึ่งนอกจาก SAML สำหรับการเชื่อมต่อผู้ให้บริการข้อมูลประจำตัวของคุณ ทั้งสองแบบให้ทีมของคุณลงชื่อเข้าใช้ด้วยบัญชีบริษัทที่มีอยู่ได้ โดย OIDC เป็นโปรโตคอลที่ทันสมัยกว่าซึ่งผู้ให้บริการบางรายนิยมใช้ หากคุณไม่แน่ใจว่าควรใช้แบบใด ให้ใช้ SAML — เป็นค่าเริ่มต้นและใช้งานได้กับผู้ให้บริการทุกรายที่รองรับ เลือกใช้ OIDC เมื่อผู้ให้บริการของคุณแนะนำ หรือเมื่อ SAML ไม่ใช่ตัวเลือกสำหรับคุณ
การตั้งค่ามีรูปแบบเดียวกับ SAML — กำหนดค่า ยืนยันโดเมนของคุณ ทดสอบ แล้วเปิดใช้งาน — โดยมีรายละเอียดเฉพาะบางอย่างของ OIDC
ก่อนที่คุณจะเริ่ม
- บัญชีผู้ดูแลระบบที่มีสิทธิ์ในการจัดการการลงชื่อเข้าใช้ครั้งเดียว (SSO)
- การเข้าถึงคอนโซลผู้ดูแลระบบของผู้ให้บริการข้อมูลประจำตัวของคุณ
- โดเมนที่คุณสามารถยืนยันได้ (โดเมนอีเมลที่ทีมของคุณใช้ลงชื่อเข้าใช้)
เปิดตัวช่วยตั้งค่า
- ไปที่ User Management → Single Sign-On
- เลือก Set up single sign-on
- เลือกผู้ให้บริการของคุณ จากนั้นเปลี่ยนโปรโตคอลเป็น OIDC
แลกเปลี่ยนการตั้งค่ากับผู้ให้บริการข้อมูลประจำตัวของคุณ
-
สร้างแอปพลิเคชัน OIDC (หรือ "OpenID Connect") ใหม่ในคอนโซลของผู้ให้บริการของคุณ Kliv จะแสดง redirect URL ให้คุณคัดลอกไปวาง
-
ผู้ให้บริการของคุณจะให้ client ID, client secret และ issuer URL (ที่อยู่เว็บที่ระบุบริการเข้าสู่ระบบของผู้ให้บริการของคุณ) วางทั้งสามค่านี้ลงใน Kliv
-
issuer URL ต้องตรงกับผู้ให้บริการของคุณ ทุกประการ ตรงกันทีละอักขระ นี่เป็นสิ่งที่มักผิดพลาดบ่อยที่สุด:
- issuer ของ Microsoft Entra จะเฉพาะเจาะจงกับ tenant ของคุณและมีตัวระบุที่ยาว — คัดลอกจากแอปของคุณเอง อย่าใช้ซ้ำจากคู่มือ
- Google เผยแพร่ issuer ของตนในมากกว่าหนึ่งรูปแบบ ให้ใช้รูปแบบที่คอนโซลของคุณแสดงพอดี
หาก issuer URL ผิดไปแม้เพียงเล็กน้อย การลงชื่อเข้าใช้ที่ถูกต้องก็จะถูกปฏิเสธ ขั้นตอนการทดสอบด้านล่างจะบอกคุณว่านี่คือปัญหาหรือไม่
Kliv จะบันทึกสิ่งนี้เป็น ฉบับร่าง — กำหนดค่าไว้แล้วแต่ยังไม่ได้ใช้งานจริง ทีมของคุณจะยังคงลงชื่อเข้าใช้ในแบบที่ทำอยู่ในปัจจุบันจนกว่าคุณจะเสร็จสิ้น
ยืนยันโดเมนของคุณ
เช่นเดียวกับ SAML Kliv จะไม่สร้างบัญชีจากผู้ให้บริการของคุณจนกว่าคุณจะพิสูจน์ได้ว่าคุณควบคุมโดเมนอีเมลนั้น ทำตาม ยืนยันโดเมนของคุณ จากนั้นกลับมาที่นี่เมื่อสถานะแสดงเป็น ยืนยันแล้ว
ทดสอบด้วยการลงชื่อเข้าใช้จริง
- เลือก Test login
- ลงชื่อเข้าใช้ที่ผู้ให้บริการของคุณเหมือนกับที่ทีมของคุณจะทำ
- เมื่อสำเร็จ Kliv จะบันทึกการทดสอบและปลดล็อก เปิดใช้งาน
- เมื่อล้มเหลว Kliv จะแสดงรายละเอียดค่าที่คาดหวังเทียบกับค่าที่ได้รับ เพื่อให้คุณแก้ไข issuer, secret หรือ redirect ได้ — ดู แก้ไขปัญหาการเข้าสู่ระบบ SSO ที่ล้มเหลว
เปิดใช้งาน
เมื่อการทดสอบลงชื่อเข้าใช้สำเร็จแล้ว ให้เลือก เปิดใช้งาน ตอนนี้ผู้คนในโดเมนที่ยืนยันแล้วของคุณจะถูกส่งไปยังผู้ให้บริการของคุณเพื่อลงชื่อเข้าใช้ และการลงชื่อเข้าใช้ครั้งแรกจะสร้างบัญชีสมาชิกมาตรฐานโดยอัตโนมัติ
สมาชิกใหม่จะได้รับสิทธิ์การเข้าถึงระดับสมาชิกเท่านั้น — ไม่มีบทบาทที่สูงขึ้น เว้นแต่คุณจะกำหนดค่า การแมปกลุ่ม (group mapping)
หมายเหตุเกี่ยวกับตัวตนของผู้ใช้
OIDC ระบุแต่ละบุคคลด้วยคู่ค่าที่คงที่จากผู้ให้บริการของคุณ ไม่ใช่ด้วยที่อยู่อีเมล นั่นเป็นสิ่งที่ตั้งใจไว้: หมายความว่าบุคคลนั้นจะยังคงใช้บัญชี Kliv เดิม แม้ว่าอีเมลของพวกเขาจะเปลี่ยนไป และหมายความว่า Kliv ไม่ได้ขึ้นอยู่กับการที่ผู้ให้บริการของคุณทำเครื่องหมายอีเมลว่า "ยืนยันแล้ว" (ผู้ให้บริการบางรายไม่ส่งข้อมูลนั้นสำหรับบัญชีองค์กร) คุณไม่จำเป็นต้องกำหนดค่าใดๆ สำหรับสิ่งนี้ — เพียงแต่รู้ไว้ก็มีประโยชน์ว่าเหตุใดอีเมลที่เปลี่ยนไปจึงไม่สร้างบัญชีซ้ำ