Fuente de datos Tokens

Los tokens contienen información sobre los tokens de usuario activos y vigentes del sitio, incluidos los tokens de acceso personal (PAT), los de actualización y los de OAuth. Los administradores del sitio pueden supervisar el uso y el vencimiento de los tokens a través de la fuente de datos, rotando los tokens esenciales según sea necesario.

Los siguientes tokens están incluidos en la fuente de datos:

  • Base de datos OAuth: administrar los tokens de acceso utilizados para las conexiones OAuth. Los tokens son válidos hasta que un usuario de Tableau Cloud los elimine o hasta que un proveedor de datos lo revoque. Para obtener más información, consulte Conexiones OAuth.

  • Cliente OAuth: administre los tokens de actualización utilizados por los clientes conectados, como Tableau Desktop y Tableau Prep. Para obtener más información, consulte Acceder a los sitios desde clientes conectados.

  • Tokens de acceso personal (PAT): administrar los tokens de autenticación de larga duración que se utilizan para iniciar sesión en Tableau Cloud, como scripts y tareas automatizados que se crean con la API de REST de Tableau. Para obtener más información, consulte Tokens de acceso personal.

En cualquier momento, los administradores del sitio pueden revocar rápidamente un token quitando la licencia a un usuario que tenga el token no deseado. Con la advertencia de que se deben crear nuevos tokens cuando se vuelve a obtener la licencia del usuario. Para conocer los pasos para eliminar o revocar tipos específicos de tokens, siga los enlaces de la sección anterior.

Crear vistas personalizadas

Si es un administrador del sitio o un usuario con acceso al proyecto Admin Insights, puede acceder a las fuentes de datos de Admin Insights directamente desde Tableau Cloud usando la creación web o a través de Tableau Desktop para crear vistas personalizadas. Para obtener más información sobre cómo conectarse a fuentes de datos de Información de administración, consulte Utilizar Admin Insights para crear vistas personalizadas.

Ejemplo: ¿Cuándo se actualizaron por última vez los tokens de la base de datos OAuth?

Utilice los siguientes pasos para crear una vista que mida cuándo se actualizaron por última vez los tokens de la base de datos OAuth y el cumplimiento de la rotación de tokens dentro de una organización.

  1. Conéctese a la fuente de datos Tokens mediante uno de los procedimientos indicados en Fuente de datos Tokens.

  2. Desde el panel Datos, arrastre Tipo de token al estante Filtro. Seleccione la casilla de verificación Base de datos OAuth y haga clic en Aceptar.

  3. Arrastre Tipo de base de datos, Nombre de usuario de la base de datos, y Última actualización hasta el estante Filas.

  4. En el estante Filas, haga clic con el botón derecho en Última actualización y seleccione Fecha exacta desde el menú contextual. Cambie el campo de continuo a discreto.

  5. En el menú, seleccione Análisis > Crear campo calculado.

    1. Nombre: Días desde la última actualización

    2. Cálculo:

      ROUND(TODAY()-[Last Updated])
  6. Haga clic en Aceptar.

  7. Desde el panel Datos, arrastre Días desde la última actualización hasta el estante Filas. Cambie el campo de continuo a discreto.

Ejemplo: ¿Cuándo caducan los tokens de base de datos OAuth integrados?

Para evitar interrupciones como errores de carga de vistas y actualizaciones de extracciones fallidas, es importante supervisar la caducidad de los tokens de bases de datos OAuth integrados. Use estos pasos para crear una vista que identifique los tokens cerca de su vencimiento, lo que permite a los usuarios actualizar sus credenciales de forma proactiva.

Nota: Tableau no almacena tiempos de vencimiento para los tokens de bases de datos de OAuth. Para obtener esta información, comuníquese con el administrador de su base de datos para verificar los detalles de vencimiento para cada tipo de base de datos.

  1. Conéctese a la fuente de datos Tokens.

  2. Desde el panel Datos, arrastre Tipo de token al estante Filtro. Seleccione la casilla de verificación Base de datos OAuth y haga clic en Aceptar.

  3. Arrastre Tipo de base de datos y Correo electrónico del propietario al estante Filas.

  4. En el menú, seleccione Análisis > Crear campo calculado. En este ejemplo, utilizamos una base de datos Snowflake con un período de vencimiento de 90 días.

    1. Nombre: Expires At (all tokens)

    2. Cálculo:

      IF [Token Type] = 'OAuth Database'
      THEN
      IF [Database Type] = 'snowflake'
      THEN DATEADD('day', 90, [Last Updated])
      // add conditions for other database types here //
      ELSE NULL
      END
      ELSE [Expires At]
      END
  5. En el menú, seleccione Análisis > Crear campo calculado.

    1. Nombre: Days Until Expiration

    2. Cálculo:

      DATEDIFF('day', TODAY(), [Expires At (all tokens)])
  6. Arrastre Días hasta el vencimiento al estante Filas. Cambie el campo de continuo a discreto.

  7. Arrastre Días hasta el vencimiento al estante Filtros. Seleccione Todos los valores, estableciendo el Máximo en 14. Esto filtra los tokens que vencen en los próximos 14 días o los que ya vencieron. Ajuste según sea necesario.

  8. Utilice los valores resultantes para ponerse en contacto con los usuarios cuyos tokens caducan pronto.

Ejemplo: ¿Qué usuarios poseen PAT en el sitio?

El siguiente ejemplo muestra los nombres y roles en el sitio de los usuarios que poseen PAT en el sitio. Puede ajustar el filtro para otros tipos de tokens.

  1. Conéctese a las fuentes de datos Tokens y Usuarios de TS.

  2. Seleccione Datos > Editar relaciones de combinación

  3. En el cuadro de diálogo Combinar relaciones, establezca la fuente de datos primaria como Tokens y seleccione el botón de selección Personalizado.

  4. Haga clic en Añadir.

  5. En el cuadro de diálogo Agregar/Editar mapeo de campos, asigne Correo electrónico del propietario a Correo electrónico del usuario y haga clic en Aceptar > Aceptar.

  6. Desde el panel Datos, arrastre Tipo de token al estante Filtro. Seleccione la casilla de verificación PAT y haga clic en Aceptar.

  7. Desde el panel Datos, arrastre Nombre de usuario, Rol en el sitio del usuario, Vence en y Usado por última vez en hasta el estante Filas.

  8. Compruebe que Correo electrónico del usuario es el campo de enlace en el panel Datos. Si hay algún enlace roto, haga clic en el icono situado junto al nombre del campo para vincular las dos fuentes de datos.
  9. En el estante Filas, haga clic con el botón derecho en Vence en y seleccione Fecha exacta desde el menú contextual. Cambie el campo de continuo a discreto.

  10. Repita el paso 7 para Usado por última vez en.

Haga más con sus datos

Con Tableau Prep, puede unir fuentes de datos de Información de administración en los siguientes campos para obtener más visibilidad en su sitio. Si está analizando datos de varios sitios de Tableau Cloud, también debe unirse con "Site LUID = Site LUID".

  • Para ver el rol en el sitio del propietario del token, una Tokens a Usuarios de TS en "Correo electrónico del propietario" = "Correo electrónico del usuario"

  • Para ver la membresía del grupo del propietario del token, una Tokens a Grupos en "Correo electrónico del propietario" = "Correo electrónico del usuario"

Para obtener más información, consulte Agregar datos y unir filas o columnas(El enlace se abre en una ventana nueva) en la Ayuda de Tableau Prep.

Esquema de fechas

La siguiente tabla enumera los campos incluidos en la fuente de datos Tokens. Cada fila de datos corresponde a una combinación de ID de token y correo electrónico del propietario.

CarpetaNombre de campoTipoDescripción
Base de datosID de clave de recursoNuméricoID de la entrada de la base de datos. Se aplica a los tokens de base de datos OAuth.
Tipo de base de datosCadenaEl tipo de base de datos, por ejemplo, Salesforce, Snowflake, etc. Se aplica a los tokens de base de datos OAuth.
Nombre de usuario de la base de datosCadenaNombre del usuario que se conecta a la base de datos. Se aplica a los tokens de base de datos OAuth.
URL de instanciaCadenaLa URL de instancia para el proveedor de datos, por ejemplo, https://login.salesforce.com. Se aplica a los tokens de base de datos OAuth.
Última actualizaciónFecha-horaFecha y hora en que se cambiaron por última vez las credenciales de la fuente de datos en UTC. Se aplica a los tokens de base de datos OAuth.
DispositivosID de dispositivoCadenaID del cliente conectado asociado al token. Se aplica a los tokens de cliente OAuth.
Nombre del dispositivoCadenaNombre del cliente conectado asociado al token. Se aplica a los tokens de cliente OAuth.
SitioLUID del sitioCadenaEl LUID del sitio de Tableau Cloud. Se utiliza principalmente para hacer referencia a contenido a través de la API de REST.
Nombre del sitioCadenaNombre del sitio de Tableau Cloud.
TokenCaduca elFecha-horaFecha y hora en que vence el token en UTC. Se aplica a los tokens de cliente PAT y OAuth.
GUIDCadenaID único del token. Se aplica a los tokens de cliente PAT y OAuth.
Emitido elFecha-horaFecha y hora en que se emitió el token en UTC.
Última utilizaciónFecha-horaFecha y hora en que se utilizó el token por última vez en UTC. Se aplica a los tokens de cliente PAT y OAuth.
Correo electrónico del propietarioCadenaDirección de correo electrónico del propietario del token.
El nombre del PATCadenaNombre del token de acceso personal. Se aplica a PAT.
Identificador de tokenCadenaIdentifica de forma única una fila de datos utilizando el GUID para los tokens de cliente PAT y OAuth y el ID de clave de recurso para los tokens de base de datos OAuth.
Tipo de tokenCadenaUn valor enumerado para el tipo de token. Token de acceso personal (PAT), cliente OAuth o base de datos OAuth.
-Información de administración publicada elFecha-horaFecha y hora en que se publicó por última vez la fuente de datos de Información de administración en UTC.