Configuración del administrador: Atributos del usuario

Los atributos de usuario proporcionan una experiencia personalizada para cada usuario de Looker. Un administrador de Looker define un atributo de usuario y, luego, aplica un valor de atributo de usuario a un grupo de usuarios o a usuarios individuales.

Los administradores también pueden definir atributos de los usuarios para los cuales los mismos usuarios proporcionan valores, como contraseñas o información de contacto. Varios lugares de Looker pueden hacer referencia a los atributos del usuario para brindar una experiencia personalizada a cada uno de ellos.

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

Visualiza los atributos de usuario

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

La tabla de atributos de usuario proporciona el nombre, la etiqueta y el tipo de cada atributo de usuario (consulta la siguiente sección para obtener más información). Además, la tabla incluye un botón con las acciones que puedes realizar para el atributo de usuario. Algunos atributos muestran "Predeterminado del sistema" en lugar de un botón para acciones, 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.

Crea atributos de usuario

Para definir un atributo de usuario, haz clic en el botón Crear atributo de usuario de la página Atributos de usuario en la sección Usuarios del menú Administrador. Cada atributo de usuario tiene la siguiente configuración:

  • Nombre: Es el nombre del atributo de usuario para usar en entornos basados en texto como LookML (los nombres solo pueden contener letras minúsculas, números y guiones bajos).
  • Etiqueta: La versión del nombre fácil de usar De forma predeterminada, este será el nombre del atributo, con guiones bajos reemplazados por espacios y cada palabra en mayúscula. Sin embargo, la etiqueta se puede modificar como se desee.
  • Tipo de datos: Este parámetro de configuración se utiliza para verificar que se asignen 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:

    • String: Selecciona esta opción para crear un atributo de usuario que coincida exactamente con un valor de cadena, como un nombre de usuario. Si quieres usar varios valores de cadena o una expresión de filtro de Looker en el valor del atributo de usuario, selecciona la opción Filtro de cadenas (avanzado).
    • Número: Selecciona esta opción para especificar un solo número, como el número de empleados. Para usar un rango de números o una expresión de filtro de Looker, usa el Filtro de números (avanzado) en su lugar.
    • Fecha/hora: Selecciona esta opción para especificar una sola hora o fecha, como la fecha de nacimiento del usuario. Para usar un rango de fechas o una expresión de filtro de Looker, usa el Filtro de fecha/hora (avanzado) en su lugar.
    • URL relativa: Selecciona esta opción para especificar una URL relativa, como /browse/boards/2, que apunte a contenido específico como un tablero, una carpeta o un archivo de Markdown (como un archivo README o de documento en un proyecto) en tu instancia de Looker. Por ejemplo, el atributo de usuario landing_page tiene un tipo de datos de URL relativa y se puede usar para especificar una página principal específica para un usuario o grupo.
    • Filtro de cadenas (avanzado): Selecciona esta opción para permitir múltiples valores de cadenas o una expresión de filtro de Looker en el atributo de usuario. Consulta la página de documentación de Expresiones de filtro para obtener una lista de expresiones de filtro que puedes usar para cadenas.
    • Filtro de números (avanzado): Selecciona esta opción para permitir un rango de valores numéricos o una expresión de filtro de Looker en el atributo de usuario. Consulta la página de documentación de Expresiones de filtro para obtener una lista de expresiones de filtro que puedes usar para números.
    • Filtro de fecha/hora (avanzado): Selecciona esta opción para permitir un rango de fechas o una expresión de filtro de Looker en el atributo de usuario. Consulta la página de documentación de Expresiones de filtro para obtener una lista de expresiones de filtro que puedes usar para la fecha y la hora.

    Usa los tipos de datos Filtro de cadenas (avanzado), Filtro de números (avanzado) y Filtro de fecha/hora (avanzado) para ingresar valores con las expresiones de filtro de Looker, que mostrarán un rango de valores para un atributo de usuario.

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

    • Ninguna: No aparecerá en las páginas de la cuenta de los usuarios.
    • Ver: Aparecerá en las páginas de la cuenta de los usuarios, pero no podrá editarse.
    • Editar: Aparecerá en las páginas de la cuenta de los usuarios y el usuario puede configurarla.
  • Ocultar valores: Incluso si los atributos de usuario son visibles para el usuario, si estableces esta opción en , los valores de los atributos de usuario se enmascararán, lo que es útil para contraseñas y otra información sensible. Si estableces este valor en Yes, también se ocultará el valor del atributo de usuario en los menús desplegables de este atributo en la página Configuración de conexión. Cuando este valor se establece en Yes, no se puede volver a cambiar a No. Cuando configuras Hide Values en Yes, también debes especificar una lista de entidades permitidas de los dominios que se permiten como destino para el atributo de usuario.

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

    Una vez que hayas especificado la lista de dominios permitidos para este atributo de usuario, si al atributo se le asignó algún valor (para un usuario, un grupo o estableciendo un valor predeterminado), no podrás cambiar la lista de entidades permitidas para que las URLs sean menos restrictivas. Solo puedes hacer que las URLs sean más restrictivas o quitarlas de la lista de entidades permitidas. Por ejemplo, si la lista de entidades permitidas del dominio incluye una entrada my_domain/route/*, no podrás cambiarla más adelante a my_domain/*. Si necesitas que la lista de entidades permitidas sea menos restrictiva, borra todos los valores existentes asignados al atributo de usuario, incluidos los valores predeterminados.

  • Establecer un valor predeterminado: Selecciona esta casilla de verificación para establecer un valor predeterminado en caso de que no se asigne un valor a un usuario.

Tras definir un atributo de usuario, podrás asignar valores a usuarios individuales o a grupos de usuarios haciendo clic en las pestañas Valores del usuario y Valores del grupo de la página.

Asignar valores a usuarios individuales

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

  1. Haz clic en la pestaña Valores del usuario de la página Atributos de usuario en la sección Usuarios del menú Administrador.
  2. Elige el usuario para asignarle un valor en el menú desplegable. Esto muestra una tabla de valores que se aplican a ese usuario.
  3. Haz clic en el botón Establecer valor para el usuario.
  4. Ingresa el valor nuevo en el campo Valor nuevo.
  5. Haz clic en Guardar.

Cuando se asigna un valor a un usuario individual, ese valor siempre tiene prioridad sobre los valores asignados a los grupos de ese usuario. La pestaña Valores del usuario muestra cuándo se asignó un valor personalizado a un atributo de usuario que anula un valor de grupo. El texto "Anulado" aparecerá junto a los valores anulados, 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 string (avanzado) y, luego, ingresa varios valores separados por comas. Asegúrate de que no haya espacios en blanco entre los valores. Por ejemplo, puedes ingresar la cadena: Executive, Management, Contributors.

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

  • Para otorgarle a un administrador o a otro usuario acceso a todos los valores de un campo de cadena, establece el tipo de datos del atributo de usuario en Filtro de cadena (avanzado) y usa un valor de %, NULL.

  • Para otorgarle a un administrador o a otro usuario acceso a todos los valores de un campo numérico, establece el tipo de datos del atributo de usuario en Filtro de números (avanzado) y usa un valor de <0, >=0, NULL.

Asigna valores a grupos de usuarios

Se puede asignar un valor para un atributo de usuario a un grupo de usuarios. En la página Atributos de usuario del panel Administrador, selecciona Editar a la derecha del atributo que deseas establecer. Luego, sigue estos pasos:

  1. Haz clic en la pestaña Valores del grupo.
  2. Haz clic en el botón + Agregar grupo.
  3. Elige el grupo al que deseas asignar un valor en el menú desplegable.
  4. Ingresa el valor que tendrá el grupo en el campo Valor.
  5. Haz clic en Guardar.

Cuando se asigna un valor a varios grupos, debes decidir cuál de ellos debe tener prioridad en caso de que un usuario pertenezca a varios grupos. Para ello, arrastra los grupos en el orden en que deberían aplicarse; cada grupo tiene prioridad sobre los grupos que aparecen debajo.

Por ejemplo, puedes tener grupos de equipo ejecutivo y equipo directivo. Los ejecutivos también son administradores, de modo que son miembros de ambos grupos. Arrastrar el grupo Equipo ejecutivo a la parte superior de la lista garantizará que a sus miembros se les asigne el valor Ejecutivo en lugar del valor Gerente.

Si un usuario estableció un valor personalizado para un atributo de usuario, el valor que establezca 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 base 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 recibir el valor de un atributo de usuario. (El campo de host de conexión no aceptará un atributo de usuario que tenga el nivel de Acceso de usuario establecido como Editable).

Estos atributos de usuario hacen que la conexión sea específica para el usuario que ejecuta una consulta. También se puede hacer referencia a los atributos de usuario en el campo Parámetros adicionales de JDBC, que personaliza la cadena de conexión de 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 en la página Conexiones de la sección Administrador de Looker. (Consulta la página de documentación Configuración del administrador: Conexiones para obtener más información sobre la página Conexiones). Para crear una conexión nueva, haz clic en Agregar conexión. Para configurar una conexión existente, haz clic en Editar junto a la conexión.

Si una entrada se puede establecer como un atributo de usuario, Looker mostrará el botón Atributo de usuario junto a la de entrada.

Haz clic en el botón Atributo de usuario para mostrar un menú desplegable que te permite elegir el atributo de usuario deseado. La lista muestra el nombre del atributo de usuario con el valor del atributo de usuario actual entre paréntesis.

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

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

Caso de uso: Aplicación de permisos a nivel de la base de datos en Looker

Si tu base de datos tiene diferentes cuentas con varias restricciones de acceso, puedes aprovechar los permisos de la base de datos en Looker. Parametriza el nombre de usuario y la contraseña de una conexión, de modo que cada usuario se conecte con las credenciales adecuadas para su nivel de acceso a la base de datos. Si bien esto garantiza que los usuarios no vean los datos a los que no deberían tener acceso, esto no afectará las exploraciones, las dimensiones y las medidas que se les muestran 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 use esa columna de base de datos aún se mostrará en Looker. Reciben un error de la base de datos si intentan ejecutar una consulta que incluya esa dimensión.

Caso de uso: Usar un modelo para múltiples bases de datos idénticas

Digamos que tienes varias bases de datos con exactamente el mismo esquema, como cuando los datos de cada cliente están aislados en su propia base de datos para las medidas de seguridad de los datos (como el cumplimiento de la HIPAA). O tal vez 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 base de datos, no es necesario configurar conexiones y modelos separados. En su lugar, configura la base de datos de una conexión a un atributo de usuario, y se dirigirá a cada usuario a la base de datos especificada en su valor para el atributo de usuario Database Name.

Acciones de datos

Las acciones de datos se pueden configurar para incluir ciertos atributos de usuario con su carga útil de 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 en particular.

Configuración

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

  • user_attribute: Es el nombre del atributo de usuario.
  • name: Es el nombre que se usará en la carga útil de JSON.

En este ejemplo, se usan dos atributos de usuario, salesforce_username y salesforce_password, para conservar las credenciales de Salesforce de cada usuario en Looker. Cuando un usuario realiza la acción de Actualizar en los datos de Salesforce, Looker envía sus credenciales de Salesforce con la carga útil 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

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

Configuración

El parámetro params en una acción personalizada representa los campos del formulario que debe configurar un administrador de Looker en la página de habilitación de la acción en la lista Acciones del panel Administrador. En el parámetro params de tu archivo de acción, incluye 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 en la sección Usuarios del panel Administrador, 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 cuando se entregan datos, y sensitive: true significa que el valor del atributo de usuario está encriptado y nunca se muestra en la IU de Looker una vez que se ingresa. Puedes especificar varios subparámetros de los atributos de usuario.

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

  1. Haz clic en el botón Habilitar o Configuración junto a la acción en la página Acciones del panel Administrador.
  2. Haz clic en el ícono de atributo de usuario para el campo correspondiente y selecciona el atributo de usuario deseado.

Consulta la sección Cómo agregar atributos de usuario a las acciones personalizadas de la página de documentación Cómo compartir datos a través de un centro de acciones.

Filtros

Los filtros de Exploraciones, Vistas y Paneles se pueden configurar en un atributo de usuario para personalizar la consulta en función del usuario que la ejecuta.

Por ejemplo, puedes 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. Luego, podrías configurar un filtro en un panel para el atributo de usuario salesforce_username y cada usuario verá ese panel filtrado por su nombre de usuario de Salesforce específico.

Configuración

En la sección FILTROS de una exploración, una vista o un panel, haz lo siguiente:

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

    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, como número, cadena (texto), fecha, etcétera. Looker muestra el valor de cada atributo de usuario entre paréntesis.

  2. Selecciona el atributo de usuario deseado.

Sintaxis de filtros avanzados

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

{{ _user_attributes['name_of_attribute'] }}

Por ejemplo, supongamos que debes aplicar un prefijo sf_ al valor del atributo de usuario salesforce_username, ya que así es como se almacenan los valores en tu base de datos. Para agregar el prefijo al valor del atributo de usuario, usa la sintaxis de la variable líquida _user_attributes:


sf_{{_user_attributes['salesforce_username']}}

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

Paneles y vistas programados

Los filtros de Panel y Vista se pueden configurar por programa, incluida la opción de usar un atributo de usuario. Esto te permite personalizar los resultados de la entrega de datos para cada destinatario de correo electrónico. Puedes personalizar las entregas de contenido que se envían como entregas únicas y recurrentes.

Por ejemplo, puedes crear un atributo de usuario llamado salesforce_username y establecer el valor del nombre de usuario de Salesforce de cada usuario. Establece un filtro en un panel o una programación de vistas para el atributo de usuario salesforce_username, de manera que cada destinatario obtenga ese panel filtrado por su nombre de usuario de Salesforce.

Requisitos previos

Solo los usuarios de Looker tienen configurados valores de atributos de usuario, por lo que cada destinatario de la entrega de datos debe tener una cuenta de Looker. Para aplicar los atributos de usuario, se debe ejecutar el panel o una vista una vez para cada destinatario.

Configuración

Abre el programador de la vista o el panel:

  1. En la sección Filtros, selecciona la opción coincide con un atributo de usuario en el filtro deseado.

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

  2. Selecciona el atributo de usuario deseado.

  3. Marca la casilla de verificación de ejecutar programación como destinatario junto al campo Opciones de correo electrónico.

Filtros de acceso

Puedes limitar los datos a los que puede acceder un usuario con filtros de acceso, que proporcionan seguridad a nivel de fila. Si bien puedes usar el parámetro access_grant, los filtros de acceso se implementan y mantienen con mayor facilidad con los atributos de usuario.

Los filtros de acceso proporcionan una forma segura de aplicar restricciones de datos específicas del usuario. Definir uno o más filtros de acceso para una exploración de LookML exige que los datos que se muestran de una exploración se filtren en función del usuario que ejecuta la consulta. Por lo tanto, los filtros de acceso proporcionan una capa adicional de restricción, lo que garantiza que el usuario solo pueda ver subconjuntos específicos de datos desde una conexión de base de datos.

Configuración

  1. Crea un atributo de usuario:
    • Realiza la configuración con la opción Acceso de los usuarios establecida en Ninguno (recomendado) o Ver. (Un atributo de usuario configurado para que los usuarios lo puedan editar no se puede usar para un filtro de acceso).
    • Asigna valores de atributos de usuario a grupos o usuarios individuales.
  2. En la definición de LookML para la exploración en la que deseas el filtro de acceso, agrega un bloque access_filter con los siguientes parámetros:
    • field: Es el nombre del campo de LookML en el que se filtrará
    • user_attribute: Es el nombre del atributo de usuario que almacena el valor que deseas usar para filtrar los datos.
  3. Ejecuta una consulta en esa exploración.
  4. Revisa la cláusula WHERE del SQL de la consulta para comprobar que los datos se filtren según tu valor para el atributo de usuario.

Este LookML garantiza que las consultas sobre pedidos se filtren por marca, de modo que la marca específica se basa en el valor asignado del 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
  }
}

Conéctate a proveedores de Git

Para los proyectos de LookML, puedes configurar la autenticación de Git mediante HTTPS. Los proyectos que usan la autenticación HTTPS de Git, tienen la opción de aprovechar los atributos del usuario para acceder a las cuentas de Git de los desarrolladores individuales cuando realizan operaciones de Git para el desarrollador.

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

Controla el acceso mediante otorgamientos de acceso

Puedes crear otorgamientos de acceso que limiten el acceso a una exploración, unión, vista o campo de LookML mediante los valores de los atributos de usuario, los parámetros access_grant y required_access_grants.

Las concesiones de acceso funcionan de la siguiente manera:

  1. Puedes definir un otorgamiento de acceso con el parámetro access_grant. Como parte de la definición, debes asociar el otorgamiento de acceso con un atributo de usuario. También debes especificar qué valores de atributos de usuario proporcionarán acceso a la concesión de acceso.
  2. Luego, usa el parámetro required_access_grants a nivel de Explorar, join, Vista o campo para restringir esa estructura solo a los usuarios que tengan acceso a todas las concesiones de acceso enumeradas.

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

Si deseas obtener más información para definir otorgamientos de acceso, consulta la página de documentación del parámetro access_grant.

Variables líquidas

LookML habilita el uso de varias variables líquidas diferentes, que pueden ser útiles para tipos de resultados personalizados más complejos. Los valores de atributos de un usuario ahora se pueden incluir en Liquid.

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 Cómo usar los atributos de usuario para el esquema dinámico y la inserción de nombres de tablas.

Límites de datos de Google BigQuery

Si usas Google BigQuery como base de datos, Google te cobrará por cada consulta según el tamaño de la consulta. Para evitar que los usuarios ejecuten accidentalmente una consulta demasiado costosa, puedes aplicar un atributo de usuario en el parámetro de configuración Máx. de facturación de gigabytes en tu conexión de BigQuery. Los valores que proporciones en el atributo de usuario deben ser la cantidad de gigabytes que un usuario puede extraer en una sola consulta.

Paneles incorporados

Para limitar los datos que se muestran en las vistas y los paneles incorporados, puedes basar los valores de filtro en los valores de los atributos del usuario. Para obtener más información, consulta la publicación de Comunidad Crea un panel incorporado de prueba de concepto (con la tecnología de Looker) .

Localización

Los atributos de usuario locale y number_format pueden configurar el aspecto de los datos, las visualizaciones y las partes de la interfaz de usuario de Looker para usuarios o grupos de usuarios específicos. Consulta la página de documentación sobre Cómo localizar Looker para obtener más información.

Prueba los atributos de usuario y los filtros de acceso

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

Cuando estás en Modo de desarrollo, los cambios no son visibles para otros usuarios hasta que implementas los cambios en producción. Si no implementaste los cambios para que otros usuarios puedan verlos, no los verás cuando uses la identidad de otro usuario.