> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Smartsheet

> Conecta Smartsheet a Iru Compliance con un token de acceso a la API de solo lectura para recopilar el inventario de usuarios y licencias, los permisos de uso compartido de hojas y la membresía de espacios de trabajo.

### Acerca de Smartsheet

Iru lee **usuarios con sus tipos de licencia**, **hojas con sus permisos de uso compartido**, **espacios de trabajo con el acceso de sus miembros** y **grupos** desde la API de Smartsheet. La autenticación usa un **token de acceso a la API** generado en **Cuenta** → **Personal Settings** → **API Access**. Las solicitudes se dirigen a `https://api.smartsheet.com/2.0`; no hay ningún subdominio que configurar.

Iru lee la **configuración de uso compartido y acceso**, no el contenido de las hojas. Recopila con quién se comparte cada hoja, no los datos de las celdas.

### Cómo funciona

```http theme={null}
Authorization: Bearer YOUR_ACCESS_TOKEN
```

Smartsheet se autentica con un token **Bearer**. Los tokens se generan por usuario y tienen el **acceso efectivo** de ese usuario, sin alcances independientes por endpoint. Las hojas y los espacios de trabajo se comparten de forma individual, por lo que un token de un usuario que no es miembro de un espacio de trabajo no devuelve nada para él. Iru no puede distinguir eso de un espacio de trabajo que no tiene uso compartido que informar.

Genera el token desde una cuenta **System Admin** para obtener el inventario de usuarios y licencias más completo.

| Detalle | Valor |
| - | - |
| **Categoría** | Gestión de proyectos |
| **Autenticación** | Bearer (token de acceso a la API) |

Referencias oficiales: [API overview](https://smartsheet.redoc.ly/), [Authentication and access tokens](https://smartsheet.redoc.ly/#section/Security/Authentication-and-Access-Tokens).

### Requisitos previos

* Una cuenta que pueda generar un token de acceso a la API. Es preferible **System Admin** para que el inventario de usuarios y licencias esté completo.
* Acceso a cada espacio de trabajo del que esperas obtener evidencia. El acceso en Smartsheet es por objeto.
* Decide qué espacios de trabajo están dentro del alcance. Los espacios de trabajo excluidos no generan evidencia.

### Conectar Smartsheet a Iru

<Tabs>
  <Tab title="Smartsheet">
    <Note>
      Completa esta pestaña antes de conectar la fuente en Compliance.
    </Note>

    <Steps>
      <Step title="Inicia sesión en Smartsheet">
        Inicia sesión en Smartsheet con la cuenta cuyo acceso debe heredar la integración, idealmente un **System Admin**.
      </Step>

      <Step title="Abre Personal Settings">
        Selecciona **Cuenta** (tu avatar, en la esquina inferior izquierda) y luego **Personal Settings**.
      </Step>

      <Step title="Abre API Access">
        Selecciona **API Access**.
      </Step>

      <Step title="Genera un nuevo token de acceso">
        Selecciona **Generate new access token**.
      </Step>

      <Step title="Asigna un nombre al token y cópialo">
        Introduce un nombre como **Iru Compliance** para que puedas identificar este token más adelante. Copia el valor del token **una sola vez** mientras Smartsheet lo muestra. No se puede recuperar después. Si lo pierdes, genera uno de reemplazo.
      </Step>
    </Steps>

    <Note>
      Continúa en la pestaña [**Iru Compliance**](#iru-compliance).
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Primero completa la pestaña [**Smartsheet**](#smartsheet).
    </Note>

    <Steps>
      <Step title="Abre Sources">
        En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Navegación izquierda: Compliance expandido, Sources seleccionado" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Activa Smartsheet">
        Busca **Smartsheet** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **toggle**. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
      </Step>

      <Step title="Pega el token Bearer">
        Pega el token en el campo **Bearer**.
      </Step>

      <Step title="Finaliza la conexión">
        Selecciona **Enviar token de Bearer**. Cuando la conexión se realiza correctamente, el asistente muestra **Conexión configurada**.
      </Step>

      <Step title="Confirma que la fuente está activa">
        Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos**, luego vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta **Smartsheet** está **Activo**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Solución de problemas

<AccordionGroup>
  <Accordion title="No se abre nada al activar la fuente">
    Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru e inténtalo de nuevo.
  </Accordion>

  <Accordion title="La autenticación falla">
    Vuelve a generar el token y pega la cadena completa. Smartsheet no permite ver un token existente, por lo que no se puede comprobar después si se copió de forma parcial.
  </Accordion>

  <Accordion title="Falta un espacio de trabajo o una hoja">
    El propietario del token no tiene acceso compartido a él. Vuelve a generar el token desde una cuenta **System Admin** o comparte los espacios de trabajo dentro del alcance con la cuenta que usaste.
  </Accordion>

  <Accordion title="La lista de usuarios parece incompleta">
    Un token que no es de administrador solo devuelve los usuarios que puede ver. Usa un token de System Admin para obtener el inventario completo de usuarios y licencias.
  </Accordion>

  <Accordion title="No aparece el contenido de las hojas">
    Esto es lo esperado. Iru recopila la configuración de uso compartido y acceso, no los datos de las celdas.
  </Accordion>
</AccordionGroup>

### Artículos relacionados

<CardGroup cols={2}>
  <Card title="Administración de fuentes" icon="plug" href="/es/compliance/sources-management">
    Explora y administra todas las fuentes de Compliance.
  </Card>

  <Card title="Primeros pasos con Compliance" icon="rocket" href="/es/compliance/getting-started-with-compliance">
    Marcos, acciones y **Artefactos**.
  </Card>

  <Card title="Descripción general de Iru" icon="layer-group" href="/es/iru/platform-overview/iru-overview">
    Cómo encajan Endpoint, Compliance e Identity.
  </Card>

  <Card title="Administración de Artifacts" icon="folder-open" href="/es/compliance/artifacts-management">
    Carga, revisa y organiza la evidencia de fuentes y acciones.
  </Card>
</CardGroup>
