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:
Referencias: OAuth tokens, Scopes, 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 para tu espacio de trabajo.
- Opcional: Enterprise Grid si necesitas
auditlogs:read.
Conectar Slack a Iru
- Slack
- Iru Compliance
Completa esta pestaña antes de conectar la fuente en Compliance.
1
Abre las aplicaciones de la API de Slack
En un navegador, ve a 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).
2
Crea una nueva aplicación
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).
3
Asigna un nombre a la aplicación y elige el espacio de trabajo
Introduce un nombre de aplicación como Iru Compliance y selecciona el espacio de trabajo de Slack en el que debe instalarse Iru.
4
Abre OAuth & Permissions
En la barra lateral izquierda de la aplicación, abre OAuth & Permissions.
5
Agrega alcances de Bot Token
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.6
Instala la aplicación en tu espacio de trabajo
Desde OAuth & Permissions, selecciona Install to Workspace (o Reinstall después de cambiar los alcances). Revisa los permisos y apruébalos.
7
Copia el Bot User OAuth Token
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.
Solución de problemas
No se abre nada al activar la fuente
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.
not_authed / 401
not_authed / 401
Confirma que el token esté vigente, que empiece con
xoxb- y que la aplicación siga instalada.missing_scope
missing_scope
Agrega el alcance en OAuth & Permissions, reinstala la aplicación, copia el token nuevo y actualiza Iru.
token_revoked
token_revoked
Reinstala la aplicación o rota las credenciales; actualiza Iru con el nuevo token de bot.
No hay datos de auditoría
No hay datos de auditoría
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…
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.
Desinstalar la aplicación revoca el token de inmediato.
Ampliar los alcances siempre requiere reinstalar y un nuevo…
Ampliar los alcances siempre requiere reinstalar la aplicación y un nuevo token. Planifica los cambios durante una ventana de mantenimiento.
Artículos relacionados
Administración de fuentes
Explora y administra todas las fuentes de Compliance.
Primeros pasos con Compliance
Marcos, acciones y Artefactos.
Descripción general de Iru
Cómo encajan Endpoint, Compliance e Identity.
Administración de Artifacts
Carga, revisa y organiza la evidencia de fuentes y acciones.