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:
-
Establezca el tipo en Cliente
-
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.
-
Proporcione la Contraseña. Este es el valor Secreto del cliente creado anteriormente.
-
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
