Tutorial: Configuración de Slack para aprovisionar usuarios automáticamente
Nota:
No se admite la integración con Slack con una aplicación personalizada o BYOA. Se admite el uso de la aplicación de la galería tal como se describe en este tutorial. La aplicación de la galería se ha personalizado para que funcione con el servidor SCIM v1 de Slack.
El objetivo de este tutorial es mostrarle los pasos que debe realizar en Slack y Microsoft Entra ID para aprovisionar y desaprovisionar automáticamente cuentas de usuario desde Microsoft Entra ID a Slack. Para obtener información importante acerca de lo que hace este servicio, cómo funciona y ver preguntas frecuentes al respecto, consulte Automatización del aprovisionamiento y desaprovisionamiento de usuarios para aplicaciones SaaS con Microsoft Entra ID.
Funcionalidades admitidas
- Crear usuarios en Slack
- Quitar usuarios de Slack cuando ya no necesiten acceso
- Mantener sincronizados los atributos de usuario entre Microsoft Entra ID y Slack
- Aprovisionar grupos y pertenencias a grupos en Slack
- Inicio de sesión único en Slack (recomendado)
Requisitos previos
En la situación descrita en este tutorial se supone que ya cuenta con los elementos siguientes:
- Un inquilino de Microsoft Entra.
- Uno de los siguientes roles: Administrador de aplicaciones, Administrador de aplicaciones en la nube o Propietario de la aplicación.
- Un inquilino de Slack con el plan Plus o uno superior habilitado.
- Una cuenta de usuario de Slack con permisos de administrador de equipo.
Nota:
Esta integración también está disponible para usarse desde el entorno de la nube del gobierno de EE. UU. de Microsoft Entra. Es posible encontrar esta aplicación en la galería de aplicaciones en la nube del gobierno de EE. UU. de Microsoft Entra y configurarla de la misma manera que en la nube pública.
Paso 1: Planeación de la implementación de aprovisionamiento
- Obtenga información sobre cómo funciona el servicio de aprovisionamiento.
- Determine quién estará en el ámbito de aprovisionamiento.
- Determine qué datos asignar entre Microsoft Entra ID y Slack.
Paso 2: Agregar Slack desde la galería de aplicaciones de Microsoft Entra
Agregar Slack desde la galería de aplicaciones de Microsoft Entra para empezar a administrar el aprovisionamiento a Slack. Si ha configurado previamente Slack para el inicio de sesión único, puede usar la misma aplicación. Sin embargo, se recomienda que cree una aplicación independiente al probar la integración inicialmente. Puede encontrar más información sobre cómo agregar una aplicación desde la galería aquí.
Paso 3: Determinar quién estará en el ámbito de aprovisionamiento
El servicio de aprovisionamiento de Microsoft Entra le permite definir quién se aprovisionará, en función de la asignación a la aplicación y de los atributos del usuario o grupo. Si elige el ámbito del que se aprovisionará en la aplicación en función de la asignación, puede usar los pasos siguientes para asignar usuarios y grupos a la aplicación. Si elige el ámbito del que se aprovisionará en función únicamente de los atributos del usuario o grupo, puede usar un filtro de ámbito, tal como se describe aquí.
Empiece por algo pequeño. Pruebe con un pequeño conjunto de usuarios y grupos antes de implementarlo en todos. Cuando el ámbito del aprovisionamiento se define en los usuarios y grupos asignados, puede controlarlo asignando uno o dos usuarios o grupos a la aplicación. Cuando el ámbito se establece en todos los usuarios y grupos, puede especificar un filtro de ámbito basado en atributos.
Si necesita roles adicionales, puede actualizar el manifiesto de aplicación para agregar nuevos roles.
Paso 4: Configurar el aprovisionamiento automático de usuarios a Slack
Esta sección lo guía a través de la conexión de su Microsoft Entra ID a la API de aprovisionamiento de cuentas de usuario de Slack, y la configuración del servicio de aprovisionamiento para crear, actualizar y deshabilitar cuentas de usuario asignadas en Slack basadas en la asignación de usuarios y grupos en Microsoft Entra ID.
Para configurar el aprovisionamiento automático de cuentas de usuario a Slack en Microsoft Entra ID:
Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
Vaya a Identidad>Aplicaciones>Aplicaciones empresariales
En la lista de aplicaciones, seleccione Slack.
Seleccione la pestaña Aprovisionamiento.
Establezca el modo de aprovisionamiento en Automático.
En Credenciales de administrador, haga clic en Autorizar. Se abrirá un cuadro de diálogo de autorización de Slack en una nueva ventana del explorador.
En esa nueva ventana, inicie sesión en Slack con su cuenta de administrador de equipo. En el cuadro de diálogo de autorización que aparece, seleccione el equipo de Slack para el que desea habilitar el aprovisionamiento y, luego, seleccione Autorizar. Cuando termina, vuelva a Azure Portal para completar la configuración de aprovisionamiento.
Seleccione Probar conexión para asegurarse de que Microsoft Entra ID puede conectarse a su aplicación Slack. Si se produce un error de conexión, asegúrese de que su cuenta de Slack tiene permisos de administrador de equipo y vuelva a intentar el paso de "Autorizar".
En el campo Correo electrónico de notificación, escriba la dirección de correo electrónico de una persona o grupo que deba recibir las notificaciones de error de aprovisionamiento y active la casilla Enviar una notificación por correo electrónico cuando se produzca un error.
Seleccione Guardar.
En la sección Asignaciones, seleccione Sincronizar usuarios de Microsoft Entra con Slack.
En la sección Asignaciones de atributos, revise los atributos de usuario que se sincronizarán desde Microsoft Entra ID a Slack. Tenga en cuenta que los atributos seleccionados como propiedades de Coincidencia se usarán para establecer coincidencias con las cuentas de usuario de Slack con el objetivo de realizar operaciones de actualización. Seleccione el botón Guardar para confirmar los cambios.
Atributo | Tipo |
---|---|
active | Boolean |
externalId | String |
DisplayName | String |
name.familyName | String |
name.givenName | String |
title | String |
emails[type eq "work"].value | String |
userName | String |
nickName | String |
addresses[type eq "untyped"].streetAddress | String |
addresses[type eq "untyped"].locality | String |
addresses[type eq "untyped"].region | String |
addresses[type eq "untyped"].postalCode | String |
addresses[type eq "untyped"].country | String |
phoneNumbers[type eq "mobile"].value | String |
phoneNumbers[type eq "work"].value | String |
roles[primary eq "True"].value | String |
locale | String |
name.honorificPrefix | String |
photos[type eq "photo"].value | String |
profileUrl | String |
timezone | String |
userType | String |
preferredLanguage | String |
urn:scim:schemas:extension:enterprise:1.0.department | String |
urn:scim:schemas:extension:enterprise:1.0.manager | Referencia |
urn:scim:schemas:extension:enterprise:1.0.employeeNumber | String |
urn:scim:schemas:extension:enterprise:1.0.costCenter | String |
urn:scim:schemas:extension:enterprise:1.0.organization | String |
urn:scim:schemas:extension:enterprise:1.0.division | String |
En la sección Asignaciones, seleccione Sincronizar grupos de Microsoft Entra con Slack.
En la sección Asignaciones de atributos, revise los atributos de grupo que se sincronizarán desde Microsoft Entra ID a Slack. Tenga en cuenta que los atributos seleccionados como propiedades de Coincidencia se usarán para establecer coincidencias con los grupos de Slack con el objetivo de realizar operaciones de actualización. Seleccione el botón Guardar para confirmar los cambios.
Atributo Tipo DisplayName String members Referencia Para configurar filtros de ámbito, consulte las siguientes instrucciones, que se proporcionan en el artículo Aprovisionamiento de aplicaciones basado en atributos con filtros de ámbito.
Para habilitar el servicio de aprovisionamiento de Microsoft Entra para Slack, cambie el Estado de aprovisionamiento a Activado en la sección Configuración
Seleccione los valores deseados en Ámbito, en la sección Configuración para definir los usuarios o grupos que quiere aprovisionar en Slack.
Cuando esté listo para realizar el aprovisionamiento, haga clic en Guardar.
Esta operación inicia el ciclo de sincronización inicial de todos los usuarios y grupos definidos en Ámbito en la sección Configuración. El ciclo inicial tarda más en realizarse que los ciclos posteriores, que tienen lugar aproximadamente cada 40 minutos, siempre y cuando se esté ejecutando el servicio de aprovisionamiento de Microsoft Entra.
Paso 5: Supervisar la implementación
Una vez configurado el aprovisionamiento, use los recursos siguientes para supervisar la implementación:
- Use los registros de aprovisionamiento para determinar qué usuarios se han aprovisionado correctamente o sin éxito.
- Consulte la barra de progreso para ver el estado del ciclo de aprovisionamiento y cuánto falta para que finalice.
- Si la configuración de aprovisionamiento parece estar en mal estado, la aplicación pasará a estar en cuarentena. Más información sobre los estados de cuarentena aquí.
Sugerencias para la solución de problemas
Cuando configure el atributo displayName de Slack, tenga en cuenta los siguientes comportamientos:
Los valores no son completamente únicos (por ejemplo, dos usuarios pueden tener el mismo nombre para mostrar)
Admite caracteres no latinos, espacios y mayúsculas y minúsculas.
La puntuación permitida incluye puntos, caracteres de subrayado, guiones, apóstrofes, corchetes (por ejemplo,
( [ { } ] )
) y separadores (por ejemplo,, / ;
).La propiedad displayName no puede tener un carácter "\@". Si se incluye un carácter "\@", es posible que encuentre un evento omitido en los registros de aprovisionamiento con la descripción "AttributeValidationFailed".
Solo se actualiza si estos dos parámetros están configurados en el área de trabajo y organización de Slack - La sincronización de perfiles está habilitada y Los usuarios no pueden cambiar su nombre para mostrar.
El atributo userName de Slack debe tener menos de 21 caracteres y tener un valor único.
Slack solo permite la coincidencia con los atributos userName y email.
Los códigos de error comunes se pueden encontrar en la documentación oficial de Slack: https://api.slack.com/scim#errors
Registro de cambios
- 16/06/2020: se modifica el atributo DisplayName para que solo se actualice durante la creación de nuevos usuarios.
Recursos adicionales
- Administración del aprovisionamiento de cuentas de usuario para aplicaciones empresariales
- ¿Qué es el acceso a la aplicación y el inicio de sesión único con Microsoft Entra ID?