הדגמה של הטמעת SDK

מאגר Embed SDK של Looker כולל קוד לדוגמה והדגמה של Embed SDK. בגלל דרישות האבטחה של Looker, צריך לבצע כמה הגדרות כדי להשתמש בהדגמה. בנוסף, כדי להשתמש בהדגמה צריך את הסוד להטמעה של Looker. הסוד להטמעה מעניק גישה לכל הנתונים שלכם, ולכן חשוב לשים לב לנקודות הבאות:

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

שלב 1: הפעלת הטמעה במופע Looker

מידע נוסף מופיע בדף התיעוד בנושא הטמעה עם חתימה.

  1. עוברים אל Admin > Platform Embed (ניהול > הטמעה של הפלטפורמה) במכונה של Looker. לשם כך נדרשות הרשאות אדמין.
  2. שרת ההדגמה פועל כברירת מחדל ב-http://localhost:8080. אם תוסיפו את הכתובת הזו לרשימת ההיתרים של דומיינים מוטמעים, תוכלו לאפשר להדגמה לקבל הודעות מ-Looker.
  3. מפעילים את האפשרות הטמעת אימות.
  4. כדי לראות את הסוד להטמעה, צריך לאפס אותו. מעתיקים את הסוד למקום מאובטח.

שלב 2: התאמה אישית של הגדרות ההדגמה למופע Looker

מעבירים את הסוד להטמעה לשרת. אפשר לעשות את זה בדרכים הבאות:

  • מגדירים אותו כ-LOOKER_EMBED_SECRET בסביבת מעטפת.
  • יוצרים קובץ בשם .env בתיקיית השורש של ה-SDK. מוסיפים שורה לקובץ: LOOKER_EMBED_SECRET="YourLookerSecret"

מספקים לשרת את כתובת המארח של מופע Looker באחת מהשיטות הבאות:

  • מגדירים אותו כ-LOOKER_WEB_URL בסביבת מעטפת.
  • מוסיפים את LOOKER_WEB_URL="yourinstance.looker.com:yourport" לקובץ .env.

עורכים את קובץ ה-ENV כדי לציין את המזהים של התוכן שרוצים להטמיע.

# Looker Embed Data Configuration
# Set to - if demo needs to ignore it

# Dashboard IDs
LOOKER_DASHBOARD_ID=1
LOOKER_DASHBOARD_ID_2=2
# Look ID
LOOKER_LOOK_ID=1
# Explore ID
LOOKER_EXPLORE_ID=model::explore
# Extension ID
LOOKER_EXTENSION_ID=extension::my-great-extension
# Report ID
LOOKER_REPORT_ID=aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
# Query Visualization ID
LOOKER_QUERY_VISUALIZATION_ID=1234567890ABCDEF123456

עורכים את קובץ demo/demo_user.json כך שיתאים לסוג המשתמש שרוצים להטמיע.

{
  // External embed user ID. IDs are not shared with regular users. Required
  "external_user_id": "user1",
  // First and last name. Optional
  "first_name": "Pat",
  "last_name": "Embed",
  // Duration before session expires, in seconds. Required.
  "session_length": 3600,
  // Enforce logging in with these permissions. Recommended.
  "force_logout_login": true,
  // External embed group ID. Optional.
  "external_group_id": "group1",
  // Looker Group IDs. Optional
  "group_ids": [],
  // Permissions. See documentation for details. Required.
  // Can any combination of:
  //   access_data
  //   see_looks
  //   see_user_dashboards
  //   see_lookml_dashboards
  //   explore
  //   create_table_calculations
  //   download_with_limit
  //   download_without_limit
  //   see_drill_overlay
  //   see_sql
  //   save_content
  //   embed_browse_spaces
  //   schedule_look_emails
  //   send_to_sftp
  //   send_to_s3
  //   send_outgoing_webhook
  //   schedule_external_look_emails
  "permissions": [
    "access_data",
    "see_looks",
    "see_user_dashboards",
    "explore",
    "save_content",
    "embed_browse_spaces"
  ],
  // Model access permissions. Required.
  "models": ["powered_by", "thelook"],
  // User attributes. Optional.
  "user_attributes": { "locale": "en_US" },
}

שלב 3: בנייה והרצה של ההדגמה

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

שרת צומת

  1. מריצים את npm install
  2. מריצים את npm start

השרת ידפיס את המארח והיציאה שבהם הוא פועל. אם הוא שונה מ-http://localhost:8080, תצטרכו להוסיף אותו לרשימת ההיתרים של דומיינים מוטמעים.

שרת Python

  1. מריצים את npm install
  2. מריצים את npm run python

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

יכול להיות שתצטרכו pip install six כדי להתקין את שכבת התאימות של Python 2/3.