Incorporar demostración del SDK

El repositorio del SDK de Embed de Looker incluye código de muestra y una demostración sencilla del SDK de Embed. Debido a la atención que Looker presta a la seguridad, la demostración requiere un poco de configuración. La demostración también requiere tu secreto de incorporación de Looker. El secreto de incorporación otorga acceso a todos tus datos, así que ten en cuenta lo siguiente:

  • No compartas tu secreto con personas que no quieres que tengan acceso completo a tu instancia.
  • No restablezcas tu secreto si ya lo usas en otro contexto.
  • No configures tu código para almacenar el secreto en el navegador web.

Paso 1: Habilita la incorporación en tu instancia de Looker

Esto se documenta con más detalle en la página de documentación de Incorporación firmada.

  1. Navega a Administrador > Incorporación de la plataforma en tu instancia de Looker. Esto requiere privilegios de administrador.
  2. El servidor de demostración se ejecuta de forma predeterminada en http://localhost:8080. Agrega la dirección a la lista de entidades permitidas del dominio incorporado para habilitar la demostración y recibir mensajes de Looker.
  3. Activa Incorporar autenticación.
  4. Para ver tu secreto de incorporación, debes restablecerlo. Copia el secreto en un lugar seguro.

Paso 2: Personaliza la configuración de demostración para tu instancia de Looker

Proporciona el secreto de incorporación al servidor. Puedes hacerlo de dos maneras:

  • Configúralo como LOOKER_EMBED_SECRET en tu entorno de shell.
  • Crea un archivo llamado .env en la raíz del directorio del SDK. Agrega una línea a ese archivo: LOOKER_EMBED_SECRET="YourLookerSecret".

Proporciona la dirección del host de tu instancia de Looker al servidor de alguna de las siguientes maneras:

  • Configúralo como LOOKER_EMBED_HOST en tu entorno de shell.
  • Agrega LOOKER_EMBED_HOST="yourinstance.looker.com:yourport" al archivo .env.

Edita el archivo demo/demo_config.ts para que sea adecuado para las páginas que deseas incorporar.

// The address of your Looker instance. Required.
export const lookerHost = 'self-signed.looker.com:9999'

// A dashboard that the user can see. Set to 0 to disable dashboard.
export const dashboardId = 1
// A Look that the user can see. Set to 0 to disable look.
export const lookId = 1

Edita el archivo demo/demo_user.json de modo que sea adecuado para el tipo de usuario que quieres incorporar.

{
  // 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" },
}

Paso 3: Crea y ejecuta la demostración

Servidor de nodos

  1. Ejecuta npm install
  2. Ejecuta npm start

El servidor imprimirá el host y el puerto en los que se está ejecutando. Si es diferente de http://localhost:8080, deberás agregarla a tu lista de entidades permitidas del dominio incorporado.

Servidor Python

  1. Ejecuta npm install
  2. Ejecuta npm run python

El servidor imprimirá el host y el puerto en los que se está ejecutando.

Es posible que debas usar pip install six para instalar la capa de compatibilidad de Python 2/3.