Este artículo proporciona los pasos necesarios para configurar SCIM Provisioning usando la app Intercom en Okta. Esto te permite aprovisionar nuevos teammates y gestionar sus cuentas, grupos y permisos usando Okta como tu única fuente de verdad.
Funciones compatibles
La app Intercom en Okta soporta las siguientes funciones de aprovisionamiento:
Importar teammates: Los teammates ya presentes en Okta serán creados en Intercom.
Sincronizar contraseña: Las contraseñas de los teammates pueden sincronizarse de Okta a Intercom (esta es una configuración opcional).
Enviar nuevos teammates: Los nuevos teammates creados a través de Okta también serán creados en Intercom.
Enviar actualizaciones de perfil: Las actualizaciones hechas al perfil de un teammate a través de Okta se enviarán a Intercom.
Desactivación de teammates: Desactivar a un teammate o deshabilitar su acceso a la aplicación a través de Okta eliminará al teammate de Intercom.
Reactivar teammates: Las cuentas de teammates pueden reactivarse en la aplicación.
Enviar grupos: Envía grupos desde Okta a Intercom y asígnalos a roles de Intercom.
Antes de comenzar
Importante advertencia de desactivación: Los teammates en Intercom pueden estar en uno de dos estados: "activo" o "eliminado". Intercom no tiene un estado de eliminado suave, desactivado o archivado para teammates. Si un teammate no está activo en tu proveedor de identidad, su cuenta será permanentemente eliminada de tu espacio de trabajo Intercom.
Nota:
SCIM Provisioning solo está disponible con ciertos planes de Intercom. Consulta nuestros planes y precios para más detalles.
Intercom considera que las direcciones de correo electrónico no distinguen mayúsculas y minúsculas (por ejemplo, "Teammate@example.com" es igual que "teammate@example.com").
Si se envía un parámetro "displayName" en la solicitud, se usará en lugar del parámetro "name".
Requisitos
En Okta, asegúrate de que tu política de contraseñas requiera al menos 10 caracteres. Para cambiar esto, visita la sección Autenticación dentro de la configuración de seguridad de Okta.
En Intercom, antes de configurar SCIM provisioning, primero debes configurar SAML SSO.
Luego, debes seguir los pasos de configuración a continuación. Los siguientes elementos serán proporcionados por Intercom en tu configuración de seguridad:
URL base SCIM 2.0
API Token
Paso 1: Obtén tus credenciales SCIM de Intercom
Antes de poder configurar Okta, debes habilitar SCIM en Intercom para obtener tus credenciales.
Habilita SAML SSO.
Selecciona Aprovisionamiento y luego habilita SCIM provisioning en el menú desplegable.
En "Excluir del desaprovisionamiento y aprovisionamiento de roles", haz clic en Agregar teammates y excluye tu propia cuenta para evitar quedar bloqueado.
Haz clic en Guardar.
Copia la URL base y el API Token. Los necesitarás para el siguiente paso.
Aprende más sobre los pasos de configuración aquí.
Paso 2: Configura la app Intercom en Okta
En tu panel de Okta, navega a Aplicaciones y selecciona Explorar catálogo de apps.
Busca "Intercom" y añade la app.
Ve a la pestaña Aprovisionamiento de la app Intercom y haz clic en Configurar integración API.
Marca la casilla Habilitar integración API.
Pega la URL base y el API Token que copiaste de Intercom.
Haz clic en Probar credenciales API. Deberías ver un mensaje de éxito.
Haz clic en Guardar.
Debería aparecer un mensaje de éxito: "¡Intercom fue verificado con éxito!"
Selecciona A la app en el panel izquierdo y luego haz clic en Editar.
Habilita Crear users.
Habilita Actualizar atributos de users.
Habilita Desactivar Users.
Habilita Sincronizar contraseña (opcional).
Haz clic en Guardar.
Nota: Debes seleccionar "Correo electrónico" para el formato de nombre de usuario de la aplicación en la pestaña Inicio de sesión de la aplicación en Okta. Esto se debe a que el atributo userName SCIM para esta app debe seguir el formato de una dirección de correo electrónico.
Paso 3: Configura el envío de grupos (Recomendado)
Si usas grupos SCIM para gestionar roles de teammates:
En Okta, abre la pestaña Enviar grupos en la app Intercom.
Selecciona los grupos de Okta que quieres sincronizar con Intercom (por ejemplo, "Intercom Admins").
En Intercom, ahora debes asignar esos grupos sincronizados a roles de Intercom. Ve a Configuración > Espacio de trabajo > Teammates > SCIM Provisioning.
Para pasos detallados sobre la asignación, consulta nuestra guía completa sobre Asignar roles de teammates automáticamente con grupos SCIM.
Paso 4: Asignar teammates a la app
Una vez que el aprovisionamiento esté completamente configurado, ve a la pestaña Asignaciones en Okta para asignar teammates a la app Intercom. Esto iniciará el proceso de aprovisionamiento para esos teammates.
La pestaña Asignaciones solo aprovisionará teammates; no enviará los grupos en sí. Los grupos deben enviarse desde la pestaña Enviar grupos.
Solución de problemas
Si encuentras algún problema durante la configuración, inicia una conversación con nosotros en Messenger o envía un correo al equipo a team@intercom.com.