> ## 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.
# Slack
> Conecta Slack a Iru Compliance con un token de bot para recopilar metadatos del espacio de trabajo, inventario de canales, membresía de usuarios y grupos, y registros de auditoría de Enterprise Grid.
### Acerca de Slack
El conector de **Slack** lee la membresía del espacio de trabajo, la configuración de los canales y los grupos de usuarios. En **Enterprise Grid**, también lee eventos del **registro de auditoría**. Presenta esa información como artefactos en Iru Compliance. Iru se autentica con un **token OAuth de bot** (`xoxb-`) que se obtiene al instalar una aplicación de Slack en tu espacio de trabajo. El acceso está **orientado a la lectura** para la evidencia de cumplimiento; no envía mensajes ni cambia la configuración del espacio de trabajo mediante los alcances descritos aquí.
### Cómo funciona
Las API de Slack esperan el token de bot en el encabezado **Authorization**:
```http theme={null}
Authorization: Bearer xoxb-XXXX-XXXX-XXXX
```
Creas una aplicación en **api.slack.com**, concedes **Bot token scopes**, instalas la aplicación en el espacio de trabajo y luego copias el **Bot User OAuth Token**. Ampliar los alcances requiere **reinstalar** la aplicación, lo que emite un token **nuevo**. Actualiza Iru cada vez que eso ocurra.
| Detalle | Valor |
| - | - |
| **Categoría** | Comunicaciones |
| **Autenticación** | Token Bearer (token OAuth de bot `xoxb-`) |
| **Registros de auditoría** | **`auditlogs:read`** es **solo para Enterprise Grid**. Sin Grid, la evidencia de tipo registro de auditoría no está disponible a través de esta ruta de API. |
Referencias: [OAuth tokens](https://docs.slack.dev/authentication/tokens/), [Scopes](https://docs.slack.dev/scopes/), [Audit Logs API](https://docs.slack.dev/apis/audit-logs-api/).
### Requisitos previos
* Derechos de **Workspace Owner** o **Workspace Admin** para poder instalar aplicaciones.
* Capacidad de iniciar sesión en **[api.slack.com/apps](https://api.slack.com/apps)** para tu espacio de trabajo.
* Opcional: Enterprise Grid si necesitas **`auditlogs:read`**.
**Alcances de bot habituales para la evidencia de directorio y canales**
| Alcance | Propósito |
| - | - |
| `users:read` | Leer los perfiles de los miembros |
| `users:read.email` | Leer las direcciones de correo electrónico de los miembros |
| `channels:read` | Listar y leer canales públicos |
| `groups:read` | Listar y leer canales privados (cuando esté permitido) |
| `usergroups:read` | Leer la configuración de los grupos de usuarios |
| `auditlogs:read` | Registros de auditoría (solo **Enterprise Grid**) |
### Conectar Slack a Iru
Completa esta pestaña antes de conectar la fuente en Compliance.
En un navegador, ve a **[api.slack.com/apps](https://api.slack.com/apps)** e inicia sesión con una cuenta de Slack que pueda **crear aplicaciones** para el **espacio de trabajo** de destino (a menudo, un administrador del espacio de trabajo).
Selecciona **Create New App** y luego **From scratch** (a menos que tu organización use un manifiesto estándar; este artículo asume **From scratch**).
Introduce un nombre de aplicación como **Iru Compliance** y selecciona el **espacio de trabajo de Slack** en el que debe instalarse Iru.
En la barra lateral izquierda de la aplicación, abre **OAuth & Permissions**.
En **Bot Token Scopes**, agrega cada alcance de **Requisitos previos** que requieran tus controles. Agrega **`auditlogs:read`** solo si usas **Enterprise Grid** y necesitas evidencia de auditoría.
Desde **OAuth & Permissions**, selecciona **Install to Workspace** (o **Reinstall** después de cambiar los alcances). Revisa los permisos y apruébalos.
Copia el **Bot User OAuth Token** (empieza con **`xoxb-`**). Si cambias los alcances más adelante, reinstala la aplicación para obtener un token **nuevo**. Pega el token actual en el asistente del conector de Iru cuando **Iru Compliance** te lo solicite.
Continúa en la pestaña [**Iru Compliance**](#iru-compliance).
Primero completa la pestaña [**Slack**](#slack).
En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.
Busca **Slack** (establece **Categoría** en **Communications** o usa **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.
Cuando el asistente solicite un token Bearer, pega el **Bot User OAuth Token** **`xoxb-`** y envíalo.
Selecciona **Enviar token de Bearer**. Cuando la conexión se realiza correctamente, el asistente muestra **Conexión configurada**.
Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos**, luego vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta **Slack** está **Activo**.
### Solución de problemas
Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru e inténtalo de nuevo.
Confirma que el token esté vigente, que empiece con **`xoxb-`** y que la aplicación siga instalada.
Agrega el alcance en **OAuth & Permissions**, **reinstala** la aplicación, copia el token **nuevo** y actualiza Iru.
Reinstala la aplicación o rota las credenciales; actualiza Iru con el nuevo token de bot.
**`auditlogs:read`** requiere **Enterprise Grid**. Sin él, la evidencia de la API de registros de auditoría no está disponible.
### Consideraciones
Por lo general, los tokens de bot **no caducan** a menos que tu espacio de trabajo exija la rotación. Sigue las indicaciones de Slack si la rotación está habilitada.
Desinstalar la aplicación **revoca** el token de inmediato.
Ampliar los alcances siempre requiere **reinstalar** la aplicación y un nuevo token. Planifica los cambios durante una ventana de mantenimiento.
### Artículos relacionados
Explora y administra todas las fuentes de Compliance.
Marcos, acciones y **Artefactos**.
Cómo encajan Endpoint, Compliance e Identity.
Carga, revisa y organiza la evidencia de fuentes y acciones.