Guía de Conexión a Microsoft Exchange

Descripción General

Esta guía describe los requisitos del sistema y las instrucciones para conectar App Builder TM a Microsoft Exchange como servidor de datos. Esta conexión utiliza el flujo OAuth de credenciales de cliente.

Las credenciales del cliente hacen referencia a un flujo en OAuth en el que no se produce una autenticación directa del usuario. En su lugar, se crean credenciales solo para la propia aplicación. Todas las tareas que realiza la aplicación se realizan sin un contexto de usuario predeterminado. Esto hace que el flujo de autenticación sea un poco diferente del estándar. Todos los permisos relacionados con el flujo de OAuth del cliente requieren el consentimiento del administrador.

Requisitos del Sistema

Microsoft Exchange
Portal de Azure

Navegador Web del Cliente

Chrome: 84+
Firefox: 73+
Safari: 13.0.1+
Ventaja: 84+

Limitaciones y Funciones Admitidas

Puede haber limitaciones en torno a los identificadores de clave principal de Microsoft Exchange con la base de datos de SQL Server. La clave principal es una cadena alfanumérica larga y recorrerá de la a a la z, de 0 a 1, de la a la z de forma incremental para los correos nuevos. El problema con esto es que SQL Server, de forma predeterminada, no distingue entre mayúsculas y minúsculas, por lo que dos correos con las claves principales "1234a" y "234A" son iguales. App Builder una solución alternativa es aprovechar la columna changeKey, que en combinación con id siempre será única.

Instrucciones de Conexión

Requisitos Previos para Configurar en Azure Portal

Antes de configurar la conexión del servidor de datos de Microsoft Exchange en App Builder, primero deberá configurar la siguiente información desde su portal de Azure.

Cree una aplicación OAuth personalizada dentro del Portal de Azure : https://cdn.cdata.com/help/CEH/ado/pg_oauthcustomappcreate.htm
En el registro de la aplicación, seleccione Tokens de acceso (usados para flujos implícitos) en la sección Autenticación.
Vaya a Certificados y secretos y cree un valor de secreto de cliente

Nota

Asegúrese de copiar el valor secreto del cliente y almacenarlo en un lugar donde pueda acceder a él* al configurar el App Builder pasos.
Vaya a Permisos de API y seleccione Permisos de Microsoft Graph. Hay dos conjuntos distintos de permisos: Delegados y Aplicación. Los permisos utilizados durante la autenticación de credenciales de cliente se encuentran en Permisos de aplicación. Seleccione los permisos correspondientes que necesite para su integración.
Configure los siguientes permisos de API, así como otorgar el consentimiento del administrador para estos permisos.

Configurar en App Builder

Crear un Proveedor de Seguridad OAuth

Navegue hasta App Builder IDE
Haga clic en el botón Proveedores de seguridad
Haga clic en el botón + Autenticación de usuario
Asigne un Nombre que sea identificable. Por ejemplo: Microsoft Exchange Connector
Establezca el tipo en OAuth
Establezca el tipo de autenticación en OAuth
Establezca la concesión OAuth en Credenciales del cliente
Establezca la autenticación del cliente OAuth en Básica
Establezca la autenticación de recursos OAuth en Bearer
Establezca el propietario del token como Cliente
Haga clic en el botón + Extremo y cree un registro:
- Tipo = Extremo del token
- URL = https://login.microsoftonline.com/{{ TenantID }}/oauth2/v2.0/token
Nota

Reemplace el TenantID en la cadena URL proporcionada según corresponda
Haga clic en el botón + Credenciales y cree un registro utilizando el valor de Id. de aplicación (cliente) creado en Azure. Esta información se almacena en la página de información general de la aplicación de Azure:
1. Establezca el tipo en Cliente
2. Proporcione el Nombre de usuario. Este es el valor de ID de aplicación (cliente) que se encuentra en la página de descripción general de la aplicación de Azure.
3. Proporcione la Contraseña. Este es el valor Secreto del cliente creado anteriormente.
4. Haga clic en el botón Guardar
Haga clic en el botón + Propiedad y cree un registro de Ámbitos:
- Establezca el parámetro en Ámbitos
- Establezca el valor en el valor de permisos predeterminado para Microsoft Graph
Marque el campo Habilitado en Configuración del proveedor para habilitarlo como proveedor de seguridad

Crear el Servidor de Datos de Microsoft Exchange

Navegue hasta App Builder IDE
Haga clic en el botón Servidores de datos
Haga clic en el botón + Servidor
Asigna un Nombre de servidor. Por ejemplo: Controlador de Exchange
Establezca el tipo en Microsoft Exchange
Haga clic para expandir la Configuración de seguridad
Establezca el Proveedor de seguridad en el Proveedor de seguridad que creamos. Por ejemplo: Conector de Microsoft Exchange
Haga clic en el botón Guardar
Haga clic para expandir la Configuración del servidor
Haga clic en el botón Configuración avanzada
En el campo Avanzado, debe especificar un usuario del inquilino al que desea acceder a los recursos de Outlook. El formato debe ser: UserID={{ UserEmail }}
- Si tiene varios inquilinos configurados, aquí también deberá especificar cuál. Si no se especifica, se utilizará el inquilino predeterminado.

Vincular Exchange Data Server a la Aplicación

En esta sección, enlace la fuente del servidor de datos de Exchange que creamos a nuestro App Builder aplicación.

Desde tu App Builder aplicación, navegue hasta App Workbench
Haga clic en el ficha Fuentes de datos
Haga clic en el botón + Fuente
Seleccione Enlace a fuente existente
Haga clic en Siguiente
Localice el Controlador de intercambio
Marque el campo Seleccionado
Haga clic en el botón Enlace 1 Fuente
Haga clic en Listo
Haga clic en el ficha Tablas
Seleccione Controlador de intercambio como el valor de Fuentes de datos de la aplicación
Confirme que ahora puede ver todas las tablas asociadas con la fuente de datos del controlador de Exchange para el usuario especificado