Saltar al contenido principal

Integración de Microsoft Teams con SMARTFENSE

  • Actualización

Este artículo describe los pasos necesarios para configurar la conexión entre Microsoft Teams y SMARTFENSE, habilitando la autenticación y comunicación mediante Microsoft Graph API.

Consideraciones importantes para configurar la integración con Microsoft Teams:

  1. Seguir el instructivo de configuración para rellenar los campos necesarios en la plataforma. El usuario que realiza la configuración en Microsoft EntraID debe tener permisos administrativos.
  2. Autorizar la integración entre SMARTFENSE y Microsoft Teams. El usuario que autoriza la integración debe ser un usuario administrador de Microsoft EntraID y tener un usuario administrador en la plataforma de SMARTFENSE.
  3. Comprobar la conexión para validar que el proceso se haya realizado correctamente.
  4. La cuenta (usuario de Microsoft EntraID) que realiza la autorización es desde donde se enviarán las notificaciones. Ese usuario no puede recibir notificaciones por Teams de la plataforma de SMARTFENSE. (No puede auto-notificarse). Por lo tanto ese usuario no puede ser parte de las campañas en SMARTFENSE cuando se utilice esta forma de notificar. Tampoco le llegará al mismo usuario utilizando el botón de Enviarse prueba. Para realizar una prueba tiene que ser una campaña a otro usuario distinto.

Configuración en Microsoft Azure

  1. Inicie sesión en el portal de Azure: https://portal.azure.com/.

  2. En el menú lateral izquierdo, seleccione Microsoft EntraID.

  1. Haga clic en Registro de Aplicaciones.

  2. Seleccione Nuevo registro en el menú superior.

  1. En el campo Nombre, ingrese SMARTFENSE.

  2. En Tipos de cuenta compatibles, seleccione Solo cuentas de este directorio organizativo (solo de Defense Balance SL: inquilino único)

  3. En el campo URL de redirección, ingrese:
    https://www.smartfense.com

  4. Presione el botón Registrar.

Identificadores de la aplicación

Una vez creada la aplicación:

  1. Copie los valores de los campos Id. de aplicación e Id. de directorio.

  2. Pegue dichos valores en la plataforma SMARTFENSE, en los campos Id. de aplicación e Id. de directorio, respectivamente.

Configuración de URL de respuesta

  1. En la aplicación recién creada, seleccione la opción Redirect URLs de respuesta dentro del menú Información general> Configuración.

  2. Añada la siguiente URL de respuesta:
    https://nombreinstancia.takesecurity.com/config/microsft-teams-auth/callback/

  3. Haga clic en Guardar.

Asignación de permisos API

  1. Seleccione API Permissions en el menú lateral Administrar.

  2. Presione el botón Agregar para abrir el menú Agregar acceso de API.

  1. Seleccione la API Microsoft Graph.

  1. Asigne los siguientes permisos delegados:

    • Create chats: Chat.Create

    • Send user chat messages: ChatMessage.Send

    • Read all users full profiles: User.Read.All

  2. Haga clic en Update permissions en la sección Agregar acceso de API.

  3. Luego, presione Conceder permisos en la sección Permisos necesarios.

Creación de la clave secreta

  1. En el menú Configuración, seleccione Certificados & secretos.

  1. Presione Nuevo secreto de cliente.

  2. En el campo Descripción de la clave, ingrese SMARTFENSE.

  3. Seleccione una opción de expiración según sus políticas de seguridad.

Advertencia: al llegar la fecha de expiración, la conexión dejará de funcionar. Deberá generar una nueva clave y comprobar la conectividad. Durante ese período, los usuarios no podrán autenticarse en campañas que requieran login.

  1. Haga clic en Guardar para generar el campo Valor.

  2. Copie el valor generado inmediatamente, ya que solo se muestra una vez y no podrá recuperarse. 

Conexión con SMARTFENSE

  1. Pegue el valor de la clave copiada en el paso anterior en la plataforma SMARTFENSE, dentro del campo Clave secreta de aplicación.

  2. Haga clic en Comprobar conectividad para validar que la configuración se haya realizado correctamente.

Advertencia: extensiones bloqueadoras de anuncios, como AdBlock Plus, pueden interferir con esta prueba. Se recomienda desactivarlas temporalmente antes de ejecutar la comprobación.

💡 Mejores prácticas

  • Verifique los permisos de Microsoft Graph antes de probar la conexión para evitar errores de autenticación.

  • Guarde en un lugar seguro el Bot User OAuth Token y la Clave secreta de aplicación.

  • Configure alertas internas antes de la fecha de expiración de la clave para renovar con tiempo.

  • Desactive cualquier extensión que bloquee scripts antes de ejecutar la prueba de Comprobar conectividad.

Relacionada con

Artículos relacionados