Configuración de administrador - Atributos de usuario

Los atributos de usuario proporcionan una experiencia personalizada a cada usuario de Looker. Un administrador de Looker define un atributo de usuario y, a continuación, aplica un valor de atributo de usuario a un grupo de usuarios o a usuarios concretos.

Los administradores también pueden definir atributos de usuario cuyos valores proporcionen los propios usuarios, como contraseñas o información de contacto. En varios lugares de Looker se pueden hacer referencia a los atributos de usuario para ofrecer una experiencia personalizada a cada usuario.

Looker incluye automáticamente algunos atributos de usuario, como email, first_name, landing_page, last_name, full_name, ID, timezone (si está configurado), locale y number_format.

Ver atributos de usuario

Para ver la lista de atributos de usuario, vaya a la página Atributos de usuario de la sección Usuarios del menú Administración.

En la tabla de atributos de usuario se indica el nombre, la etiqueta y el tipo de cada atributo de usuario (consulte la siguiente sección para obtener más información). Además, la tabla incluye un botón con las acciones que puede realizar en el atributo de usuario. En algunos atributos se muestra "Predeterminado del sistema" en lugar de un botón de acción, lo que significa que Looker crea automáticamente esos atributos para cada usuario. Looker reserva los atributos de usuario predeterminados del sistema para uso interno y no se pueden editar.

Crear atributos de usuario

Para definir un atributo de usuario, haga clic en el botón Crear atributo de usuario de la página Atributos de usuario, que se encuentra en la sección Usuarios del menú Administrar. Cada atributo de usuario tiene los siguientes ajustes:

  • Nombre: nombre del atributo de usuario que se usará en entornos basados en texto, como LookML (los nombres solo pueden contener letras minúsculas, números y guiones bajos).
  • Etiqueta: versión del nombre fácil de usar. De forma predeterminada, será el nombre del atributo, con los guiones bajos sustituidos por espacios y cada palabra con la primera letra en mayúscula. Sin embargo, la etiqueta se puede modificar según sea necesario.

  • Tipo de datos: este ajuste se usa para comprobar que se asignan valores válidos a los usuarios para este atributo de usuario. El tipo de datos del atributo de usuario puede ser uno de los siguientes:

    • Cadena: selecciona esta opción para crear un atributo de usuario que coincida exactamente con un valor de cadena, como un nombre de usuario. Para usar varios valores de cadena o una expresión de filtro de Looker en el valor del atributo de usuario, seleccione la opción Filtro de cadena (avanzado). Si quieres que tu atributo de usuario se trate como una cadena literal, asegúrate de incluir comillas simples ' en su sintaxis, como en este ejemplo: none '{{ _user_attributes['name_of_attribute'] }}'
    • Número: selecciona esta opción para especificar un solo número, como el número de empleado. Para usar un intervalo de números o una expresión de filtro de Looker, usa el Filtro de número (avanzado).
    • Fecha/Hora: seleccione esta opción para especificar una fecha u hora concretas, como la fecha de nacimiento del usuario. Para usar un intervalo de fechas o una expresión de filtro de Looker, usa el filtro de fecha y hora (avanzado).
    • URL relativa: seleccione esta opción para especificar una URL relativa, como /browse/boards/2, que apunte a contenido específico, como un panel, una carpeta o un archivo Markdown (por ejemplo, un archivo README o un archivo de documento de un proyecto) en su instancia de Looker. Por ejemplo, el atributo de usuario landing_page tiene el tipo de datos URL relativa y se puede usar para especificar una página principal concreta para un usuario o un grupo.
    • Filtro de cadena (avanzado): selecciona esta opción para permitir varios valores de cadena o una expresión de filtro de Looker en el atributo de usuario. Consulta la página de documentación Expresiones de filtro para ver una lista de las expresiones de filtro que puedes usar con cadenas.
    • Filtro de número (avanzado): selecciona esta opción para permitir un intervalo de valores numéricos o una expresión de filtro de Looker en el atributo de usuario. Consulta la página de documentación Expresiones de filtro para ver una lista de las expresiones de filtro que puedes usar con números.
    • Filtro de fecha y hora (avanzado): selecciona esta opción para permitir un intervalo de fechas o una expresión de filtro de Looker en el atributo de usuario. Consulta la página de documentación sobre expresiones de filtro para ver una lista de las expresiones de filtro que puedes usar para fechas y horas.

    Use los tipos de datos Filtro de cadena (avanzado), Filtro de número (avanzado) y Filtro de fecha/hora (avanzado) para introducir valores mediante expresiones de filtro de Looker, que devolverán un intervalo de valores para un atributo de usuario.

  • Acceso de usuario: puede elegir el nivel de visibilidad y edición que tienen los usuarios en un atributo de usuario:

    • Ninguno: no aparecerá en las páginas de las cuentas de los usuarios.
    • Ver: aparecerá en las páginas de las cuentas de los usuarios, pero no se podrá editar.
    • Editar: aparecerá en las páginas de la cuenta de los usuarios y lo puede definir el usuario.

  • Ocultar valores: aunque los atributos de usuario sean visibles para los usuarios, si se define esta opción como Sí, los valores de los atributos de usuario se ocultarán, lo que resulta útil para contraseñas u otra información sensible. Si asignas el valor Sí, también se ocultará el valor del atributo de usuario en los menús desplegables de atributos de usuario de la página Configuración de la conexión. Una vez que se le asigna el valor Sí, no se puede volver a cambiar a No. Si asigna el valor Sí a Ocultar valores, también debe especificar una lista de permitidos de dominios que puedan ser el destino del atributo de usuario.

  • Lista de permitidos de dominios: cuando ocultas los valores de un nuevo atributo de usuario, también debes especificar una lista de permitidos de dominios que incluya las URLs a las que se puede enviar el atributo, como nombres de host para conexiones de bases de datos y URLs para integraciones HTTPS de Git de proyectos. Puede usar el comodín (*) para habilitar la publicación en varias páginas del mismo sitio. Una vez que hayas especificado una lista de permitidos de dominios, el atributo de usuario solo se podrá enviar a los destinos que hayas incluido en la lista.

    Una vez que hayas especificado la lista de dominios permitidos para este atributo de usuario, si se le ha asignado algún valor (a un usuario, a un grupo o mediante la definición de un valor predeterminado), no podrás cambiar la lista para que las URLs sean menos restrictivas. Solo puedes restringir las URLs o eliminarlas de la lista de permitidos. Por ejemplo, si Lista de permitidos de dominios incluye la entrada my_domain/route/*, no podrá cambiarla más adelante a my_domain/*. Si necesitas que la lista de permitidos sea menos restrictiva, elimina todos los valores asignados al atributo de usuario, incluidos los valores predeterminados.

  • Definir un valor predeterminado: selecciona esta casilla para definir un valor predeterminado en caso de que no se asigne ningún valor a un usuario.

Una vez que hayas definido un atributo de usuario, puedes asignar valores a usuarios concretos o a grupos de usuarios haciendo clic en las pestañas Valores de usuario y Valores de grupo de la página.

Asignar valores a usuarios concretos

Después de definir un atributo de usuario, puedes asignarle un valor a un usuario concreto:

  1. En la sección Usuarios del menú Administración, haga clic en la pestaña Valores de usuario de la página Atributos de usuario.
  2. Elige el usuario al que quieres asignar un valor en el menú desplegable. Se mostrará una tabla con los valores que se aplican a ese usuario.
  3. Haz clic en el botón Definir valor para el usuario.
  4. Introduce el nuevo valor en el campo Valor nuevo.
  5. Haz clic en Guardar.

Cuando se asigna un valor a un usuario concreto, ese valor siempre tiene prioridad sobre los valores que se asignen a los grupos de ese usuario. La pestaña Valores de usuario muestra cuándo se ha asignado un valor personalizado a un atributo de usuario que anula un valor de grupo. El texto "Sustituido" aparecerá junto a los valores sustituidos, y estos valores no se tendrán en cuenta. El texto "Valor actual" aparecerá junto al valor del atributo de usuario activo.

Para asignar varios valores a un atributo de usuario, usa el tipo de datos Filtro de cadena (avanzado) e introduce varios valores separados por comas. Asegúrate de que no haya espacios en blanco entre los valores. Por ejemplo, puedes introducir la cadena Executive, Management, Contributors.

Para asignar todos los valores posibles a un administrador de Looker u otro usuario, usa un valor comodín en el atributo de usuario:

  • Para dar acceso a un administrador u otro usuario a todos los valores de un campo de cadena, defina el tipo de datos del atributo de usuario como Filtro de cadena (avanzado) y use el valor %, NULL.

  • Para dar acceso a un administrador u otro usuario a todos los valores de un campo de número, defina el tipo de datos del atributo de usuario como Filtro de número (avanzado) y use el valor <0, >=0, NULL.

Asignar valores a grupos de usuarios

Puedes asignar un valor a un atributo de usuario de un grupo de usuarios. En la página Atributos de usuario del panel Administrar, seleccione Editar a la derecha del atributo que quiera definir. A continuación, siga estos pasos:

  1. Haga clic en la pestaña Valores de grupo.
  2. Haz clic en el botón + Añadir grupo.
  3. En el menú desplegable, elige el grupo al que quieras asignar un valor.
  4. Introduce el valor que quieres que tenga el grupo en el campo Valor.
  5. Haz clic en Guardar.

Cuando se asigna un valor a varios grupos, debes decidir qué grupo debe tener prioridad en caso de que un usuario pertenezca a varios grupos. Para ello, arrastra los grupos al orden que quieras aplicar. Cada grupo tiene prioridad sobre los grupos que aparecen debajo.

Por ejemplo, puede tener los grupos Equipo directivo y Equipo de gestión. Los directivos también son administradores, por lo que pertenecen a ambos grupos. Si arrastras el grupo Equipo directivo a la parte superior de la lista, te asegurarás de que a sus miembros se les asigne el valor Directivo en lugar del valor Administrador.

Si un usuario ha definido un valor personalizado para un atributo de usuario, el valor que haya definido el usuario anulará cualquier valor asignado a un grupo al que pertenezca el usuario.

¿Dónde se pueden usar los atributos de usuario?

Los atributos de usuario tienen las siguientes funciones:

Conexiones de bases de datos

El host, el puerto, la base de datos, el nombre de usuario, la contraseña y el esquema de una conexión pueden tener el valor de un atributo de usuario. El campo de host de conexión no aceptará un atributo de usuario que tenga el nivel Acceso de usuario definido como Editable.

Estos atributos de usuario hacen que la conexión sea específica del usuario que ejecuta una consulta. Los atributos de usuario también se pueden consultar en el campo Parámetros JDBC adicionales, que personaliza la cadena de conexión JDBC. Cuando un usuario ejecuta una consulta mediante la conexión, se aplican los valores de los atributos de usuario asignados al usuario, lo que permite personalizar la conexión en función del usuario.

Configuración

Cualquier conexión se puede configurar para usar atributos de usuario desde la página Conexiones de la sección Administración de Looker. Consulta la página de documentación Configuración de administrador - Conexiones para obtener información sobre la página Conexiones. Para crear una conexión, haz clic en Añadir conexión. Para configurar una conexión, haz clic en Editar junto a ella.

Si una entrada se puede definir como un atributo de usuario, Looker muestra un botón Atributo de usuario junto a la entrada .

Haga clic en el botón Atributo de usuario para que se muestre un menú desplegable en el que pueda elegir el atributo de usuario que quiera. En la lista se muestra el nombre del atributo de usuario y, entre paréntesis, el valor del atributo de usuario del usuario actual.

Para hacer referencia a un atributo de usuario en el campo Additional JDBC parameters (Parámetros JDBC adicionales), se usa la misma sintaxis de plantillas de Liquid que está disponible en LookML. Los atributos de usuario están disponibles a través de la variable de Liquid _user_attributes. Por ejemplo, para hacer referencia a un atributo de usuario llamado my_jdbc_param_attribute, utiliza la siguiente sintaxis:

my_jdbc_param={{ _user_attributes['name_of_attribute'] }}

Caso práctico: aplicar permisos a nivel de base de datos en Looker

Si tu base de datos tiene diferentes cuentas con varias restricciones de acceso, puedes usar los permisos de tu base de datos en Looker. Parametriza el nombre de usuario y la contraseña de una conexión para que cada usuario se conecte con las credenciales adecuadas para su nivel de acceso a la base de datos. Aunque esto asegura que los usuarios no vean datos a los que no deberían tener acceso, no afectará a las Exploraciones, dimensiones y medidas que se les muestren en Looker.

Por ejemplo, si un usuario está configurado para conectarse a la base de datos con una cuenta que le impide ver una columna credit_card_number en la tabla user, cualquier dimensión que utilice esa columna de la base de datos seguirá apareciendo en Looker. Reciben un error de la base de datos si intentan ejecutar una consulta que incluya esa dimensión.

Caso práctico: usar un modelo para varias bases de datos idénticas

Por ejemplo, si tienes varias bases de datos con el mismo esquema, como cuando los datos de cada cliente se almacenan en una base de datos independiente para aplicar medidas de seguridad de los datos (como el cumplimiento de la HIPAA). También puede que quieras que tus desarrolladores de LookML ejecuten consultas en una copia de desarrollo de una base de datos de producción.

Si estas bases de datos se encuentran en el mismo servidor de bases de datos, no es necesario que configures conexiones ni modelos independientes. En su lugar, asigne la base de datos de una conexión a un atributo de usuario y cada usuario se dirigirá a la base de datos especificada en el valor del atributo de usuario Database Name.

Acciones de datos

Las acciones de datos se pueden configurar para que incluyan determinados atributos de usuario en su carga útil JSON. Úsalo para enviar información específica del usuario junto con los datos, como sus credenciales para realizar una operación en un servicio concreto.

Configuración

Para incluir un atributo de usuario en una acción de datos, añade un bloque user_attribute_param a la definición de action. Cada bloque tiene dos parámetros:

  • user_attribute: nombre del atributo de usuario
  • name: el nombre que se va a usar en la carga útil de JSON

En este ejemplo se usan dos atributos de usuario (salesforce_username y salesforce_password) para almacenar las credenciales de Salesforce de cada usuario en Looker. Cuando un usuario realiza la acción Actualizar datos de Salesforce, Looker envía sus credenciales de Salesforce con la carga útil de JSON, que el servidor receptor puede usar para autenticarse en Salesforce.

dimension: stage_name {
  type: string
  sql: ${TABLE}.stage_name;;
  action: {
    label: "Update in Salesforce"
    url: "https://example.com/my_salesforce_url"
    user_attribute_param: {
      user_attribute: salesforce_username
      name: "username"
    }
    user_attribute_param: {
      user_attribute: salesforce_password
      name: "password"
    }
    form_param: {
      name: "new_stage_name"
      type: string
      required: yes
    }
  }
}

Acciones personalizadas en un centro de acciones

Puede configurar una acción personalizada para incluir atributos de usuario que impidan que los usuarios envíen o programen contenido de Looker a ese destino de acción si no tienen un valor definido para ese atributo de usuario.

Configuración

El parámetro params de una acción personalizada representa los campos de formulario que un administrador de Looker debe configurar en la página de habilitación de la acción desde la lista Acciones del panel Administración. En el parámetro params del archivo de acción, incluya lo siguiente:

  params = [{
    description: "A description of the param.",
    label: "A label for the param.",
    name: "action_param_name",
    user_attribute_name: "user_attribute_name",
    required: true,
    sensitive: true,
  }]

donde user_attribute_name es el atributo de usuario definido en el campo Nombre de la página Atributos de usuario de la sección Usuarios del panel Administración. required: true significa que un usuario debe tener un valor no nulo y válido definido para ese atributo de usuario para ver la acción al enviar datos. sensitive: true significa que el valor del atributo de usuario está cifrado y nunca se muestra en la interfaz de usuario de Looker una vez introducido. Puedes especificar varios subparámetros de atributos de usuario.

Un administrador de Looker debe configurar los campos del formulario de la acción con el atributo de usuario:

  1. Haz clic en el botón Habilitar o Configuración situado junto a la acción en la página Acciones del panel Administrar.
  2. Haz clic en el icono de atributo de usuario del campo correspondiente y selecciona el atributo de usuario que quieras.

Consulta la sección Añadir atributos de usuario a acciones personalizadas de la página de documentación Compartir datos a través de un centro de acciones.

Filtros

Los filtros de Exploraciones, Looks y paneles de control se pueden definir en un atributo de usuario para personalizar la consulta en función del usuario que la ejecute.

Por ejemplo, puede crear un atributo de usuario llamado salesforce_username y configurar cada usuario de Looker para que su valor sea su nombre de usuario de Salesforce. Después, podría definir un filtro en un panel de control para el atributo de usuario salesforce_username y cada usuario vería ese panel de control filtrado por su nombre de usuario de Salesforce.

Configuración

En la sección FILTROS de un Exploración, un Look o un panel de control:

  1. Selecciona la opción coincide con un atributo de usuario en el filtro que quieras.

    El cuadro de selección de la derecha se actualiza automáticamente con una lista de atributos de usuario que tienen el mismo tipo que el campo del filtro (por ejemplo, número, cadena [texto] o fecha). Looker muestra el valor de cada atributo de usuario entre paréntesis.

  2. Seleccione el atributo de usuario que quiera.

Sintaxis de filtros avanzados

Si quieres hacer algo más complejo que una simple comprobación de igualdad para el filtro, selecciona coincide con (avanzado) y haz referencia al atributo de usuario mediante una variable Liquid:

{{ _user_attributes['name_of_attribute'] }}

Por ejemplo, supongamos que necesitas aplicar un prefijo sf_ al valor del atributo de usuario salesforce_username porque así es como se almacenan los valores en tu base de datos. Para añadir el prefijo al valor del atributo de usuario, utiliza la sintaxis de la variable Liquid _user_attributes:


sf_{{_user_attributes['salesforce_username']}}

Puedes usar el mismo patrón para insertar atributos de usuario en filtros de panel de LookML y filtros de elementos de panel.

Paneles de control e Looks programados

Los filtros de panel de control y de vista se pueden definir por programación, incluida la opción de usar un atributo de usuario. De esta forma, puedes personalizar los resultados de la entrega de datos para cada destinatario de correo. Puedes personalizar las entregas de contenido que se envían como entregas únicas y periódicas.

Por ejemplo, puede crear un atributo de usuario llamado salesforce_username y asignarle el nombre de usuario de Salesforce de cada usuario. Aplica un filtro al atributo de usuario salesforce_username en un panel de control o en una programación de Look para que cada destinatario reciba el panel de control filtrado por su nombre de usuario de Salesforce.

Requisitos previos

Solo los usuarios de Looker tienen valores de atributos de usuario definidos, por lo que todos los destinatarios de la entrega de datos deben tener una cuenta de Looker. Los atributos de usuario se aplican ejecutando el panel de control o el Look una vez por cada destinatario.

Configuración

Abre el programador del Look o del panel de control:

  1. En la sección Filtros, seleccione la opción coincide con un atributo de usuario en el filtro que quiera.

    El cuadro de selección de la derecha se actualiza automáticamente con una lista de atributos de usuario del mismo tipo que el filtro. Tu propio valor de cada atributo de usuario se muestra entre paréntesis.

  2. Seleccione el atributo de usuario que quiera.

  3. Marca la casilla Ejecutar programación como destinatario situada junto al campo Opciones de correo.

Filtros de acceso

Puede limitar los datos a los que puede acceder un usuario con filtros de acceso, que proporcionan seguridad a nivel de fila. Aunque puede usar el parámetro access_grant, los filtros de acceso se implementan y mantienen más fácilmente con atributos de usuario.

Los filtros de acceso proporcionan una forma segura de aplicar restricciones de datos específicas de cada usuario. Si se definen uno o varios filtros de acceso para un Explore de LookML, los datos devueltos por el Explore se filtrarán en función del usuario que ejecute la consulta. Por lo tanto, los filtros de acceso proporcionan una capa adicional de restricción, lo que asegura que el usuario solo pueda ver subconjuntos específicos de los datos de una conexión de base de datos.

Configuración

  1. Crea un atributo de usuario:
    • Configúralo con la opción Acceso de usuario definida como Ninguno (opción recomendada) o Ver. (Un atributo de usuario configurado para que los usuarios puedan editarlo no se puede usar en un filtro de acceso).
    • Asigna valores de atributos de usuario a grupos o usuarios concretos.
  2. En la definición de LookML de la instancia de Explore en la que quieras añadir el filtro de acceso, añade un bloque access_filter con los siguientes parámetros:
    • field: nombre del campo de LookML por el que se va a filtrar.
    • user_attribute: nombre del atributo de usuario que almacena el valor que quiere usar para filtrar los datos.
  3. Ejecuta una consulta en ese Exploración.
  4. Comprueba la cláusula WHERE del SQL de la consulta para verificar que los datos se filtran según el valor que has asignado al atributo de usuario.

Este LookML asegura que las consultas sobre pedidos se filtren por marca, y que la marca concreta se base en el valor asignado al usuario para un atributo de usuario llamado company:

explore: orders {
  view_name: orders
  access_filter: {
    field: products.brand_name
    user_attribute: company
  }
  join: products {
    foreign_key: orders.product_id
  }
}

Conectarse a proveedores de Git

En los proyectos de LookML, puedes configurar la autenticación de Git a través de HTTPS. Los proyectos que usan la autenticación Git HTTPS tienen la opción de aprovechar los atributos de usuario para iniciar sesión en las cuentas de Git de los desarrolladores cuando realizan operaciones de Git para ellos.

Los atributos de usuario de las contraseñas de las cuentas de Git deben estar ocultos. Cuando crees el atributo de contraseña, selecciona Sí en la opción Ocultar valores e introduce la URL del proveedor de Git en el campo Lista de permitidos de dominios.

Controlar el acceso con concesiones de acceso

Puede crear concesiones de acceso que limiten el acceso a una exploración, una unión, una vista o un campo de LookML mediante valores de atributos de usuario, el parámetro access_grant y el parámetro required_access_grants.

Las concesiones de acceso funcionan de la siguiente manera:

  1. Para definir una concesión de acceso, usa el parámetro access_grant. Como parte de la definición, asocias la concesión de acceso a un atributo de usuario. También debe especificar qué valores de atributo de usuario proporcionan acceso a la concesión de acceso.
  2. A continuación, usa el parámetro required_access_grants en el nivel Explorar, Unir, Ver o Campo para restringir esa estructura solo a los usuarios que tengan acceso a todos los permisos de acceso incluidos en la lista.

Por ejemplo, puedes usar una concesión de acceso para limitar el acceso a la dimensión salary solo a los usuarios que tengan el valor payroll en su atributo de usuario department.

Para obtener más información sobre cómo definir las concesiones de acceso, consulta la página de documentación del parámetro access_grant.

Variables de Liquid

LookML permite usar varias variables de Liquid, que pueden ser útiles para tipos de resultados personalizados más complejos. Ahora, los valores de los atributos de un usuario se pueden incluir en Liquid. La expresión Liquid debe usar una sintaxis adecuada para el dialecto de tu base de datos.

Puedes ver ejemplos en la sección Conexión de esta página de documentación y en la página de prácticas recomendadas Usar atributos de usuario para la inyección dinámica de esquemas y nombres de tablas.

Límites de datos de Google BigQuery

Si usa Google BigQuery como base de datos, Google le cobrará por cada consulta en función de su tamaño. Para evitar que los usuarios ejecuten accidentalmente consultas demasiado caras, puedes aplicar un atributo de usuario en el ajuste Máximo de gigabytes facturables de tu conexión de BigQuery. Los valores que proporciones en el atributo de usuario deben ser el número de gigabytes que un usuario puede extraer en una sola consulta.

Paneles de control insertados

Puede limitar los datos que se muestran en Looks y paneles de control insertados basando los valores de los filtros en los valores de los atributos de usuario. Para obtener más información, consulta la publicación de la comunidad Crear una prueba de concepto de un panel de control insertado (con la tecnología de Looker) .

Localización

Los atributos de usuario locale y number_format pueden definir el aspecto de los datos, las visualizaciones y partes de la interfaz de usuario de Looker para usuarios o grupos de usuarios específicos. Para obtener más información, consulta la página de documentación Localizar Looker.

Acceder a endpoints de APIs externas

El framework de extensiones de Looker puede usar los atributos de usuario para acceder a endpoints de APIs externas mediante un proxy de servidor. Para ver un ejemplo, consulta la página de documentación Ejemplos de código de React y JavaScript del framework de extensiones.

Probar atributos de usuario y filtros de acceso

Puedes probar los efectos de tus atributos de usuario con la función sudo de Looker. Los administradores (o los usuarios que tengan los permisos see_users y sudo) pueden usar sudo como otro usuario para ver su experiencia en Looker.

Cuando estás en el modo Desarrollo, los demás usuarios no pueden ver los cambios hasta que implementes los cambios en producción. Si no has implementado los cambios para que los vean otros usuarios, no los verás cuando uses sudo como otro usuario.