הטמעה חתומה

הטמעה עם חתימה היא דרך להציג למשתמשים תצוגות, ויזואליזציות, ניתוחים, מרכזי בקרה או מרכזי בקרה של LookML מוטמעים פרטיים, בלי שהם יצטרכו להתחבר ל-Looker בנפרד. במקום זאת, המשתמשים יאומתו דרך האפליקציה שלכם.

הטמעה חתומה פועלת על ידי יצירת כתובת URL מיוחדת של Looker שבה תשתמשו ב-iframe. כתובת ה-URL מכילה את המידע שאתם רוצים לשתף, את המזהה של המשתמש במערכת שלכם ואת ההרשאות שאתם רוצים לתת למשתמש. לאחר מכן, חותמים על כתובת ה-URL באמצעות מפתח סודי שסופק על ידי Looker.

למידע על הטמעה ציבורית, אפשר לעיין בקטע הטמעה ציבורית באמצעות תגי iframe בדף התיעוד שיתוף ציבורי, ייבוא והטמעה של תצוגות.

כדי להשתמש בהטמעה חתומה במופע Looker, אדמין ב-Looker צריך להפעיל הטמעה חתומה בלוח הניהול של Looker וליצור מפתח סודי להטמעה. הוראות מפורטות זמינות במאמר תחילת העבודה עם הטמעה – הפעלת הטמעה חתומה.

אירוח מתאים להטמעה חתומה

בחלק מהדפדפנים – למשל, Safari, או דפדפנים שמותקנים בהם תוספים שחוסמים מודעות או קובצי Cookie למעקב – מדיניות ברירת המחדל לגבי קובצי Cookie היא חסימה של קובצי Cookie של צד שלישי. כשמפעילים את התכונה הטמעה ללא קובצי Cookie, דפדפנים שחוסמים קובצי Cookie של צד שלישי יכולים לאמת משתמשים ב-iframe המוטמע בדומיינים שונים. כדי להטמיע אימות ללא קובצי Cookie צריך להגדיר את ההטמעה בצד השרת. דוגמאות להגדרות מופיעות בדף התיעוד בנושא הטמעה ללא קובצי Cookie.

אם התכונה Cookieless Embed לא מופעלת, Looker משתמש בקובצי Cookie לאימות משתמשים. במקרה כזה, אי אפשר לנסות לאמת את ה-iframe המוטמע בדפדפנים שחוסמים קובצי Cookie של צד שלישי (אלא אם המשתמש משנה את הגדרות הפרטיות של קובצי ה-Cookie בדפדפן). לדוגמה, אם רוצים להטמיע מידע ב-https://mycompany.com, צריך לוודא של-Looker יש את אותו דומיין, כמו https://analytics.mycompany.com. במקרה כזה, אם Looker מארחת את המופע שלכם, צריך לפנות לתמיכה של Looker כדי להגדיר את ה-DNS הנדרש להפעלת שימוש בדומיין בהתאמה אישית. כך Looker יוכל לשתף את אותו דומיין כמו האפליקציה להטמעה ולהשתמש בקובצי Cookie מהדומיין הנוכחי, שמתקבלים כברירת מחדל בכל הדפדפנים.

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

שליטה בחשיפה של לקוחות באמצעות מערכת סגורה

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

מידע נוסף זמין במאמרי העזרה בנושא תכנון והגדרה של מערכת רמות גישה ושיטות מומלצות לאבטחה של ניתוח נתונים מוטמע.

יצירת כתובת URL חתומה להטמעה

יש כמה דרכים ליצור את כתובת ה-URL החתומה להטמעה. אפשר להשתמש באחת מהשיטות הבאות:

קידוד ידני של כתובת ה-URL החתומה להטמעה

כדי לקודד את כתובת ה-URL של ההטמעה החתומה, קודם אוספים את המידע הנדרש מ-Looker, ואז יוצרים את כתובת ה-URL של ההטמעה החתומה.

איסוף המידע הנדרש מ-Looker

כנקודת התחלה לבניית כתובת ה-URL, כדאי קודם לקבוע את כל המידע שצריך לכלול בה. תצטרכו:

כתובת URL להטמעה

מאחזרים את כתובת ה-URL של ה-Look, החיפוש, ההדמיה של השאילתה או מרכז הבקרה שרוצים להטמיע. לאחר מכן מסירים את הדומיין ומוסיפים את התו /embed לפני הנתיב, באופן הבא:

פריט תבנית URL רגילה כתובת URL להטמעה
טבלת Look https://instance_name.looker.com/looks/4 /embed/looks/4
שלב שני https://instance_name.looker.com/explore/my_model/my_explore /embed/explore/my_model/my_explore
המחשת שאילתות https://instance_name.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12

22 התווים האלפאנומריים שמופיעים אחרי הפרמטר qid= בכתובת ה-URL של הדוח ב-Explore הם Query.client_id. הערך Query.client_id הוא מחרוזת ייחודית שמייצגת את השאילתה ואת הגדרות הוויזואליזציה.

כדי להטמיע תרשים של שאילתה, מאחזרים את הערך של Query.client_id Query.client_id ומוסיפים אותו לכתובת ה-URL להטמעה.

אתם יכולים להשתמש בממשק המשתמש של Looker Explore כדי ליצור שאילתה עם תרשים נתמך, ולהעתיק את הערך Query.client_id מהפרמטר qid=. לחלופין, אתם יכולים לאחזר את הערך Query.client_id באמצעות Looker API, למשל באמצעות השיטה Get Query.		 /embed/query-visualization/Query.client_id
לוח בקרה בהגדרת המשתמש https://instance_name.looker.com/dashboards/1

כוללים את כל ערכי הסינון של לוח הבקרה hiding filter values, הפרמטר hide_filter בכתובת ה-URL של לוח הבקרה.
מרכז שליטה של LookML https://instance_name.looker.com/dashboards/my_model::my_dashboard /embed/dashboards/my_model::my_dashboard
ניתוח נתוני השיחות בדף השיחות: https://instance_name.looker.com/conversations

בדף הסוכנים: https://instance_name.looker.com/agents

לשיחה ספציפית: https://instance_name.looker.com/conversations/conversation_id

מידע נוסף זמין בדף התיעוד בנושא הטמעה של ניתוח נתונים בשיחה.		 /embed/conversations

/embed/agents

/embed/conversations/c9f370ac830b4669aeb494396422004c

הרשאות

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

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

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

הרשאה תלוי ב- סוג הגדרה
access_data ללא ספציפי למודל מאפשר למשתמש לגשת לנתונים (נדרש לצפייה ב-Looks, במרכזי בקרה או ב-Explores)
see_lookml_dashboards access_data ספציפי למודל מאפשר למשתמש לראות מרכזי שליטה של LookML. ההרשאה הזו נדרשת גם אם למשתמש יש גישת תצוגה לתיקייה של לוח הבקרה.
see_looks access_data ספציפי למודל המשתמשים יכולים לראות תצוגות Look
see_user_dashboards see_looks ספציפי למודל מאפשרת למשתמש לראות מרכזי בקרה שהוגדרו על ידי משתמשים ולעיין בתיקיות מהטמעה
explore see_looks ספציפי למודל מאפשר למשתמשים לראות את הדפים של ניתוח הנתונים
create_table_calculations explore ברמת המכונה נדרש כדי ליצור חישובים בטבלה ב-Explore
create_custom_fields explore ברמת המכונה נדרש כדי ליצור שדות בהתאמה אישית ב-Explore
can_create_forecast explore ברמת המכונה מאפשרת למשתמשים ליצור או לערוך תחזיות בהדמיות.
save_content see_looks ברמת המכונה מאפשר למשתמש לבצע שינויים בטבלאות Look ובמרכזי בקרה ולשמור אותם
send_outgoing_webhook see_looks ספציפי למודל מאפשר למשתמש לתזמן שליחת תוכן מ-Looker ל-webhook שרירותי
send_to_s3 see_looks ספציפי למודל מאפשרת למשתמש לתזמן משלוחים של תוכן Looker לקטגוריית Amazon S3
send_to_sftp see_looks ספציפי למודל מאפשר למשתמשים לתזמן משלוחים של תוכן מ-Looker לשרת SFTP
schedule_look_emails see_looks ספציפי למודל מאפשר למשתמשים לתזמן שליחת תוכן מ-Looker לכתובת האימייל שלהם (אם ההגדרה בוצעה באמצעות מאפיין משתמש בשם 'אימייל') או לכתובת אימייל שנמצאת בתוך המגבלות שמוגדרות ברשימת ההיתרים של דומיין האימייל. מאפשר למשתמש עם הרשאות create_alerts לשלוח התראות לכתובת אימייל שנמצאת במסגרת המגבלות שהוגדרו ברשימת ההיתרים של דומיין האימייל.
schedule_external_look_emails schedule_look_emails ספציפי למודל מאפשרת למשתמשים לתזמן שליחת תוכן מ-Looker לכל דומיין אימייל. מאפשר למשתמש עם הרשאות create_alerts לשלוח התראות לכל דומיין אימייל.
send_to_integration see_looks ספציפי למודל מאפשרת למשתמש להעביר תוכן מ-Looker אל שירותים של צד שלישי שמשולבים עם Looker דרך Looker Action Hub. ההרשאה הזו לא קשורה לפעולות על נתונים.
schedule_without_limit see_looks ספציפי למודל נוסף בגרסה 26.4 בשילוב עם הרשאה אחת לפחות שמאפשרת למשתמש להעביר תוכן של Looker, ההרשאה הזו מאפשרת למשתמשים להעביר תצוגות או ניתוחים ששולחים את כל שורות הנתונים. ההרשאה הזו מאפשרת לראות את האפשרות All Results (כל התוצאות) בכלי לתזמון ב-Looker עבור Looks ו-Explores.
create_alerts see_looks ברמת המכונה מאפשר למשתמשים ליצור התראות במשבצות בלוח הבקרה כדי לקבל התראות כשמתקיימים תנאים מסוימים או כשחורגים מהם. המשתמשים יכולים לערוך, לשכפל ולמחוק את ההתראות שלהם ואת ההתראות הציבוריות של משתמשים אחרים. אם סביבת העבודה של המשתמש ב-Slack לא מקושרת למופע Looker, המשתמש לא יוכל ליצור התראות שישלחו התראות ל-Slack.
download_with_limit see_looks ברמת המכונה מאפשר למשתמש להוריד את תוצאות השאילתה עם הגבלה
download_without_limit see_looks ברמת המכונה מאפשר למשתמש להוריד את תוצאות השאילתה ללא הגבלה
see_sql see_looks ספציפי למודל מאפשר למשתמש לראות את ה-SQL של שאילתות ואת כל שגיאות ה-SQL שנובעות מהרצת שאילתות
clear_cache_refresh access_data ספציפי למודל המשתמשים יכולים לנקות את המטמון ולרענן לוחות בקרה מוטמעים, לוחות בקרה מדור קודם, משבצות של לוחות בקרה, Looks ו-Explores.
see_drill_overlay access_data ספציפי למודל מאפשר למשתמשים לבצע התעמקות בנתונים בלי לעבור לדף המלא של התכונה 'Explore'.
manage_spaces ללא ברמת המכונה ההגדרה הזו מפעילה את דפדפן התוכן כדי שהמשתמשים יוכלו ליצור, להעתיק, להעביר ולמחוק תיקיות. בנוסף, המשתמשים צריכים את הרשאת הגישה לתוכן ניהול גישה, עריכה לתיקייה, או לתיקיית ההורה במקרה של יצירת תיקייה חדשה.
embed_browse_spaces ללא ברמת המכונה מאפשרת את דפדפן התוכן כדי שמשתמש יוכל לעיין בתיקיות מהטמעה. כל משתמש שמוטמע לו דוח ומקבל הרשאת embed_browse_spaces מקבל גישה לתיקייה אישית להטמעה ולתיקייה משותפת של הארגון, אם קיימת כזו.

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

כדי לראות את התוכן בתיקיות, המשתמש צריך גם את ההרשאות see_looks,‏ see_user_dashboards ו-see_lookml_dashboards.

ההרשאה embed_browse_spaces נדרשת למשתמשים שמשתמשים בהטמעה ורוצים לסמן לוחות בקרה או תצוגות Look כפריטים מועדפים, כי כדי לסמן תוכן כפריט מועדף נדרשת גישה לתיקייה Favorites.
embed_save_shared_space ללא ברמת המכונה מאפשר למשתמש שיש לו גם הרשאת save_content לנווט לתיקייה משותפת של הארגון, אם יש כזו, מתוך תיבת הדו-שיח שמירה. משתמשים שיש להם הרשאת save_content אבל לא הרשאת embed_save_shared_space, יוכלו לשמור תוכן רק בתיקיית ההטמעה האישית שלהם.

ההרשאה embed_save_shared_space לא מבטלת את הרשאות הגישה לתוכן. לדוגמה, כדי לאפשר למשתמש לשמור בתיקייה משותפת, הוא עדיין צריך גישת ניהול גישה, עריכה לתיקייה משותפת. בנוסף, היעדר ההרשאה embed_save_shared_space לא מונע ממשתמש שיש לו את ההרשאה save_content וגישת ניהול גישה, עריכה לתיקייה משותפת לשמור בה תוכן אם יש לו דרך חלופית לנווט לתיקייה משותפת, למשל באמצעות האפשרות חיפוש מפה מלוח בקרה מוטמע.
gemini_in_looker ללא ספציפי למודל ההרשאה הזו היא ההרשאה היחידה שכלולה בתפקיד ברירת המחדל של Gemini.

ההרשאה הזו מאפשרת למשתמשים לבצע את המשימות שמשויכות לכל אחת מהתכונות של Gemini ב-Looker שהופעלו בדף Gemini ב-Looker בחלונית אדמין. יכול להיות שתידרש הרשאה נוספת למשימות מסוימות.
chat_with_agent gemini_in_looker ספציפי למודל נוספו 25.18 משתמשים ב-Conversational Analytics יכולים לשוחח עם סוכני נתונים שמבוססים על הנתונים מ-Looker Explores (עד חמישה) או עם סוכני נתונים של מרכזי בקרה. כדי לשוחח עם סוכני נתונים של לוחות בקרה, נדרשות הרשאות נוספות.
chat_with_explore chat_with_agent ספציפי למודל נוספה גרסה 25.18 משתמשים בניתוח נתונים בשיחה יכולים לשוחח בצ'אט עם כלי הניתוח של Looker אם יש להם גם הרשאות נוספות שנדרשות.
save_agents chat_with_explore ספציפי למודל נוספו 25.18 משתמשים ב-Conversational Analytics יכולים ליצור, לערוך, למחוק ולשתף סוכני נתונים בלוחות בקרה או ב-Explores. כדי לערוך, למחוק או לשתף סוכן נתונים שנוצר על ידי משתמש אחר, צריך להקצות למשתמשים תפקיד שמכיל את ההרשאה הזו בכל מודל שמשמש את הסוכן, וגם הרשאות נוספות שנדרשות וגישת ניהול גישה, עריכה לסוכן.
admin_agents gemini_in_looker ספציפי למודל נוספה גרסה 25.18 משתמשים יכולים ליצור, לערוך, לשתף ולמחוק סוכני נתונים לשימוש עם Conversational Analytics API ועם Conversational Analytics מוטמע. כשמשתמש יוצר סוכן נתונים, הוא מקבל באופן אוטומטי גישה לסוכן הנתונים עם ההרשאות ניהול גישה, עריכה. ההרשאה הזו מאפשרת למשתמש לערוך, למחוק או לשתף סוכן נתונים שנוצר על ידי משתמש אחר, בלי שתינתן לו גישה לתוכן של סוכן הנתונים.

לאיזה מודל מקבלים גישה

קובעים לאילו מודלים של LookML תהיה למשתמש גישה. זו תהיה רשימה של שמות מודלים.

מאפייני המשתמשים

קובעים אילו מאפייני משתמש צריכים להיות למשתמש, אם בכלל. תצטרכו את השם של מאפיין המשתמש מ-Looker, וגם את הערך שצריך להיות למשתמש במאפיין הזה.

קבוצות

קובעים לאילו קבוצות המשתמש צריך להשתייך, אם בכלל. תצטרכו את מזהי הקבוצות ולא את שמות הקבוצות. הוספה של משתמש בהטמעה חתומה לקבוצה ב-Looker מאפשרת לכם לנהל את הגישה של המשתמש הזה לתיקיות ב-Looker. למשתמשים עם הטמעה חתומה תהיה גישה לכל התיקיות שמשותפות עם חברים בקבוצות שלהם ב-Looker.

אפשר גם להשתמש בפרמטר external_group_id כדי ליצור קבוצה שהיא חיצונית לקבוצות הרגילות ב-Looker. במקרה כזה, למשתמשים מוטמעים עם חתימה שכוללים את אותו external_group_id תהיה גישה לתיקייה משותפת בשם 'קבוצה', שהיא ייחודית לקבוצה החיצונית.

תפקידים מוטמעים

הפרמטרים permissions ו-models יוצרים תפקיד למשתמש שמוטמע. התפקיד הזה מופיע כ-Embedded Role (תפקיד מוטמע) בדף Users (משתמשים) בקטע Admin (אדמין) ב-Looker. אם הפרמטרים permissions, models ו-group_ids מצוינים כולם בכתובת ה-URL להטמעה, התפקיד המוטמע הוא תוספתי לכל התפקידים שכבר הוקצו לקבוצות שמפורטות בפרמטר group_ids. התפקידים האלה פועלים כמו תפקידים רגילים, כלומר כל התפקידים ב-Looker הם מצטברים.

לדוגמה, נניח שיש לכם קבוצה קיימת ב-Looker עם מזהה הקבוצה 1, ולקבוצה הזו כבר יש הרשאה explore למודל בשם model_one. אם תיצרו כתובת URL להטמעה עם הפרמטרים הבאים:

  • ‫group_ids = ["1"]
  • ‫permissions = ["access_data","see_looks"]
  • ‫models = ["model_two"]

במקרה כזה, המשתמש שמוטמע יקבל בירושה את היכולת להציג את הנתונים ב-model_one ולעיין בהם, והתפקיד שמוטמע שנוצר עם הפרמטרים הקודמים יאפשר גם הוא להציג את הנתונים ב-model_two.

יצירת כתובת ה-URL להטמעה

כתובת URL חתומה להטמעה היא בפורמט הבא:

‪https://HOST/login/embed/EMBED URL?PARAMETERS&signature=SIGNATURE

מארח

המארח הוא המיקום שבו מתארח מופע Looker שלכם. לדוגמה, analytics.mycompany.com. אם לא הפעלתם העברת יציאות, הקפידו לכלול את מספר היציאה, למשל analytics.mycompany.com:9999.

כתובת URL להטמעה

כתובת ה-URL להטמעה נקבעה בעבר. הפורמט יהיה כזה:

  • /embed/looks/4
  • /embed/explore/my_model/my_explore
  • /embed/query-visualization/Query.client_id
  • /embed/dashboards/1 או /embed/dashboards-legacy/1
  • /embed/dashboards/my_model::my_dashboard או /embed/dashboards-legacy/my_model::my_dashboard

המשמעות היא שהתבנית /embed//embed/ תופיע בכתובת ה-URL הסופית, וזה תקין.

אם אתם משתמשים באירועי JavaScript מוטמעים, הקפידו להוסיף את הפרמטר embed_domain (הדומיין שבו נעשה שימוש ב-iframe) לסוף כתובת ה-URL להטמעה, כך:

/embed/looks/4
⇨
/embed/looks/4?embed_domain=https://mywebsite.com

הפרמטר embed_domain מתווסף לכתובת ה-URL להטמעה לפני קידוד כתובת ה-URL. אם כתובת ה-URL להטמעה כבר מכילה פרמטרים של שאילתת תוכן (כמו ערכי סינון), מוסיפים את הפרמטר embed_domain באמצעות אמפרסנד (&):

/embed/looks/4?filter_name=value
⇨
/embed/looks/4?filter_name=value&embed_domain=https://mywebsite.com

אם אתם משתמשים ב-Embed SDK, הקפידו להוסיף את הפרמטר embed_domain ולכלול גם את sdk=2 בסוף כתובת ה-URL להטמעה, כך:

/embed/looks/4
⇨
/embed/looks/4?embed_domain=https://mywebsite.com&sdk=2

הפרמטר sdk=2 מאפשר ל-Looker לזהות שערכת ה-SDK קיימת, ולנצל את התכונות הנוספות שערכת ה-SDK מספקת. ה-SDK לא יכול להוסיף את הפרמטר הזה בעצמו כי הוא חלק מכתובת ה-URL החתומה.

פרמטרים

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

פרמטר ערך ברירת המחדל תיאור סוג הנתונים דוגמה
nonce חובה לציין ערך כל מחרוזת אקראית שרוצים, אבל היא לא יכולה לחזור על עצמה בתוך שעה והיא צריכה להיות קצרה מ-255 תווים.

כך תוקף לא יכול לשלוח מחדש כתובת URL של משתמש לגיטימי כדי לאסוף מידע שלא אמור להיות לו.		 מחרוזת JSON "22b1ee700ef3dc2f500fb7"
time חובה להזין ערך הזמן הנוכחי כחותמת זמן של מערכת UNIX. מספר שלם 1407876784
session_length חובה לציין ערך מספר השניות שבהן המשתמש צריך להישאר מחובר ל-Looker, בין 0 ל-2,592,000 שניות (30 ימים). מספר שלם 86400
external_user_id חובה לציין ערך מזהה לכל משתמש באפליקציה שבה מוטמע Looker. ‫Looker משתמש ב-external_user_id כדי להבדיל בין משתמשים מוטמעים מחוברים, ולכן לכל משתמש צריך להיות מזהה ייחודי שמוקצה לו.

אפשר ליצור external_user_id למשתמש עם כל מחרוזת שרוצים, כל עוד היא ייחודית למשתמש הזה. כל מזהה משויך לקבוצה של הרשאות, מאפייני משתמשים ומודלים. דפדפן יחיד יכול לתמוך רק ב-external_user_id אחד, או בסשן משתמש אחד, בכל פעם. אי אפשר לבצע שינויים בהרשאות של משתמש או במאפייני המשתמש באמצע סשן.

מטעמי אבטחה, חשוב לוודא שאתם לא משתמשים באותו external_user_id בכמה סשנים שונים של הטמעה למשתמשים אינטראקטיביים שונים, וגם לא באותו external_user_id למשתמש יחיד שיש לו הרשאות שונות, ערכים שונים של מאפייני משתמש או גישה למודל שונה.

שימוש באותו external_user_id לכמה משתמשים או לאותו משתמש עם כמה הרשאות, מאפייני משתמש או קבוצות מודלים, עלול לגרום לכך שמשתמשים יוכלו לראות נתונים שאחרת לא הייתה להם גישה אליהם.		 מחרוזת JSON "user-4"
permissions חובה לציין ערך רשימת ההרשאות שצריכות להיות למשתמש.

רשימת ההרשאות המותרות מופיעה בקטע הרשאות בדף הזה.		 מערך של מחרוזות [

  "access_data",

  "see_looks"

]
models חובה להזין ערך רשימת שמות המודלים שהמשתמש אמור לקבל גישה אליהם. מערך של מחרוזות [

  "model_one",

  "model_two"

]
group_ids [] רשימת קבוצות Looker שהמשתמש צריך להיות חבר בהן, אם יש כאלה. משתמשים במזהי קבוצות במקום בשמות קבוצות. מערך של מחרוזות ["4", "3"]
external_group_id "" מזהה ייחודי של הקבוצה שהמשתמש שייך אליה באפליקציה שבה מוטמע Looker.

משתמשים שיש להם הרשאה לשמור תוכן, ושמשתפים מזהה קבוצה חיצונית, יכולים לשמור ולערוך תוכן בתיקייה משותפת ב-Looker שנקראת Group. הפרמטר external_group_id הוא השיטה היחידה שזמינה ליצירת קבוצות חיצוניות של משתמשים שמוטמעים. אי אפשר להגדיר קבוצות משתמשים חיצוניות להטמעה מתוך ממשק המשתמש של Looker.

האורך של external_group_id לא יכול להיות יותר מ-81 תווים. תיקייה תואמת נוצרת עבור הקבוצה, ושמות התיקיות מוגבלים ל-100 תווים. לשם התיקייה מתווסף התחילית 'Embed Shared Group ', ולכן external_group_id מוגבל ל-81 תווים כדי שלא לחרוג ממגבלת 100 התווים.		 מחרוזת JSON "Accounting"
user_attributes {} רשימת מאפייני המשתמש שצריכים להיות למשתמש, אם יש כאלה. מכיל רשימה של שמות מאפייני משתמש, ואחריהם ערך מאפיין המשתמש.

אם מודל LookML שלכם עבר לוקליזציה, אתם יכולים להשתמש במאפיין המשתמש locale בכתובת ה-URL של ההטמעה כדי לציין שפה להטמעה. לדוגמה, הוספת הפרמטר user_attributes { "locale" : "fr_FR" } תגרום להטמעה לטעון את השפה הצרפתית.		 Hash of strings {

  "vendor_id" : "17",

  "company" : "xactness"

}
access_filters חובה להזין ערך ב-Looker 3.10 הפרמטר הזה הוסר, אבל הוא עדיין נדרש בכתובת ה-URL. משתמשים ב-access_filters עם placeholder ריק, לדוגמה access_filters={}. Empty Placeholder {}
first_name "" השם הפרטי של המשתמש. אם משאירים את השדה ריק, first_name ישמור את הערך מהבקשה האחרונה, או יקבל את הערך Embed אם לא הוגדר שם פרטי. מחרוזת JSON "Alice"
last_name "" שם המשפחה של המשתמש. אם משאירים את השדה ריק, last_name ישמור את הערך מהבקשה האחרונה, או יקבל את הערך Embed אם אף שם משפחה לא הוגדר. מחרוזת JSON "Jones"
user_timezone "" ‫אם הפעלתם את האפשרות אזורי זמן ספציפיים למשתמש, הערך של האפשרות אזור זמן של הצופה בתפריט הנפתח אזור זמן בלוח הבקרה או בדוח Look המוטמעים מוגדר. הפרמטר הזה לא משנה ישירות את אזור הזמן שבו התוכן מוצג. המשתמש יצטרך לבחור אזור זמן מהתפריט הנפתח.

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

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

  • מוסיפים את הפרמטר ?query_timezone=user_timezone לכתובת ה-URL להטמעה. לדוגמה:

    /embed/dashboards/1?query_timezone=user_timezone
  • שומרים את לוח הבקרה או את ה-Look המוטמעים עם אזור הזמן שמוגדר כברירת מחדל אזור הזמן של הצופה, שמשתמש באזור הזמן של המשתמש כברירת מחדל גם עבור משתמשים שצופים בתוכן מוטמע וגם עבור משתמשים שצופים בתוכן לא מוטמע.
    		•  מחרוזת JSON או ערך null "US/Pacific"

    - או -

    null
    force_logout_login חובה להזין ערך אם משתמש רגיל ב-Looker כבר מחובר ל-Looker, והוא צופה בפריט מוטמע עם חתימה, אתם יכולים לבחור אם:

    ‫1) הם צריכים לצפות בפריט באמצעות פרטי הכניסה הנוכחיים שלהם

    או

    ‫2) הם צריכים לצאת מהחשבון ולהיכנס אליו מחדש באמצעות פרטי הכניסה של ההטמעה החתומה.    		 ערך בוליאני (true או false) true
    ca_chat true אם הפעלתם את התכונה 'ניתוח נתונים בשיחה' ואת התכונה הפעלת סוכני לוח בקרה, תוכלו להגדיר אם חלונית השיחה של סוכן לוח הבקרה תהיה גלויה למשתמשים שמשובצים. אם true, אז Gemini Spark גלוי למשתמשים שיש להם הרשאות מתאימות לאינטראקציה עם סוכני מרכז הבקרה. ההגדרה רלוונטית רק ללוחות בקרה מוטמעים. ערך בוליאני (true או false) true

    חתימה

    ‫Looker משתמש בחתימה כדי לוודא שהסוד הנכון להטמעה שימש ליצירת החתימה בכתובת ה-URL להטמעה, ושהפרמטרים בכתובת ה-URL להטמעה לא השתנו. אם הסוד להטמעה או פרמטרים של כתובת ה-URL שונים או השתנו, החתימה לא תהיה זהה והאימות יידחה.

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

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

    1. אוספים את ערכי הפרמטרים הבאים לפי הסדר הזה:
      • מארח, ואחריו login/embed/ (לדוגמה, analytics.mycompany.com/login/embed/)
      • כתובת URL להטמעה
      • צופן חד-פעמי (nonce)
      • השעה הנוכחית
      • משך הסשן
      • מזהה משתמש חיצוני
      • הרשאות
      • מודלים
      • מזהי קבוצות
      • מזהה קבוצה חיצוני
      • מאפייני משתמש
      • מסנני גישה (נדרש placeholder ריק)
      • נתונים במרכז הבקרה של ניתוח נתוני השיחות
    2. עיצוב כל הערכים מלבד Host ו-Embed URL כ-JSON
    3. שרשור הערכים עם מעברי שורה (\n)
    4. חתימה באמצעות HMAC-SHA1 על המחרוזת המשורשרת עם מפתח הסוד להטמעה של Looker

    קידוד

    השלב האחרון הוא קידוד כתובת ה-URL.

    לפני שמקודדים את כתובת ה-URL, כתובת URL מוטמעת בפורמט תקין שכוללת את כל הפרמטרים האפשריים עשויה להיראות כך:

    https://analytics.mycompany.com/login/embed//embed/dashboards/1?
nonce="22b1ee700ef3dc2f500fb7"&
time=1407876784&
session_length=86400&
external_user_id="user-4"&
permissions=["access_data","see_user_dashboards","see_looks"]&
models=["model_one","model_two"]&
group_ids=[4,3]&
external_group_id="Allegra K"&
user_attributes={"vendor_id":"17","company":"xactness"}&
access_filters={}&
ca_chat=false&
first_name="Alice"&
last_name="Jones"&
user_timezone="US/Pacific"&
force_logout_login=true&
signature=123456789ABCDEFGHIJKL

    כמו שציינו קודם, התוכן /embed//embed/ אמור להופיע בכתובת ה-URL שלך.

    אחרי שמקודדים את כתובת ה-URL, היא נראית כך:

    https://analytics.mycompany.com/login/embed/%2embed%2Fdashboards%2F1?
nonce=%2222b1ee700ef3dc2f500fb7&%22&
time=1407876784&
session_length=86400&
external_user_id=%22user-4%22&
permissions=%5B%22access_data%22%2C%22see_user_dashboards%22%2C%22see_looks%22%5D&
models=%5B%22model_one%22%2C%22model_two%22%5D&
group_ids=%5B4%2C3%5D&
external_group_id=%22Allegra%20K%22&
user_attributes=%7B%22vendor_id%22%3A%2217%22%2C%22company%22%3A%22xactness%22%7D&
access_filters%7B%7D%26%0A
ca_chat=false&
first_name=%22Alice%22&
last_name=%22Jones%22&
user_timezone=%22US%2FPacific%22&
force_logout_login=true&
signature=123456789ABCDEFGHIJKL

    שימוש בנקודת קצה ל-API של Create Signed Embed Url

    ‫Looker API כולל את נקודת הקצה Create Signed Embed Url, שמקבלת קבוצה של פרמטרים של הטמעה חתומה שכוללת את כתובת ה-URL של התוכן שרוצים להטמיע, ומחזירה כתובת URL מלאה, מקודדת וחתומה קריפטוגרפית.

    כדי להשתמש בנקודת קצה ל-API זו משרת אינטרנט, לשרת האינטרנט צריכות להיות הרשאות אדמין כדי לאמת את הכניסה ל-Looker API. הדומיין של שרת האינטרנט צריך להופיע גם ברשימת ההיתרים של דומיינים להטמעה.

    אפשר גם להשתמש ב-API Explorer כדי ליצור כתובת URL חתומה שמשתמשת בנקודת הקצה הזו. אפשר להתקין את API Explorer במכונה של Looker מ-Looker Marketplace. אחרי שיוצרים כתובת URL חתומה, צריך להעתיק אותה בדיוק כמו שהיא ולהשתמש בה רק פעם אחת – אחרת היא לא תפעל. בנוסף, כדאי להשתמש ב-APIs Explorer כדי ליצור כתובת URL חתומה ולהשוות אותה לכתובת URL חתומה שנוצרה באופן ידני, לצורך פתרון בעיות.

    מידע נוסף על Looker API זמין בדף התיעוד תחילת העבודה עם Looker API.

    בדיקת כתובת ה-URL להטמעה

    כדי לבדוק את כתובת ה-URL הסופית, מדביקים אותה ב-Embed URI Validator (כלי לאימות של URI להטמעה) בדף Embed (הטמעה) בקטע Admin (אדמין) ב-Looker. האפשרות הזו לא יכולה להגיד לכם אם הנתונים וההרשאות שאתם רוצים הוגדרו בצורה נכונה, אבל היא יכולה לאמת שהאימות שלכם פועל בצורה תקינה.