ตั้งค่า OIDC SSO

OIDC เป็นอีกทางเลือกหนึ่งนอกจาก SAML สำหรับการเชื่อมต่อผู้ให้บริการข้อมูลประจำตัวของคุณ ทั้งสองแบบให้ทีมของคุณลงชื่อเข้าใช้ด้วยบัญชีบริษัทที่มีอยู่ได้ โดย OIDC เป็นโปรโตคอลที่ทันสมัยกว่าซึ่งผู้ให้บริการบางรายนิยมใช้ หากคุณไม่แน่ใจว่าควรใช้แบบใด ให้ใช้ SAML — เป็นค่าเริ่มต้นและใช้งานได้กับผู้ให้บริการทุกรายที่รองรับ เลือกใช้ OIDC เมื่อผู้ให้บริการของคุณแนะนำ หรือเมื่อ SAML ไม่ใช่ตัวเลือกสำหรับคุณ

การตั้งค่ามีรูปแบบเดียวกับ SAML — กำหนดค่า ยืนยันโดเมนของคุณ ทดสอบ แล้วเปิดใช้งาน — โดยมีรายละเอียดเฉพาะบางอย่างของ OIDC

ก่อนที่คุณจะเริ่ม

  • บัญชีผู้ดูแลระบบที่มีสิทธิ์ในการจัดการการลงชื่อเข้าใช้ครั้งเดียว (SSO)
  • การเข้าถึงคอนโซลผู้ดูแลระบบของผู้ให้บริการข้อมูลประจำตัวของคุณ
  • โดเมนที่คุณสามารถยืนยันได้ (โดเมนอีเมลที่ทีมของคุณใช้ลงชื่อเข้าใช้)

เปิดตัวช่วยตั้งค่า

  1. ไปที่ User Management → Single Sign-On
  2. เลือก Set up single sign-on
  3. เลือกผู้ให้บริการของคุณ จากนั้นเปลี่ยนโปรโตคอลเป็น OIDC

แลกเปลี่ยนการตั้งค่ากับผู้ให้บริการข้อมูลประจำตัวของคุณ

  1. สร้างแอปพลิเคชัน OIDC (หรือ "OpenID Connect") ใหม่ในคอนโซลของผู้ให้บริการของคุณ Kliv จะแสดง redirect URL ให้คุณคัดลอกไปวาง

  2. ผู้ให้บริการของคุณจะให้ client ID, client secret และ issuer URL (ที่อยู่เว็บที่ระบุบริการเข้าสู่ระบบของผู้ให้บริการของคุณ) วางทั้งสามค่านี้ลงใน Kliv

  3. issuer URL ต้องตรงกับผู้ให้บริการของคุณ ทุกประการ ตรงกันทีละอักขระ นี่เป็นสิ่งที่มักผิดพลาดบ่อยที่สุด:

    • issuer ของ Microsoft Entra จะเฉพาะเจาะจงกับ tenant ของคุณและมีตัวระบุที่ยาว — คัดลอกจากแอปของคุณเอง อย่าใช้ซ้ำจากคู่มือ
    • Google เผยแพร่ issuer ของตนในมากกว่าหนึ่งรูปแบบ ให้ใช้รูปแบบที่คอนโซลของคุณแสดงพอดี

    หาก issuer URL ผิดไปแม้เพียงเล็กน้อย การลงชื่อเข้าใช้ที่ถูกต้องก็จะถูกปฏิเสธ ขั้นตอนการทดสอบด้านล่างจะบอกคุณว่านี่คือปัญหาหรือไม่

Kliv จะบันทึกสิ่งนี้เป็น ฉบับร่าง — กำหนดค่าไว้แล้วแต่ยังไม่ได้ใช้งานจริง ทีมของคุณจะยังคงลงชื่อเข้าใช้ในแบบที่ทำอยู่ในปัจจุบันจนกว่าคุณจะเสร็จสิ้น

ยืนยันโดเมนของคุณ

เช่นเดียวกับ SAML Kliv จะไม่สร้างบัญชีจากผู้ให้บริการของคุณจนกว่าคุณจะพิสูจน์ได้ว่าคุณควบคุมโดเมนอีเมลนั้น ทำตาม ยืนยันโดเมนของคุณ จากนั้นกลับมาที่นี่เมื่อสถานะแสดงเป็น ยืนยันแล้ว

ทดสอบด้วยการลงชื่อเข้าใช้จริง

  1. เลือก Test login
  2. ลงชื่อเข้าใช้ที่ผู้ให้บริการของคุณเหมือนกับที่ทีมของคุณจะทำ
  3. เมื่อสำเร็จ Kliv จะบันทึกการทดสอบและปลดล็อก เปิดใช้งาน
  4. เมื่อล้มเหลว Kliv จะแสดงรายละเอียดค่าที่คาดหวังเทียบกับค่าที่ได้รับ เพื่อให้คุณแก้ไข issuer, secret หรือ redirect ได้ — ดู แก้ไขปัญหาการเข้าสู่ระบบ SSO ที่ล้มเหลว

เปิดใช้งาน

เมื่อการทดสอบลงชื่อเข้าใช้สำเร็จแล้ว ให้เลือก เปิดใช้งาน ตอนนี้ผู้คนในโดเมนที่ยืนยันแล้วของคุณจะถูกส่งไปยังผู้ให้บริการของคุณเพื่อลงชื่อเข้าใช้ และการลงชื่อเข้าใช้ครั้งแรกจะสร้างบัญชีสมาชิกมาตรฐานโดยอัตโนมัติ

สมาชิกใหม่จะได้รับสิทธิ์การเข้าถึงระดับสมาชิกเท่านั้น — ไม่มีบทบาทที่สูงขึ้น เว้นแต่คุณจะกำหนดค่า การแมปกลุ่ม (group mapping)

หมายเหตุเกี่ยวกับตัวตนของผู้ใช้

OIDC ระบุแต่ละบุคคลด้วยคู่ค่าที่คงที่จากผู้ให้บริการของคุณ ไม่ใช่ด้วยที่อยู่อีเมล นั่นเป็นสิ่งที่ตั้งใจไว้: หมายความว่าบุคคลนั้นจะยังคงใช้บัญชี Kliv เดิม แม้ว่าอีเมลของพวกเขาจะเปลี่ยนไป และหมายความว่า Kliv ไม่ได้ขึ้นอยู่กับการที่ผู้ให้บริการของคุณทำเครื่องหมายอีเมลว่า "ยืนยันแล้ว" (ผู้ให้บริการบางรายไม่ส่งข้อมูลนั้นสำหรับบัญชีองค์กร) คุณไม่จำเป็นต้องกำหนดค่าใดๆ สำหรับสิ่งนี้ — เพียงแต่รู้ไว้ก็มีประโยชน์ว่าเหตุใดอีเมลที่เปลี่ยนไปจึงไม่สร้างบัญชีซ้ำ