แมปข้อมูลประจำตัวของผู้ใช้ใน Cloud Search

Google Cloud Search ต้องแมปข้อมูลประจำตัวระหว่างที่เก็บและบัญชี Google เพื่อให้เป็นไปตามสิทธิ์การเข้าถึงของรายการจากที่เก็บของบุคคลที่สาม เช่น ในฐานข้อมูล ผู้ใช้อาจมีชื่อผู้ใช้เป็น jensmith@your-company.com ชื่อผู้ใช้ดังกล่าวต้องแมปกับบัญชี Google เช่น jsmith@solarmora.com

หากต้องการจัดการการแมปนี้ ให้สร้างแหล่งที่มาของข้อมูลประจำตัวใน Cloud Search แหล่งที่มาของข้อมูลประจำตัวจะช่วยให้นักพัฒนาซอฟต์แวร์แมปบัญชีผู้ใช้จากที่เก็บของบุคคลที่สามกับบัญชี Google ได้ ดูวิธีซิงค์ระบบข้อมูลประจำตัวที่แตกต่างกันของนักพัฒนาซอฟต์แวร์

ข้อควรทราบก่อนที่จะเริ่มต้น

• สอบถามนักพัฒนาซอฟต์แวร์เกี่ยวกับรหัสบัญชีบริการที่มีสิทธิ์เข้าถึง Google Workspace Admin SDK และ Cloud Identity API
• เพิ่มแหล่งข้อมูลสำหรับค้นหา คุณต้องเพิ่มแหล่งข้อมูลอย่างน้อย 1 รายการก่อนจึงจะสร้างแหล่งที่มาของข้อมูลประจำตัวได้

1. สร้างแหล่งที่มาของข้อมูลประจำตัว

โปรดสร้างแหล่งที่มาของข้อมูลประจำตัว หากต้องการจับคู่ชื่อผู้ใช้บุคคลที่สามกับบัญชี Google

1. ในคอนโซลผู้ดูแลระบบของ Google ให้ไปที่เมนู แอป Google Workspace Cloud Search

   ไปที่ Cloud Search

   ต้องมีสิทธิ์ของผู้ดูแลระบบ Cloud Search

2. คลิกการ์ดแหล่งที่มาของข้อมูลระบุตัวตน

   รายการแหล่งที่มาของข้อมูลประจำตัวขององค์กรจะปรากฏขึ้น

3. คลิกเพิ่ม ที่ด้านซ้ายบน

4. ป้อนชื่อในบรรทัดข้อความชื่อแหล่งที่มาของข้อมูลประจำตัว

5. คลิกเพิ่มบัญชีบริการ

6. ป้อนอีเมลของบัญชีบริการที่เข้าถึงข้อมูลผู้ใช้และกลุ่มผ่าน Admin SDK Users API และ Cloud Identity API ได้

   ใช้อีเมลที่สร้างขึ้นสำหรับรหัสบัญชีบริการโดยเฉพาะเมื่อมีการสร้างรหัสบัญชีบริการ

7. ตั้งค่าระดับการเข้าถึงของบัญชีบริการเป็น Admin SDK Users API โดยทำดังนี้

   • อ่านและเขียน - ให้สิทธิ์เข้าถึง API เต็มรูปแบบ

   • ที่มีอยู่ - รักษาสิทธิ์เข้าถึง API ที่มอบไว้ให้แล้ว

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

     หมายเหตุ: หากแหล่งข้อมูลประจำตัวที่ให้สิทธิ์อ่านและเขียนแก่บัญชีบริการถูกลบ บัญชีบริการจะเสียสิทธิ์เข้าถึง หากแหล่งข้อมูลประจำตัวนี้ต้องใช้บัญชีบริการนี้ ให้ตั้งค่าตัวเลือกเป็นอ่านและเขียน

8. กำหนดระดับการเข้าถึง Cloud Identity API ของบัญชีบริการโดยทำดังนี้

   • อ่านและเขียน - ให้สิทธิ์เข้าถึง API เต็มรูปแบบ
   • อ่าน - ให้สิทธิ์อ่าน API
   • ไม่มีสิทธิ์เข้าถึง - ไม่ให้เข้าถึง API

9. คลิกเพิ่มบัญชีบริการ

10. เพิ่มบัญชีบริการอื่น หรือหากเพิ่มบัญชีบริการเสร็จแล้ว ให้คลิกเพิ่มแหล่งข้อมูลประจำตัว

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

11. คลิกตกลง

หลังจากเพิ่มแหล่งข้อมูลระบุตัวตนแล้ว คุณจะดูแหล่งข้อมูลดังกล่าวได้ในรายการแหล่งข้อมูลระบุตัวตน นักพัฒนาซอฟต์แวร์ต้องใช้รหัสแหล่งที่มาของข้อมูลประจำตัวสำหรับ Google APIs เพื่อเข้าถึงข้อมูลผู้ใช้และกลุ่ม หากต้องการคัดลอกรหัสแหล่งข้อมูลระบุตัวตนไปยังคลิปบอร์ด ให้คลิกคัดลอก

การแก้ปัญหาข้อผิดพลาดของ API แหล่งข้อมูลระบุตัวตน

• HTTP 403 (ปฏิเสธสิทธิ์)- ตรวจสอบว่าบัญชีบริการมีสิทธิ์อ่านและเขียนที่ชัดเจนสำหรับทั้ง Admin SDK API และ Cloud Identity API หากแหล่งข้อมูลระบุตัวตนที่ให้สิทธิ์เข้าถึงในตอนแรกถูกลบ บัญชีบริการจะเสียสิทธิ์เข้าถึงทันที
• HTTP 404 (ไม่พบ)- ยืนยันว่าคำนำหน้า identitysources/ID ตรงกับแหล่งข้อมูลระบุตัวตนที่ใช้งานอยู่ในคอนโซลผู้ดูแลระบบ และบัญชีของบุคคลที่สามที่แมปทั้งหมดตรงกับบัญชี Google ที่ใช้งานอยู่

2. นำเข้าบัญชีบุคคลที่สามไปยัง Google Workspace

เมื่อสร้างแหล่งข้อมูลประจำตัว Cloud Search จะเพิ่มแอตทริบิวต์ที่กำหนดเองลงในบัญชีผู้ใช้ Google ทั้งหมด แอตทริบิวต์แบบกำหนดเองนี้คือที่สำหรับจัดเก็บรหัสบัญชีบุคคลที่สามที่แมปกับบัญชี Google

หากต้องการดูแอตทริบิวต์ที่กำหนดเองนี้ในคอนโซลผู้ดูแลระบบ ให้ทำดังนี้

1. ไปที่ผู้ใช้
2. คลิกจัดการแอตทริบิวต์ที่กำหนดเอง ที่ด้านขวาบน

ข้อสำคัญ: อย่าแก้ไขแอตทริบิวต์ที่กำหนดเองนี้ หากคุณเปลี่ยนชื่อหรือฟิลด์ใดๆ ของไฟล์ Cloud Search จะทำงานไม่ถูกต้อง

หากต้องการนำเข้าชื่อผู้ใช้บุคคลที่สามไปยังช่องแอตทริบิวต์ที่กำหนดเอง ให้ทำตามวิธีใดวิธีหนึ่งดังต่อไปนี้

3. ค้นหารหัสลูกค้าขององค์กร

หากต้องการตั้งค่าตัวเชื่อมต่อข้อมูลประจำตัว นักพัฒนาแอปจะต้องมีรหัสลูกค้าของบัญชี Google เพื่อรวมไว้ในไฟล์พร็อพเพอร์ตี้ของตัวเชื่อมต่อ

1. ในคอนโซลผู้ดูแลระบบของ Google ให้ไปที่เมนู ความปลอดภัย การตรวจสอบสิทธิ์ SSO ด้วยแอปพลิเคชัน SAML

   ไปที่ SSO ด้วยแอปพลิเคชัน SAML

   คุณต้องลงชื่อเข้าใช้ในฐานะผู้ดูแลระบบขั้นสูงสำหรับงานนี้

2. ค้นหาค่า idpid ที่ท้าย URL ข้าง URL ของ SSO ค่าหลัง C คือรหัสลูกค้า

   ตัวอย่างเช่น ใน URL ต่อไปนี้ รหัสลูกค้าคือ 0123tvz4
   https://accounts.google.com/o/saml2/idp?idpid=C0123tvz4

ขั้นตอนถัดไป

มอบรหัสแหล่งที่มาของข้อมูลประจำตัวและรหัสลูกค้าให้แก่นักพัฒนาซอฟต์แวร์ที่สามารถซิงค์ระบบข้อมูลประจำตัวที่แตกต่างกันได้

แก้ไขหรือลบแหล่งที่มาของข้อมูลประจำตัว