--- schema_version: "1" id: f9d4032d6ec20ad7d8cf798648924f47694c6f311ac7652ec6fdf612546607d9 title: Alcances del acceso para aplicaciones conectadas collection: tableau version: next locale: es-es portal_url: https://docs.salesforce.com/tableau/next/es-es/server-linux/connected_apps_scopes.md canonical_url: https://help.tableau.com/v0.0/server-linux/es-es/connected_apps_scopes.htm source_site: help.tableau.com content_type: documentation content_hash: fd783cbea00fd88d8eba927a20df711a1d00a89e3358449954ca54afcdcc0811 description: Reference of access scopes that authorize REST API methods for connected apps via JWT. --- [Saltar al contenido principal](#main-content) # Alcances del acceso para aplicaciones conectadas A partir de Tableau Server 2022.3, con las aplicaciones conectadas de Tableau, puede llamar y acceder mediante programación a la API de REST de Tableau a través de su aplicación personalizada en nombre de los usuarios de Tableau Server. El acceso a la API de REST está habilitado por un JSON Web Token (JWT) definido como parte de la solicitud de inicio de sesión inicial. El JWT debe contener alcances que definan los métodos de la API de REST que están disponibles para su aplicación personalizada y sus usuarios a través de la aplicación conectada. Autorice el acceso a la API de REST usando aplicaciones conectadas para: - Mejore la seguridad: el uso de un JWT como token portador es intrínsecamente más seguro que almacenar y administrar contraseñas de usuarios administradores a través de archivos .env en bóvedas - Mejorar la eficiencia: el uso de un JWT como token de portador permite una suplantación simplificada con una solicitud al punto final de inicio de sesión en lugar de dos solicitudes - Extiender y automatizar integraciones complejas de Tableau y consultas de back-end, como la recuperación de contenido dinámico y el filtrado avanzado. ## Acciones de ámbito Las aplicaciones conectadas usan alcances que otorgan acceso al contenido o acciones administrativas a través de los [Métodos de la API de REST que admiten la autorización JWT](#scopes) (a continuación). Un alcance es una cadena separada por dos puntos que comienza con el espacio de nombres`tableau`, seguido del recurso de Tableau al que se otorga acceso, como `datasources` y finaliza con la acción que está permitida en el recurso, como`update`. Las acciones que un alcance puede tomar incluyen: - `create` - `read` - `run` - `update` - `download` - `delete` Por ejemplo, un alcance que permite que su aplicación personalizada llame al método [Actualizar fuente de datos](https://help.tableau.com/current/api/rest_api/es-es/REST/rest_api_ref_data_sources.htm#update_data_source) se ve así: `tableau:datasources:update` ## Tipos de alcance El tipo de ámbito que utilice depende del contenido o la acción administrativa que desee habilitar. Los ámbitos generalmente se dividen en uno de los siguientes tipos: lectura de contenido, individual, comodín y categoría cruzada. - Ámbito de **lectura de contenido:** el ámbito de lectura de contenido, `tableau:content:read`, habilita los métodos GET admitidos para el contenido de Tableau. Cuando usa este ámbito, habilita acciones en las categorías de API de REST. Más específicamente, al usar este ámbito, habilita métodos GET para fuentes de datos, métricas, vistas, libros de trabajo, proyectos y sitios. A partir de Tableau Server 2023.3, también especificará este alcance en un JWT que se usará para crear un token de credenciales para usar con la [API de metadatos](https://help.tableau.com/current/api/metadata_api/en-us/docs/meta_api_auth.html). A partir de Tableau Server 2025.1, también especificará este alcance en un JWT que se usará para crear un token de credenciales para usar con [VizQL Data Service](https://help.tableau.com/current/api/vizql-data-service/es-es/index.html). **Nota:** Para habilitar métodos GET para acciones administrativas, como usuarios y grupos, puede usar sus ámbitos individuales. - **Ámbitos individuales:** para habilitar el contenido compatible y las acciones administrativas, puede utilizar sus ámbitos individuales. Un ámbito individual generalmente se asocia con un solo método y categoría de API de REST. Ejemplos: - Para habilitar la acción de publicar o actualizar una fuente de datos, puede usar el ámbito individual `tableau:datasources:create` o `tableau:datasources:update`, respectivamente. - Para acciones administrativas como agregar o eliminar usuarios, puede usar los ámbitos `tableau:users:create` o `tableau:users:delete`, respectivamente. **Nota:** Hay algunos ámbitos individuales que pueden habilitar acciones en las categorías de API de REST. Por ejemplo, `tableau:views:download` habilita acciones en las categorías de API de REST de ver datos y libros de trabajo. - **[Ámbitos comodín (\*):](#wildcard)** para ciertos ámbitos, puede reemplazar la acción con el carácter comodín (\*) para habilitar las acciones admitidas dentro de una categoría de API de REST específica. Ejemplos: - Puedes usar el ámbito comodín `tableau:projects:*` para habilitar las acciones de creación, eliminación y actualización en la categoría de API de REST de proyectos. - Puede usar el ámbito comodín `tableau:users:*` para habilitar las acciones de get/list, add, delete y update en la categoría de la API de REST de los usuarios. - Puede usar el ámbito comodín `tableau:tasks:*` para habilitar las acciones get/list, add, delete, update y run en la categoría de la API de REST de los usuarios. Además, este ámbito permite actualizar la fuente de datos (si es una extracción) y actualizar el libro de trabajo. - **[Ámbitos de categorías cruzadas:](#cross)** además del ámbito de lectura de contenido, existen algunos ámbitos adicionales que, si se utilizan, habilitan acciones admitidas en diferentes categorías de API de REST. Ejemplos: - Si usa el ámbito `tableau:tasks:run`, habilita acciones en las fuentes de datos y las categorías de API de REST de libros de trabajo. - Nuevamente, si usa el ámbito `tableau:views:download`, habilita acciones en las categorías de la API de REST de los datos de vista y del libro de trabajo. - Si usa ámbitos de permisos como `tableau:permissions:update` o `tableau:permissions:delete`, habilita acciones en las fuentes de datos, libros de trabajo y categorías de API de REST de proyectos. ## Resumen de cómo autorizar el acceso a la API de REST La siguiente lista resume los pasos para solicitar acceso a la API de REST a través de un JWT: 1. **Cree una aplicación conectada** usando uno de los siguientes métodos: - [Configurar aplicaciones conectadas con confianza directa](https://help.tableau.com/v0.0/server-linux/es-es/connected_apps_direct.htm) - [Configurar aplicaciones conectadas con confianza de OAuth 2.0](https://help.tableau.com/v0.0/server-linux/es-es/connected_apps_eas.htm) 2. **Genere un JWT válido:** en el momento de la ejecución, su aplicación personalizada generará un JWT válido, configurado con los ámbitos que ha incluido 3. **Realizar una solicitud de [inicio de sesión](https://help.tableau.com/current/api/rest_api/es-es/REST/rest_api_ref_authentication.htm#sign_in)**: su aplicación personalizada realizará una solicitud de inicio de sesión mediante el JWT para devolver un token de credenciales de Tableau y un ID de sitio (LUID) 4. **Utilice el token de acceso de Tableau en las solicitudes posteriores**: en las llamadas posteriores a la API de REST, utilice 1) el token de credenciales de Tableau como el valor de encabezado [`X-Tableau-Auth`](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_auth.htm#using_auth_token) y 2) el ID del sitio (LUID) en el URI de la solicitud ### Ejemplo Por ejemplo, suponga que crea una aplicación conectada mediante confianza directa. Al usar la confianza directa, su aplicación personalizada que llama a la API de REST genera un JWT válido usando la identificación del cliente y el secreto del cliente generado por la aplicación conectada. **Alcances en el JWT** Para autorizar correctamente el acceso a la API de REST, el JWT también debe contener los ámbitos que definen las capacidades de la API de REST. Por ejemplo, para habilitar varios métodos relacionados con la fuente de datos, puede incluir los siguientes ámbitos en el JWT: `"tableau:content:read","tableau:datasources:create","tableau:datasources:update","tableau:datasources:download","tableau:tasks:run"` O `"tableau:content:read","tableau:datasources:*","tableau:tasks:run"` **Nota:** Los valores de alcance deben pasarse como un tipo de lista. **URI de solicitud de inicio de sesión** Para realizar una llamada a la API de REST, su aplicación personalizada primero debe realizar una solicitud de inicio de sesión para generar un token de credenciales de Tableau. ``` POST https://myco/api/3.17/auth/signin ``` **Cuerpo de la solicitud** Para autorizar el acceso a la API de REST mediante un JWT, el cuerpo de la solicitud de inicio de sesión debe contener el JWT válido, como en el ejemplo siguiente. ``` ``` **Cuerpo de respuesta** La solicitud de inicio de sesión produce el siguiente cuerpo de respuesta, que incluye el token de credenciales de Tableau. ``` ``` Después de generar el token de credenciales de Tableau, debe agregarlo al encabezado de todas las solicitudes posteriores de la API de REST. **Encabezado** X-Tableau-Auth:12ab34cd56ef78ab90cd12ef34ab56cd Todas las solicitudes posteriores de la API de REST que usan el token de acceso de Tableau quedan delimitadas por los ámbitos en el JWT. ## Métodos de la API de REST que admiten la autorización JWT Alcances de las aplicaciones conectadas otorga a su aplicación personalizada acceso a las capacidades de la API de REST de Tableau en nombre de los usuarios ### Encontrar ámbitos Puede encontrar el alcance requerido para un método compatible con JWT en su bloque de propiedades en la ayuda de la [API de REST de Tableau](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api.htm). Si un alcance no aparece en el bloque de propiedades del método, el acceso a ese método no puede ser controlado por un JWT. Por ejemplo, un ámbito que le permite llamar al método [Query Site](https://help.tableau.com/current/api/rest_api/es-es/REST/rest_api_ref_site.htm#query_site) en la API de REST de Tableau es. `tableau:sites:read` **Notas:** - Los métodos [Iniciar sesión](https://help.tableau.com/current/api/rest_api/es-es/REST/rest_api_ref_authentication.htm#sign_in) y [Cerrar sesión](https://help.tableau.com/current/api/rest_api/es-es/REST/rest_api_ref_authentication.htm#sign_out) son compatibles con la autorización JWT, pero no requieren alcances para su uso a partir de Tableau Server 2023.3. - Para los alcances compatibles con la API de inserción v3, consulte uno de los siguientes: - [Configurar aplicaciones conectadas con confianza directa](https://help.tableau.com/v0.0/server-linux/es-es/connected_apps_direct.htm) - [Configurar aplicaciones conectadas con confianza de OAuth 2.0](https://help.tableau.com/v0.0/server-linux/es-es/connected_apps_eas.htm) - A partir de Tableau Server 2025.3, un subconjunto de los ámbitos enumerados también admite la autorización de API de REST a través de tokens de acceso unificado (UAT). Esto significa que las aplicaciones conectadas y los ámbitos UAT son los mismos. ### Tipo de ámbitos #### Acerca de los ámbitos comodín (\*) Los ámbitos comodín utilizan el carácter comodín (\*) en lugar de una acción específica, para habilitar múltiples acciones admitidas dentro de una categoría de API de REST de Tableau específica. #### Ejemplos
ÁmbitoMétodos habilitados
tableau:datasources:*Permite crear, actualizar y actualizar métodos de fuente de datos de conexión.
tableau:metrics:*Habilita las acciones de consulta, actualización y eliminación de métricas.
tableau:workbooks:*Permite publicar, actualizar, descargar y obtener una vista previa de las acciones del libro de trabajo de imágenes.
tableau:groups:*Permite crear, consultar, actualizar y eliminar acciones de grupos.
tableau:projects:*Permite crear, eliminar y actualizar métodos de proyectos.
tableau:users:*Permite obtener/enumerar, agregar, eliminar y actualizar métodos de usuarios.
tableau:tasks:*

Nota: Este ámbito también es multicategoría.

Permite obtener/enumerar, agregar, eliminar, actualizar y ejecutar métodos para extracciones y tareas de suscripción.

Habilita métodos de actualización para fuentes de datos para libros de trabajo.

#### Acerca de los ámbitos entre categorías Los ámbitos entre categorías permiten múltiples acciones admitidas en múltiples categorías de API de REST de Tableau. #### Ejemplos
ÁmbitoMétodos habilitados
tableau:content:readHabilita métodos de lectura/lista para contenido de Tableau, incluidas fuentes de datos, métricas, vistas, libros de trabajo, proyectos y sitios.
tableau:tasks:runHabilita métodos de ejecución para fuentes de datos, libros de trabajo y extracciones.
tableau:views:downloadHabilita métodos de descarga para ver datos y libros de trabajo.
tableau:tasks:*

Nota: Este ámbito también es un comodín.

Permite obtener/enumerar, agregar, eliminar, actualizar y ejecutar métodos para extracciones y tareas de suscripción.

Habilita métodos de actualización para fuentes de datos para libros de trabajo.

## Solucionar problemas de alcances ### 401001: error de inicio de sesión Si encuentra el error 401001, el cuerpo de la respuesta **de inicio de sesión** se adjunta con uno de los siguientes códigos de error adicionales específicos de las aplicaciones conectadas: 16, 10084 o 10085. Por ejemplo, en el siguiente cuerpo de respuesta, "10084" es el código de error de las aplicaciones conectadas que puede usar para ayudar a solucionar problemas al iniciar sesión en Tableau Server utilizando un JWT para la autorización de la API de REST. "summary": "Signin Error", "detail": "Error signing in to Tableau Cloud (10084)" Para ayudar a resolver el problema, consulte la descripción del código de error aplicable y sus posibles causas. - **16: No se pudo encontrar el usuario**. Este error puede ocurrir porque se ha indicado un valor de "`sub` " (nombre de usuario) incorrecto - **10084: No se pudo analizar el token de acceso**. Este error puede ocurrir por las siguientes razones: - El JWT no es válido o se produjo un problema inesperado - Se ha especificado un valor de "`aud` "(audiencia) incorrecto - Para la confianza directa, se produjo un problema con la firma del secreto. - **10085: No se pudo obtener el secreto para verificar la firma del ID del cliente**. Este error puede ocurrir por las siguientes razones: - Se ha especificado un ID de cliente incorrecto en "`iss`" - Por confianza directa, se ha especificado un valor de "`kid`" (ID secreto) incorrecto - Para en EAS, no se pueden obtener claves de JWKSource ### 401002: error de acceso no autorizado Si encuentra el error 401002 y ha confirmado que tiene los permisos adecuados para realizar la solicitud, asegúrese de que el alcance incluido en el JWT sea correcto y coincida con la solicitud que está intentando realizar. Para obtener una lista de puntos finales y alcances admitidos, consulte la sección anterior [Métodos de la API de REST que admiten la autorización JWT](#scopes).