Saltar al contenido principal
El aprovisionamiento SCIM está disponible en el plan Enterprise. La integración de directorio (Microsoft Graph) está disponible en los planes Teams y Enterprise. Ambas son a nivel de organización y las configura un administrador.
Hay dos formas de conectar Microsoft Entra ID (anteriormente Azure Active Directory) con Wave Connect. Ambas crean y actualizan usuarios de Wave Connect a partir de tu directorio. Se diferencian en quién se sincroniza, cómo funciona la baja de usuarios y qué mantiene viva la conexión.

¿Cuál debo usar?

El aprovisionamiento SCIM es el enfoque que Microsoft recomienda para mantener una aplicación sincronizada con Entra ID. Elige la integración de Graph solo en el plan Teams o para una importación puntual.

Configurar el aprovisionamiento SCIM

1

Crea un token SCIM en Wave Connect

Ve a Configuración → Seguridad y busca la tarjeta Sincronización de directorio. Haz clic en Configurar para abrir el modal Configurar SCIM. Copia el Endpoint de SCIM (https://app.wavecnct.com/api/scim) y luego haz clic en Crear token. Dale un nombre al token y haz clic en Crear. Copia el token ahora. Solo se muestra una vez.
2

Crea la aplicación empresarial

En el centro de administración de Microsoft Entra, ve a Aplicaciones empresariales → Nueva aplicación → Crear su propia aplicación. Escribe un nombre como “Wave Connect”, elige Integrar cualquier otra aplicación que no encuentre en la galería (no incluida en la galería) y haz clic en Crear.
3

Introduce las credenciales SCIM

Abre la nueva aplicación y ve a Aprovisionamiento → Comenzar. Establece el Modo de aprovisionamiento en Automático. En Credenciales de administrador, pega el endpoint de SCIM en URL de inquilino y el token en Token secreto. Haz clic en Probar conexión y luego en Guardar.
4

Revisa las asignaciones de atributos

En Asignaciones, abre Aprovisionar usuarios de Microsoft Entra ID y compárala con la tabla siguiente. Los valores predeterminados de Entra cubren la mayoría de las filas. Solo necesitas editar las filas del correo electrónico principal, locale y externalId. Deja Aprovisionar grupos de Microsoft Entra ID habilitado si quieres que los grupos de Entra se conviertan en equipos de Wave Connect.
5

Asigna usuarios y grupos

Ve a Usuarios y grupos y asigna las personas y los grupos que deben tener una cuenta de Wave Connect. Solo se aprovisionan los usuarios asignados.
6

Inicia el aprovisionamiento

De vuelta en Aprovisionamiento, establece el Estado de aprovisionamiento en Activado y haz clic en Guardar, o haz clic en Iniciar aprovisionamiento. Entra ejecuta un ciclo inicial y después un ciclo incremental aproximadamente cada 40 minutos. Para comprobar un solo usuario sin esperar, usa Aprovisionar a petición.

Asignación de atributos

Wave Connect lee estos atributos SCIM. La columna Campo de Wave Connect muestra dónde termina cada valor.
Las asignaciones predeterminadas de Entra ya cubren userName, name.givenName, name.familyName, title, los números de teléfono, addresses[type eq "work"].locality y active. Solo hay que editar tres filas: asegúrate de que la asignación del correo electrónico de trabajo establezca primary en True, cambia el destino de preferredLanguage de preferredLanguage a locale, y cambia el origen de externalId de mailNickname a objectId.
Otras notas sobre la asignación:
  • Los números de teléfono se validan y se guardan en formato internacional. Los marcadores de posición y los valores que solo contienen una extensión se descartan en lugar de hacer fallar la sincronización.
  • roles[].value establecido en USER, ADMIN u OWNER (en mayúsculas) define el rol en la organización. Entra no envía roles de forma predeterminada, por lo que los nuevos usuarios se crean como usuarios.
  • La extensión empresarial department no se guarda en el perfil. El soporte de Wave Connect puede habilitar la asignación de equipos por departamento.
  • El valor de locale debe ser uno de los idiomas que admite Wave Connect; de lo contrario, el usuario recibe inglés.

Los grupos se convierten en equipos

Cuando el aprovisionamiento de grupos está habilitado, cada grupo de Entra asignado a la aplicación se convierte en un equipo de Wave Connect. El displayName del grupo pasa a ser el nombre del equipo y el objectId del grupo se guarda como ID externo del equipo. Si ya existe un equipo con el mismo nombre en Wave Connect, el grupo se fusiona con él. Un usuario de Wave Connect pertenece a un solo equipo. Si un usuario está en varios grupos asignados, gana el último grupo que Entra aprovisiona. Una organización puede tener hasta 75 equipos. Eliminar un grupo en Entra elimina el equipo en Wave Connect. Sus usuarios se conservan y sus contactos se trasladan a la organización. Cada equipo puede tener una plantilla diferente, por lo que los usuarios de distintos grupos obtienen automáticamente el diseño de tarjeta, la marca y los campos bloqueados correctos. Consulta Plantillas.

Baja de usuarios

Cuando un usuario se desasigna de la aplicación, se deshabilita o se elimina temporalmente en Entra, el servicio de aprovisionamiento envía active = false. Wave Connect desactiva al usuario:
  • Ya no puede iniciar sesión y sus sesiones se revocan.
  • Aparece con la insignia SUSPENDED en Usuarios.
  • Su tarjeta NFC, su perfil y sus contactos se conservan.
  • Sigue contando como un puesto.
Entra conserva al usuario eliminado temporalmente durante 30 días y después envía una solicitud de eliminación. Wave Connect elimina entonces al usuario de forma permanente, borra su perfil y sus contactos, y desvincula su tarjeta NFC para que pueda asignarse a otra persona. Si no quieres el período de gracia de 30 días, abre Configuración → Seguridad → Sincronización de directorio → Configurar y activa Elimina usuario inmediatamente en lugar de suspenderlo. La desactivación elimina entonces al usuario de forma permanente e inmediata. Para recuperar a un usuario desactivado, asígnalo de nuevo a la aplicación en Entra. El siguiente ciclo de aprovisionamiento envía active = true y reactiva la cuenta.
Puedes habilitar el inicio de sesión único en la misma aplicación empresarial. Consulta Inicio de sesión único (SAML).

Integración de directorio (Microsoft Graph)

La integración de directorio conecta Wave Connect con tu inquilino a través de la API de Microsoft Graph usando la cuenta de un administrador. Es más sencilla de configurar que SCIM, pero sincroniza todo el inquilino y depende de la cuenta que la conectó.

Cómo conectar

Hay dos puntos de entrada. Crean la misma integración, pero con un valor predeterminado distinto para la Sincronización de usuarios, el interruptor que aplica los cambios del directorio automáticamente.
  1. Ve a Integraciones → Microsoft Entra ID y haz clic en Instalar aplicación.
  2. Deja activado Importar automáticamente nuevos usuarios de Microsoft Entra ID, o desactívalo si solo quieres una importación manual. Haz clic en Continuar.
  3. Inicia sesión con una cuenta de Microsoft que pueda otorgar consentimiento de administrador en el inquilino y acepta la solicitud de consentimiento.
Con ese interruptor activado, todos los usuarios del inquilino se crean en Wave Connect a medida que llegan las notificaciones de cambio, y los cambios futuros se aplican automáticamente. Aparece como Sincronización de usuarios en la Configuración de la integración.
Con la Sincronización de usuarios activada, esta integración agrega un usuario de Wave Connect, y un puesto, por cada usuario del inquilino, incluidos los invitados. No hay forma de limitarla a un grupo.

Permisos

Wave Connect solicita los ámbitos delegados openid, offline_access, profile, User.Read.All y Directory.Read.All en la cuenta del administrador que conecta. Wave Connect solo lee el directorio. Nunca escribe en Entra. La integración funciona con el token de actualización de ese administrador. Si el token se revoca (por ejemplo, el administrador deja la empresa, se restablece su contraseña con revocación de sesiones, o una directiva de acceso condicional bloquea la actualización), Wave Connect elimina la integración y un administrador tiene que volver a conectarla.

Qué se sincroniza

Dirección de sincronización: Entra ID → Wave Connect (solo entrante). Las fotos de perfil solo se obtienen durante una importación manual o una vista previa, y se guardan como copia en Wave Connect. Los usuarios creados por la Sincronización de usuarios no reciben foto.

Sincronización de usuarios y desactivación

Tras conectar, Wave Connect se suscribe a las notificaciones de cambio de Microsoft Graph para usuarios (creados, actualizados, eliminados). Las suscripciones duran tres días y se renuevan automáticamente a partir de las notificaciones de ciclo de vida de Graph. Las notificaciones se ignoran mientras la Sincronización de usuarios está desactivada. Cuando un usuario se elimina en Entra, o su cuenta se deshabilita (accountEnabled = false), Wave Connect lo desactiva: el inicio de sesión se bloquea, aparece con la insignia SUSPENDED en Usuarios, y su tarjeta, perfil y contactos se conservan. Sigue contando como un puesto. Volver a habilitar la cuenta en Entra no lo reactiva en Wave Connect. Contacta a support@wavecnct.com para reactivar a un usuario, o elimínalo desde Usuarios.

Limitaciones

  • Se sincroniza todo el inquilino. Los invitados están incluidos. No hay delimitación por asignación.
  • Los grupos y departamentos de Entra no se sincronizan. Los equipos deben gestionarse en Wave Connect.
  • Sin foto para los usuarios creados por la Sincronización de usuarios.
  • La conexión depende de una sola cuenta de administrador y se elimina cuando se revoca el token de esa cuenta.
  • La integración nunca elimina usuarios, solo los desactiva.

Desconectar

Ve a Integraciones → Microsoft Entra ID → Configuración y haz clic en Desconectar. Esto elimina la conexión guardada en Wave Connect. No se revoca nada en Microsoft, y la suscripción de Graph simplemente caduca en un plazo de tres días. Los usuarios de Wave Connect existentes se conservan y dejan de actualizarse. Para retirar el acceso de Wave Connect del lado de Microsoft, revoca el consentimiento de la aplicación empresarial en el centro de administración de Entra.

Usar ambas

SCIM y la integración de Graph pueden estar activas al mismo tiempo. En ese caso, los usuarios aprovisionados mediante SCIM obtienen su foto de perfil de la conexión de Graph, emparejada por correo electrónico. Mantén la Sincronización de usuarios desactivada en la integración de Graph cuando uses SCIM. Con ella activada, la integración de Graph crea a todos los usuarios del inquilino, lo que elude la delimitación por asignación que configuraste en la aplicación empresarial.

Solución de problemas

Comprueba que la URL de inquilino sea exactamente https://app.wavecnct.com/api/scim sin barra final, y que el Token secreto sea el token completo del modal Configurar SCIM. Un token solo puede copiarse cuando se crea, así que crea uno nuevo si lo perdiste. Los tokens se eliminan cuando la organización abandona el plan Enterprise.
Entra aprovisiona en ciclos de aproximadamente 40 minutos. Usa Aprovisionar a petición en el usuario para enviarlo de inmediato, y consulta los Registros de aprovisionamiento para ver el resultado. Una solicitud fallida suele significar que falta un atributo obligatorio: name.givenName, name.familyName o un correo electrónico principal en una actualización.
Con SCIM, el usuario debe estar asignado a la aplicación. Si se desasignó, asígnalo de nuevo y Entra envía active = true. Con la integración de Graph, volver a habilitar nunca reactiva al usuario. Contacta a support@wavecnct.com para reactivarlo.
Cuando SCIM crea un usuario cuyo correo electrónico ya pertenece a una cuenta personal (fuera de una organización) de Wave Connect, y el dominio del correo es uno de tus dominios verificados, esa cuenta se traslada a tu organización y se actualiza en lugar de crear una nueva. Su tarjeta y sus contactos existentes se conservan. Verifica el dominio antes de aprovisionar para que estas cuentas se migren en lugar de duplicarse.
Con SCIM, el correo electrónico de inicio de sesión es el correo electrónico principal, que la asignación recomendada toma de mail. Con la integración de Graph, es userPrincipalName (o mail para invitados). Si un usuario tiene un mail y un UPN distintos, asigna en su lugar userPrincipalName al correo electrónico principal en Entra, para que ambos enfoques coincidan.