פתרון בעיות שקשורות לחשבונות כפולים אחרי שינוי כתובת האימייל

המדריך הזה עוזר לכם לפתור בעיות שקשורות לחשבונות משתמשים כפולים שנוצרים ב-Looker כשכתובת האימייל הראשית של משתמש קיים משתנה בספק הזהויות (IdP), כמו Azure Active Directory‏ (Azure AD).

לפני שמתחילים לפתור בעיות, צריך לקבוע אם המופע הוא מופע Looker (מקורי) (מתארח או באירוח עצמי) או מופע Looker (Google Cloud core), כי הם תומכים באפשרויות שונות למיזוג משתמשים:

• ‫Looker (original)‎: תומך בסיסמאות ובאישורים מקומיים לאימייל. האפשרות הזו מאפשרת לכם למזג משתמשים באמצעות התאמה של כתובות אימייל כשמזהים ייחודיים של ספק זהויות (IdP) משתנים.
• ‫Looker (Google Cloud Core): אין תמיכה בכניסה באמצעות אימייל וסיסמה מקומיים או בפרטי כניסה לאימייל. לכן, אי אפשר למזג משתמשים באמצעות האפשרות של פרטי הכניסה (כתובת אימייל וסיסמה) ב-Looker (Google Cloud core).

מופעים של Looker (original)‎

התרשים הבא יעזור לכם לפתור בעיות שקשורות לשינוי כתובת אימייל במופעים של Looker (גרסה מקורית):

בקטעים הבאים מפורטים התרחישים בעץ.

הגדרת ספק הזהויות

כדי למנוע כפילויות בחשבונות כשכתובות האימייל של המשתמשים משתנות, אפשר להגדיר את ספק הזהויות כך שיקבע מזהה ייחודי שלא ניתן לשינוי:

1. בספק הזהויות (למשל, Azure AD), מחפשים את הגדרות המיפוי של המזהה הייחודי (לדוגמה, המאפיין Unique User Identifier (Name ID) ל-SAML או ההצהרה sub ל-OIDC).
2. כדאי להגדיר את המאפיין הזה למיפוי למאפיין משתמש שלא ניתן לשינוי (כמו מזהה עובד או UUID של מסד נתונים) במקום לכתובת אימייל שניתנת לשינוי.
3. שומרים את ההגדרות. מכיוון שהמזהה הייחודי נשאר קבוע כשכתובת האימייל משתנה, Looker מזהה את המשתמש הקיים ומעדכן את כתובת האימייל שלו באופן אוטומטי בכניסה הבאה שלו, בלי ליצור חשבון כפול.

מניעת כפילויות

אם אתם משתמשים בכתובת אימייל שניתנת לשינוי כמזהה הייחודי ב-Looker (המקורי), ואין לכם אפשרות לשנות אותה למאפיין שלא ניתן לשינוי, אתם צריכים לבצע את השלבים הבאים כדי להגדיר את Looker כך שימזג משתמשים על סמך התאמה של כתובות אימייל:

1. בחלונית Admin (אדמין) ב-Looker, עוברים אל Admin > SAML או אל Admin > OpenID Connect.
2. עוברים לאפשרות מיזוג משתמשים באמצעות ומסמנים את התיבה Looker אימייל/סיסמה.
3. לפני שהמשתמש נכנס באמצעות כתובת האימייל החדשה שלו, אתם צריכים ליצור אישור אימייל של Looker בחשבון המשתמש הקיים שלו, שזהה לכתובת האימייל החדשה. משתמשים בנקודת הקצה (endpoint) של Looker API‏ create_user_credentials_email: POST /api/4.0/users/<var>USER_ID</var>/credentials_email מציינים את כתובת האימייל החדשה בגוף הבקשה.
4. מבקשים מהמשתמש להיכנס לחשבון. מערכת Looker תשווה בין כתובת האימייל החדשה שהוגדרה על ידי ספק הזהויות לבין פרטי הכניסה של כתובת האימייל שנוצרה מראש, ותמזג את החשבונות.

ניקוי של עותקים כפולים

אם כתובת האימייל כבר שונתה ויש חשבונות משתמש כפולים, צריך לפעול לפי השלבים הבאים כדי לנקות את החשבונות ולמזג אותם:

1. בחלונית האדמין של Looker, עוברים אל Admin > Users ומזהים את החשבון המקורי של המשתמש ואת החשבון הכפול.
2. בודקים אם בחשבון הכפול יש תוכן שנוצר על ידי משתמשים או לוחות זמנים שצריך לשמור. אם כן, פועלים לפי השלבים שמפורטים בקטע העברת תוכן כפול.
3. בהגדרות SAML או OIDC ב-Looker, מוודאים שהאפשרות Merge Users Using (מיזוג משתמשים באמצעות) מופעלת עם Looker Email/Password (כתובת אימייל/סיסמה ב-Looker).
4. מוחקים את חשבון המשתמש הכפול.
5. ב-Looker API, יוצרים פרטי כניסה לאימייל של Looker בחשבון המשתמש המקורי שמשתמש בכתובת האימייל החדשה: POST /api/4.0/users/<var>USER_ID</var>/credentials_email
6. מנחים את המשתמש להיכנס באמצעות SAML או OIDC. מערכת Looker תמזג את פרטי הכניסה שלהם לחשבון המשתמש המקורי.

העברת תוכן כפול

אם החשבון הכפול מכיל תוכן שנוצר על ידי משתמשים, פריטים בתיקייה אישית, מראה, לוחות בקרה או לוחות זמנים, אפשר להעביר אותם לחשבון המקורי לפני שמוחקים את החשבון הכפול:

1. משתמשים ב-Looker API כדי לאחזר את רשימת התוכן והתזמונים שמשויכים למזהה המשתמש הכפול.
2. קוראים לנקודות הקצה של העדכון (כמו update_dashboard, update_look או update_schedule_plan) כדי לשנות את הבעלים של המשאבים האלה למזהה המשתמש המקורי.
3. אפשר גם להשתמש בכלים כמו חבילת הניהול של Looker בקוד פתוח כדי לבצע העברות בכמות גדולה של תוכן משתמשים.
4. אחרי שתעבירו את התוכן, תצטרכו למחוק את חשבון המשתמש הכפול.

מופעים של Looker (Google Cloud Core)‎

‫Looker (Google Cloud core) לא תומך בשילוב של פרטי כניסה לאימייל או של אימייל וסיסמה. התרשים הבא יעזור לכם להבין מה הפעולה הנכונה שצריך לעשות, בהתאם למצב, כשמשנים את כתובת האימייל ב-Looker (Google Cloud core):

בקטעים הבאים מפורטים התרחישים בעץ.

שלבים לפני ההעברה

אם אתם מתכוננים להעביר נתונים ממופע של Looker (מקורי) ל-Looker (Google Cloud core), אתם צריכים לבצע את השלבים הבאים כדי להמיר את המשתמשים לשיטת אימות שנתמכת ב-Core (למשל Google OAuth):

1. מפעילים את Google OAuth במכונה (המקורית) של Looker.
2. מפעילים את האפשרות מיזוג משתמשים באמצעות עם האפשרות שם משתמש/סיסמה ב-Looker שמופעלת בהגדרות Google OAuth.
3. לפני ההעברה, צריך להנחות את כל המשתמשים להיכנס למופע Looker (המקורי) באמצעות Google OAuth כדי למזג את החשבונות שלהם.
4. מבצעים את ההעברה אל Looker (Google Cloud Core).

השלבים אחרי ההעברה

אם ההעברה אל Looker (Google Cloud core) הסתיימה ועדיין קיימים חשבונות כפולים, צריך לבצע אחת מהמשימות הבאות:

• אם עדיין יש גישה למופע Looker (מקורי): צריך ליצור קשר עם Google Cloud התמיכה כדי לשחזר את המופע, לבצע את השלבים של מיזוג Google OAuth במופע המקורי, ואז לבצע מחדש את ההעברה אל Looker (Google Cloud core).
• אם אין גישה למופע Looker (מקורי): צריך להעביר באופן ידני תוכן שנוצר על ידי משתמשים באמצעות סקריפטים של Looker API מהחשבונות הישנים של המשתמשים לחשבונות החדשים שלהם, ואז למחוק את החשבונות הישנים או הכפולים.

בדיקה סופית ותמיכה

אם עדיין לא הצלחתם לפתור את הבעיה של חשבונות כפולים, פנו לתמיכה.