ค้นหาข้อผิดพลาดทั่วไปของ User Sync Tool และวิธีการแก้ไข
หน้านี้แสดงรายการข้อผิดพลาดทั่วไปที่อาจพบเมื่อใช้งาน User Sync Tool พร้อมขั้นตอนการแก้ไขแต่ละรายการสำหรับภาพรวมของเครื่องมือและตำแหน่งที่ค้นหาข้อมูลการตั้งค่า การกำหนดค่า และข้อมูลอ้างอิงคำสั่ง โปรดดู การตั้งค่า User Sync Tool
การติดตั้งและสภาพแวดล้อม
อาจเกิดขึ้นบน Windows เมื่อเส้นทางเกิน 256 ตัวอักษรสร้างตัวแปรสภาพแวดล้อมชื่อ PEX_ROOT ด้วยค่า C:\pexหากรันสคริปต์จากไดรฟ์อื่นที่ไม่ใช่ C: ให้เปลี่ยนตัวอักษรไดรฟ์ให้ตรงกันบางครั้งต้องรีสตาร์ทระบบเพื่อให้การเปลี่ยนแปลงมีผล
รันคำสั่ง python จากภายในโฟลเดอร์ที่มี user-sync.pex อยู่
- ตรวจสอบว่าเวอร์ชัน Python ที่ติดตั้งในระบบเป็น 32-bit หรือไม่ถอนการติดตั้งเวอร์ชัน 32-bit และติดตั้งเวอร์ชัน 64-bit
- ตรวจสอบว่าเวอร์ชัน user-sync.pex ที่ดาวน์โหลดจาก GitHub ตรงกับเวอร์ชัน Python และระบบปฏิบัติการหรือไม่ตัวอย่างเช่น ดาวน์โหลด user-sync-v2.3-win64-py365.zip สำหรับ Windows 64-bit และ Python 3จับคู่เวอร์ชัน Python ที่ใช้สร้าง .pex แทนที่จะใช้ Python เวอร์ชันล่าสุดส่วนท้ายของ .zip แสดงเวอร์ชัน: สำหรับ user-sync-v2.3-win64-py365.zip คือ Python 3.6.5
ข้อผิดพลาดนี้ถูกบันทึกบน macOS High Sierra โดยใช้ User Sync Tool v2.3 และ Python 3.7.0การรัน brew install openssl ใน Terminal แก้ไขปัญหาได้ในกรณีนั้น
การเชื่อมต่อ การหมดเวลา และการควบคุมปริมาณการใช้งาน
หากการหมดเวลาน้อยกว่า 30 นาที คำเตือนเหล่านี้จะปรากฏเมื่อถึงโควตาของการเรียก API ที่อนุญาตภายในหนึ่งนาทีเครื่องมือใช้กลไกการเพิ่มเวลาย้อนกลับแบบเลขชี้กำลังเพื่อลองใหม่ โดยเพิ่มเวลาระหว่างการลองใหม่ และจะหยุดหลังจากความพยายามที่ล้มเหลวสามครั้งปล่อยให้สคริปต์ทำงานจนจบ
หากการหมดเวลามากกว่า 1,000 วินาที การควบคุมปริมาณการใช้งานจะเกี่ยวข้องกับความถี่ที่อินสแตนซ์ User Sync Tool แต่ละตัวทำงานอินสแตนซ์ที่ทำงานบ่อยเกินไปจะถูกควบคุมเป็นเวลา 30 ถึง 75 นาทีการหมดเวลาจะหยุดการทำงานของเครื่องมือเป็นการชั่วคราวเท่านั้น หลังจากนั้นเครื่องมือจะกลับมาทำงานและประสานข้อมูลต่อไปได้
เนื่องจากเครื่องมือจะตรวจจับเมื่ออินสแตนซ์สองตัวเริ่มต้นในเวลาเดียวกัน จะไม่มีอินสแตนซ์ใหม่ทำงานจนกว่าตัวแรกจะเสร็จสิ้นในกรณีนี้ บันทึกอาจแสดงข้อความว่ามีกระบวนการกำลังดำเนินการอยู่
เพื่อประสิทธิภาพที่ดีที่สุด ให้ปฏิบัติตามคำแนะนำความถี่ในการทำงานเหล่านี้:
- ตั้งงานที่กำหนดเวลาให้ทำซ้ำห่างกันอย่างน้อย 2 ชั่วโมง
- ตั้งทริกเกอร์งานที่กำหนดเวลาเพื่อไม่ให้เริ่มต้นในนาทีที่ :00 หรือ :30 เพื่อหลีกเลี่ยงปริมาณการใช้งานหนาแน่น
- หากต้องเรียกใช้เครื่องมือบ่อยกว่านั้น ให้พิจารณาใช้กลยุทธ์ push (delta ของการเปลี่ยนแปลง) แทนการประสานข้อมูลแบบเต็มรูปแบบ
- จับคู่ตารางการทำงานของเครื่องมือกับวันทำงานขององค์กรตัวอย่างเช่น ไม่ควรเรียกใช้งานประสานข้อมูลในตอนกลางคืนหากองค์กรไม่จำเป็นต้องแก้ไขการจัดเตรียมในเวลานั้น
เครื่องมือไม่สามารถเชื่อมต่อกับปลายทาง API สาธารณะการตั้งค่าภายในเครื่อง เช่น กฎไฟร์วอลล์ พร็อกซีที่บล็อกปริมาณการใช้งาน หรือการตั้งค่าการเข้าถึงอินเทอร์เน็ตของบัญชี สามารถป้องกันการเข้าถึงได้การเพิ่มตัวแปรสภาพแวดล้อม https_proxy ด้วยค่าเช่น http://<proxyAddress>:<port> หรือ https://<proxyAddress>:<port> สามารถช่วยได้ในกรณีอื่น ๆ ให้อนุญาตการเข้าถึงปลายทางเหล่านี้: ims-na1.adobelogin.com:443 และ usermanagement.adobe.io:443สามารถแก้ไขได้เฉพาะภายในเครื่องโดยล้างการเข้าถึงปลายทางเหล่านี้สำหรับบัญชีที่กำลังทำงาน
การตรวจสอบ SSL บนเซิร์ฟเวอร์พร็อกซีภายในเครื่องเป็นสาเหตุของปัญหานี้
วิธีแก้ไข 1: รับใบรับรอง root CA ของพร็อกซีในรูปแบบ PEM (ตัวอย่างเช่น thecert.crt)หากอยู่ในรูปแบบ DER ให้แปลงเป็น PEM ด้วยคำสั่ง openssl นี้: openssl x509 -inform DER -in thecert.crt -out thecert.pem -outform PEM ไฟล์ PEM จะแสดงสตริงที่เข้ารหัสแบบ base64 ระหว่างบรรทัด -----BEGIN CERTIFICATE----- และ -----END CERTIFICATE----- สร้างตัวแปรสภาพแวดล้อมชื่อ REQUESTS_CA_BUNDLE และตั้งค่าให้มีค่าเป็นเส้นทางของ thecert.pem
วิธีแก้ไขที่ 2: ใน Windows ข้อผิดพลาดนี้อาจเกิดขึ้นหากเครื่องมือทำงานจากไดรฟ์ที่แตกต่างจากไดรฟ์ที่ติดตั้งระบบปฏิบัติการและ Python ย้ายสคริปต์ทั้งหมดไปยังไดรฟ์ที่มีระบบปฏิบัติการ หากไม่สามารถดำเนินการได้ ให้คัดลอกไฟล์ cacert.pem ที่มี trusted root CAs ไปยังไดรฟ์อื่นและตั้งเส้นทางเป็น REQUESTS_CA_BUNDLE หากพร็อกซียังตรวจสอบปริมาณการใช้งาน SSL ให้คัดลอกเนื้อหาใบรับรอง proxy root CA ลงใน cacert.pem เพื่อให้ใบรับรองพร็อกซีได้รับความไว้วางใจ การติดตั้ง Python เริ่มต้นจะเก็บชุดใบรับรองไว้ที่ C:\Python36\Lib\site-packages\certifi\cacert.pem
วิธีแก้ไขที่ 3: ปิดการตรวจสอบ SSL ในพร็อกซีสำหรับ API endpoints ims-na1.adobelogin.com และ usermanagement.adobe.io
การรับรองความถูกต้องและข้อมูลประจำตัว
รายการ Credentials Store สำหรับ umapi_api_key อาจหายไปสร้างรายการใน Credentials Store ดูเอกสารประกอบของ User Sync Tool เกี่ยวกับ การเก็บข้อมูลประจำตัวในที่เก็บข้อมูลระดับ OS
ค่าอาจถูกเพิ่มลงใน Credentials Store ภายใต้บัญชีผู้ใช้อื่น ในขณะที่รายการนี้หายไปสำหรับผู้ใช้ที่เชื่อมต่ออยู่ในปัจจุบันเพิ่มค่าดังกล่าว หรือเปลี่ยนบัญชีผู้ใช้
- หากไม่สามารถระบุปัญหาได้อย่างรวดเร็ว ให้ออกคีย์คู่ใหม่
- ไม่ต้องใช้แอตทริบิวต์ umapi_private_key_data เมื่อเรียกใช้สคริปต์บน Windows แต่ให้เข้ารหัสคีย์และเก็บรหัสผ่านใน Credential Manager
- หากใช้รูปแบบอื่นในการออกคีย์คู่ ให้ลองใช้ private key แบบ RSA 256, 2048-bit
- คุณอาจตั้งค่า secure_priv_key_pass_key: umapi_private_key_passphrase ในไฟล์ connector-umapi.yml ตรวจสอบให้แน่ใจว่ารายการที่ตรงกันใน Credential Store และค่าที่เกี่ยวข้องจะตรงกัน
ใน Adobe Admin Console ให้ไปที่การตั้งค่า จากนั้นไปที่การตั้งค่าการรับรองความถูกต้องอาจเลือกตัวเลือกอื่นที่ไม่ใช่ Easiest for Users (รหัสผ่านไม่หมดอายุ) ตัวเลือก More Secure หรือ Most Secure สามารถทำให้รหัสผ่านของบัญชีเทคนิคที่เชื่อมโยงกับการผสานการทำงานหมดอายุได้ เพื่อแก้ไขปัญหานี้ ให้สร้างการผสานการทำงานใหม่และต่ออายุข้อมูลเมตาในไฟล์ connector-umapi.yml มีการปรับใช้การแก้ไขสำหรับปัญหานี้แล้ว แต่อาจส่งผลต่อการผสานการทำงานที่สร้างก่อนเดือนตุลาคม 2018
- ค่า tech_acct ในไฟล์ connector-umapi.yml อาจแตกต่างจาก ID บัญชีทางเทคนิคในการผสานการทำงานใน Adobe Developer Console ตรวจสอบ ID บัญชีทางเทคนิคในการผสานการทำงานปัจจุบันและคัดลอกไปยังไฟล์
- ใบรับรองสาธารณะจากการผสานการทำงานอาจหมดอายุแล้ว ต่ออายุคีย์ส่วนตัวและคีย์สาธารณะ อัปโหลดคีย์สาธารณะ และแทนที่คีย์ส่วนตัวเดิมด้วยคีย์ใหม่ ตรวจสอบเส้นทางในไฟล์ connector-umapi.yml ที่ชี้ไปยังไฟล์ที่ถูกต้อง
- ยืนยันว่าการผสานการทำงานเป็นขององค์กรที่ถูกต้อง เลือกองค์กรจากเมนูดรอปดาวน์ในมุมบนซ้ายของ Adobe Developer Console จากนั้นตรวจสอบ ID บัญชีทางเทคนิคสำหรับการผสานการทำงานที่ใช้งานอยู่พร้อมกับข้อมูลเมตาอื่น ๆ (ID องค์กร รหัสลับ และ ID ลูกค้า)
ข้อผิดพลาดนี้ปรากฏในการผสานการทำงานที่เก่ากว่า สร้างการผสานการทำงานใหม่ (หรือโปรเจค) ใน Adobe Developer Console เคียงข้างกับการผสานการทำงานที่มีอยู่ที่ใช้เพื่อวัตถุประสงค์เดียวกัน การผสานการทำงานใหม่จะให้ข้อมูลประจำตัวใหม่ ดังนั้นให้อัปเดตข้อมูลเหล่านั้นในไฟล์ connector-umapi.yml คู่คีย์ (คีย์ส่วนตัวและคีย์สาธารณะ) น่าจะถูกออกใหม่ ดังนั้นคีย์ส่วนตัวใหม่จะต้องแทนที่คีย์ที่มีอยู่
LDAP และกลุ่ม
- กลุ่มไม่มีอยู่ใน LDAP ด้วยชื่อที่ตรงกันทุกประการ เพิ่มชื่อ LDAP ที่ถูกต้องของกลุ่ม
- กลุ่มไม่สามารถค้นพบได้ภายใต้ base_dn ที่ประกาศไว้ (ดูไฟล์ connector-ldap.yml) เปลี่ยนค่า base_dn เพื่อรวมกลุ่มไว้ด้วย ปัญหานี้มักเกิดขึ้นเมื่อ base_dn ชี้ไปยัง OU เฉพาะแทนที่จะตั้งค่าให้กว้างที่สุดเท่าที่เป็นไปได้
กลุ่มผู้ใช้ group_name ในผลลัพธ์ไม่มีอยู่ในด้าน Adobe สร้างขึ้นมา หากต้องการตั้งชื่อของการกำหนดค่าสิทธิ์การใช้งานผลิตภัณฑ์ (PLC) แทนที่จะเป็นกลุ่มผู้ใช้ ให้ดูเอกสาร User Sync Tool เกี่ยวกับ การสร้างกลุ่มที่สอดคล้องกันในไดเรกทอรีองค์กร
กลุ่มที่สนใจอาจอยู่ในโดเมนย่อยในขณะที่ค่า host เป็นหนึ่งในโดเมนราก เปลี่ยนค่า host เป็นโดเมนย่อยที่พบกลุ่มผู้ใช้ หากผู้ใช้หรือกลุ่มอยู่ทั้งในโดเมนรากและโดเมนย่อย ให้ใช้พอร์ตแคตตาล็อกส่วนกลางบนโดเมนรากและเปลี่ยนกลุ่มโดเมนย่อยเป็น Universal แทน Globalตัวอย่างค่าโฮสต์ที่ใช้แคตตาล็อกส่วนกลาง: ldap://domain.local:3268 หรือ ldaps://domain.local:3269 เมื่อใช้พอร์ตแคตตาล็อกส่วนกลาง ให้ตั้งค่า base_dn เป็นค่าว่าง: base_dn: ""
ผู้ใช้และการสร้างบัญชี
โดเมนที่ใช้สร้างบัญชีอาจไม่ได้รับการอ้างสิทธิ์หรือเชื่อถือในองค์กรนี้ธงสีเขียวหรือจุดสีเขียวจะปรากฏสำหรับโดเมนที่ใช้งานอยู่ใน Adobe Admin Console ภายใต้การตั้งค่าหากไม่เป็นเช่นนั้น การทำกระบวนการอ้างสิทธิ์โดเมนให้เสร็จสมบูรณ์สามารถแก้ไขปัญหานี้ได้
มีการพยายามสร้างบัญชี Federated ID แต่ไดเรกทอรีถูกสร้างสำหรับ Enterprise ID หรือตรงกันข้าม ค้นหาแอตทริบิวต์ user_identity_type ในไฟล์ user-sync-config.yml ตั้งค่าให้ตรงกับประเภทไดเรกทอรีที่แสดงใน Adobe Admin Console (การตั้งค่า > ข้อมูลประจำตัว > โดเมน > ค่าประเภทไดเรกทอรีสำหรับโดเมน)
บางครั้งโดเมน @claimed-domain.com เป็นขององค์กรอื่นที่ตั้งค่าตัวเชื่อมต่อ Azure หรือ Google เพื่อซิงค์บัญชีไปยัง Admin Console และจากนั้นโดเมนจะได้รับความเชื่อถือจากองค์กรอื่นที่ใช้ User Sync Tool เพื่อซิงค์บัญชีในรูปแบบ @claimed-domain.com ข้อความนี้จะปรากฏขึ้นเมื่อเครื่องมือดึงข้อมูลบัญชี user@claimed-domain.com จากเซิร์ฟเวอร์ LDAP เพื่อสร้างบัญชีในองค์กรรอง แต่บัญชีดังกล่าวยังไม่ได้ถูกสร้างหรือซิงค์ในองค์กรหลักผ่านตัวเชื่อมต่อ Azure หรือ Googleสร้างหรือซิงค์บัญชี user@claimed-domain.com ในองค์กรที่ใช้ตัวเชื่อมต่อ Azure หรือ Google จากนั้นลองซิงค์อีกครั้งด้วย User Sync Tool ในองค์กรผู้รับมอบหมาย
ข้อผิดพลาดทั่วไปนี้มีสาเหตุหลายประการ แต่ปัญหาที่พบบ่อยคือโดเมนที่ใช้ในการสร้างอยู่ภายใต้การตั้งค่าซิงค์ Azure หรือ Googleในการตรวจสอบ ให้ลงชื่อเข้าใช้ Adobe Admin Console ด้วยบัญชีผู้ดูแลระบบ ไปที่การตั้งค่า เลือกไดเรกทอรีที่เก็บโดเมน และเลือกแท็บ Syncหากมีการ์ด Sync Source ปรากฏ วิธีแก้ไขขึ้นอยู่กับวิธีการซิงโครไนซ์ที่ควรดำเนินต่อ:
- หากตัวเชื่อมต่อ Azure หรือ Google ควรทำการซิงค์ ให้ดำเนินการตั้งค่า Sync Source ต่อไปและเอา User Sync Tool ออกทั้งหมด
- หาก User Sync Tool ควรทำการซิงค์ ให้เลือกไปที่การตั้งค่า จากนั้นเลือกเอา Sync ออกที่ด้านล่างของหน้าเครื่องมือจะทำงานตามปกติ
หากไม่มีการ์ด Sync Source ปรากฏ เครื่องมือปัจจุบันอาจทำงานกับ Console ที่โดเมนถูกมอบหมายจาก Console อื่น (องค์กรเจ้าของ)องค์กรนั้นอาจเปิดการซิงค์ Azure หรือ Google ซึ่งทำให้เกิดข้อผิดพลาดนี้ซิงค์บัญชีใน Console ที่เป็นเจ้าของก่อน จากนั้นใช้เครื่องมือเพื่อสร้างบัญชีใน Console ปัจจุบัน
หากไม่มีข้อใดเหมาะสม โปรดติดต่อ Enterprise Support
