Cómo configurar la integración de Teams para utilizar la teleconsulta

Antes de realizar la configuración en SIKU, se debe seguir la siguiente guía técnica para la configuración:

1. Objetivo
Este documento describe los pasos necesarios para realizar la configuración requerida para integrar Siku con Microsoft Graph API de Azure Active Directory (Microsoft Entra). La integración permitirá generar enlaces de Teams para que el equipo médico pueda brindar el servicio de teleconsulta. En caso de ser necesario, se puede realizar esta configuración en un directorio de pruebas y posteriormente replicarla en un directorio de producción.

2. Crear aplicación en Microsoft Entra (Azure Active Directory)
Para comenzar con la configuración, es necesario registrar una aplicación en Microsoft Entra (Azure Active Directory).

Acceder al Centro de Administración de Microsoft Entra

• Ingrese al siguiente enlace: entra.microsoft.com.
• En el panel de la izquierda, busque y seleccione Aplicaciones > Registros de aplicaciones.

Registrar la aplicación

• Haga clic en Nuevo registro.
• Complete el formulario que se despliega.
  • Puede asignar el nombre que desee a la aplicación, este es solo un valor sugerido.
  • El tipo de cuenta es un valor sugerido, pero debe seleccionar el que mejor se ajuste a las necesidades del negocio.

Registrar la aplicación

• Haga clic en Registrar.
• Una vez registrada la aplicación, se mostrará el detalle de la misma.
• Marque y comparta los siguientes datos con el proveedor (marcados en rojo):
  • Id. de la aplicación (cliente)
  • Id. de directorio (inquilino)

Crear un secreto de cliente

• Haga clic en Nuevo secreto de cliente. Se abrirá una ventana emergente con un formulario.

• Ingrese una descripción para el secreto (por ejemplo, “ClientSecret”) y seleccione la expiración del secreto, de acuerdo con las necesidades del negocio.
• Recuerde que, cuando este valor expire, la integración dejará de funcionar hasta que se proporcione un nuevo secreto.
• Haga clic en Agregar.

• El secreto generado aparecerá en la tabla de secretos de cliente. Marque y comparta con Siku el valor del secreto (marcado en rojo).

Agregar permisos a la aplicación

• En el panel de la izquierda, seleccione Permisos de API.

• Se desplegara una tabla con los permisos que cuenta actualmente la aplicación

• Proceder a hacer clic en el botón de Agregar un permiso y esto desplegará una pantalla
  emergente en el cual debe hacer clic en la opción de Microsoft Graph.

• Existen 2 tipos de permisos que deben otorgar, permisos delegados y permisos de la
  aplicación, para poder dar permisos debe buscar el permiso que se quiere otorgar, posterior
  seleccionar el tipo y por ultimo haga clic en el botón de Agregar permiso, como se muestra en
  la siguiente imagen

• Asigne los siguientes permisos:

Permisos delegados:

• • • Calendars: ReadWrite
    • OnlineMeetings: ReadWrite
    • User: Read.All

Permisos de la aplicación:

• • • Calendars: ReadWrite
    • OnlineMeetings: ReadWrite.All
    • User: Read.All
• Haga clic en Agregar permiso.
• Conceda el consentimiento de administrador, haciendo clic en Conceder consentimiento de administrador para “xxxxx.com” AD.

3. Obtener un “Object ID” o identificador de usuario en Microsoft Entra

Para obtener el "Object ID" de un usuario, siga los siguientes pasos:

1. Acceder al Centro de Administración de Microsoft Entra

   • Ingrese al enlace: entra.microsoft.com.
   • En el panel de la izquierda, seleccione Usuarios > Todos los usuarios.

• Se desplegará una tabla con todos los usuarios que existen en el AD, en este caso
  buscar uno en específico y hacer clic en el nombre del usuario.

• Esta acción los llevará a ver los detalles del perfil del usuario en AD y en los detalles del usuario pueden ver una propiedad llamada Id. De objeto en esta propiedad hacen clic en el icono de copiar y obtendríamos el ID

4. Información a enviar a soporte de Siku
Para completar la integración entre Teams y Siku, es necesario proporcionar la siguiente información:

1. Tenant ID (ID del directorio de la aplicación)
2. Client ID (ID del cliente o aplicación)
3. Client Secret (Secreto de la aplicación)
4. Object ID (Identificador del usuario)

Nota: Para obtener el Object ID, el usuario debe acceder a Microsoft Entra a través del siguiente enlace: https://entra.microsoft.com/. Una vez iniciada sesión, debe ir al menú del panel de la izquierda, seleccionar Todos los usuarios, buscar el usuario específico, hacer clic sobre el nombre del usuario y copiar el Id. de objeto.

5. Enviar la información a soporte
Una vez completada la configuración, envíe la información mencionada a la dirección de correo electrónico: soporte@sikumed.com.