Conexión de Microsoft Exchange¶

Introducción¶

Una conexión de Microsoft Exchange, creada mediante el conector de Microsoft Exchange, establece acceso a Microsoft Exchange. Estas actividades, una vez configuradas, interactúan con Microsoft Exchange a través de la conexión.

Crear o Editar una Conexión de Microsoft Exchange¶

Se crea una nueva conexión de Microsoft Exchange utilizando el conector de Microsoft Exchange desde una de estas ubicaciones:

• La pestaña Conexiones de la paleta de componentes de diseño (consulte Paleta de Componentes de Diseño).
• La página Conexiones globales (vea Crear una conexión global en Conexiones globales).

Se puede editar una conexión de Microsoft Exchange existente desde estas ubicaciones:

• La pestaña Conexiones de la paleta de componentes de diseño (consulte Paleta de Componentes de Diseño).
• La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña Componentes del panel de proyecto).
• La página Conexiones globales (vea Editar una conexión global en Conexiones globales).

Configurar una Conexión de Microsoft Exchange¶

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Microsoft Exchange se describe a continuación.

• Nombre de la conexión: Introduzca un nombre que se utilizará para identificar la conexión. El nombre debe ser único para cada conexión de Microsoft Exchange y no debe contener barras diagonales (/) o dos puntos (:). Este nombre también se utiliza para identificar el extremo de Microsoft Exchange, que hace referencia tanto a una conexión específica como a sus actividades.

• Autenticación: Cuando se selecciona (predeterminado), muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

  • Esquema de autorización: Seleccione el esquema de autorización, uno de:

    • NTLM

    • Básico

    • Resumen

    • NINGUNO

    • Negociar

    • OAuth

    • AzureAD

    • AzureServicePrincipal

    • AzureMSI

  • Esquema: Seleccione el esquema, uno de:

    • EWS

    • MSGraph

  • Plataforma: Seleccione la plataforma, una de:

    • Exchange2007

    • Exchange2007_SP1

    • Exchange2010

    • Exchange2010_SP1

    • Exchange2010_SP2

    • Exchange2013

    • Exchange2013_SP1

    • Exchange_Online

  • Servidor: Ingrese el servidor.

  • Usuario: Introduzca el usuario.

  • Contraseña: Ingrese la contraseña.

• Autenticación de Azure: Cuando se selecciona, muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

  • Inquilino de Azure: Introduzca el inquilino de Azure.

• OAuth: Cuando se selecciona, muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

  • Iniciar OAuth: Seleccione la configuración de OAuth, una de las siguientes:

    • APAGADO

    • GETANDREFRESH

    • ACTUALIZAR

  • Id. de cliente de OAuth: Introduzca el ID de cliente de OAuth.

  • Secreto del cliente OAuth: Ingrese el secreto del cliente OAuth.

  • Token de acceso de OAuth: Ingrese el token de acceso de OAuth.

  • URL de devolución de llamada: Ingrese la URL de devolución de llamada.

  • Tipo de concesión de OAuth: Seleccione el tipo de concesión de OAuth, uno de:

    • CÓDIGO

    • CLIENTE

    • CONTRASEÑA

  • Id. de usuario: Introduzca el ID de usuario.

  • Verificador OAuth: Ingrese el verificador OAuth.

  • Token de actualización de OAuth: Ingrese el token de actualización de OAuth.

  • OAuth caduca en: Introduzca el tiempo en segundos en el que caduca el token de OAuth.

  • Marca de tiempo del token de OAuth: Ingrese la marca de tiempo del token de OAuth.

• Kerberos: Cuando se selecciona, muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

  • Kerberos KDC: Introduzca el KDC de Kerberos.

  • Reino Kerberos: Ingrese al reino Kerberos.

  • SPN de Kerberos: Introduzca el SPN de Kerberos.

  • Archivo de tabla de claves de Kerberos: Introduzca el archivo de tabla de claves de Kerberos.

  • Reino de servicio Kerberos: Ingrese al dominio de servicio Kerberos.

  • KDC del servicio Kerberos: Ingrese al KDC del servicio Kerberos.

  • Caché de tickets de Kerberos: Ingrese la caché de tickets de Kerberos.

• SSL: Cuando se selecciona, muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

  • Certificado de servidor SSL: Ingrese el certificado del servidor SSL.

• Usar configuración de proxy: Seleccione para usar Configuración de proxy de Agente Privado.

• Configuraciones avanzadas: Cuando se selecciona, muestra la tabla Propiedades de configuraciones avanzadas, que se utiliza para agregar propiedades de configuración adicionales como pares clave-valor.

  Haga clic en el ícono Agregar para agregar una fila a la siguiente tabla e ingresar un par clave-valor para cada propiedad.

  Para guardar la fila, haga clic en el icono de enviar en la columna de la derecha.

  Para editar o eliminar una sola fila, coloque el cursor sobre la columna más a la derecha y use el ícono de edición o eliminar icono .

  Para eliminar todas las filas, haga clic en Borrar todo.

  Importante

  Los campos de la tabla Configuraciones avanzadas muestran el icono de variable sólo en modo de edición. Para que los valores de las variables de estos campos se completen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

• Prueba: Haga clic para verificar la conexión usando la configuración especificada. Cuando se prueba la conexión, los agentes del grupo de agentes asociado con el ambiente actual descargan la última versión del conector. Este conector admite la suspensión de la descarga de la última versión del conector mediante Desactivar actualización automática del conector política de la organización.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y eliminación). Un mensaje le pide que confirme que desea eliminar la conexión.

Configurar Conexiones OAuth¶

Este conector admite una conexión mediante OAuth mediante propiedades de configuración específicas. Después de seleccionar un esquema de autenticación que incluya Iniciar OAuth, podrá especificar la configuración en los campos que se muestran.

Para este conector, se admiten dos escenarios. En cualquier caso, necesitará utilizar una herramienta de externo (como Postman o una herramienta similar) para obtener el token o tokens de acceso requeridos del extremo involucrado. Ambos escenarios funcionan sólo para grupos de agente único. Estos son Grupos de Agente que constan de un solo agente.

• Escenario 1: Uso de un token de acceso de OAuth que caduca después de un período de tiempo determinado.

  Con esta configuración, usted proporciona un token de acceso de OAuth que dura un período de tiempo determinado, según lo determinado por el extremo en particular. El conector utilizará el token para realizar la conexión. Sin embargo, la conexión ya no funcionará una vez que caduque el token de acceso. Configuraría el conector para usar el token estableciendo estas propiedades:

  Propiedad de configuración	Valor
  Iniciar OAuth	OFF
  Token de acceso OAuth	Establecido en el valor del token de acceso OAuth obtenido del extremo

• Escenario 2: Uso de un token de acceso de OAuth combinado con un token de actualización de OAuth para permitir la actualización automática del acceso.

  Con esta configuración, el conector utilizará un token de actualización para obtener un nuevo token de acceso una vez que el token de acceso actual haya caducado. Este es generalmente el mejor método para configurar OAuth.

  Usted proporciona un token de acceso de OAuth y un token de actualización de OAuth, según lo determine el extremo en particular. Configuraría el conector para usar estos tokens estableciendo estas propiedades:

  Propiedad de configuración	Valor
  Iniciar OAuth	REFRESH
  Token de acceso OAuth	Establecido en el valor del token de acceso OAuth obtenido del extremo
  Token de actualización de OAuth	Establecido en el valor del token de actualización de OAuth obtenido del extremo

Próximos Pasos¶

Después de crear una conexión de conector de Microsoft Exchange, coloca un tipo de actividad en el tela de diseño para crear instancias de actividad que se utilizarán como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Se puede acceder a las acciones de menú para una conexión y sus tipos de actividad desde el panel del proyecto y la paleta de componentes de diseño. Para obtener más información, consulte Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividades están disponibles:

• Consulta: Recupera registros de una tabla en Microsoft Exchange y está diseñado para usarse como fuente en una operación.

• Crear: Inserta un registro en una tabla en Microsoft Exchange y está diseñado para usarse como destino en una operación.

• Actualizar: Actualiza un registro en una tabla en Microsoft Exchange y está diseñado para usarse como destino en una operación.

• Borrar: Elimina un registro de una tabla en Microsoft Exchange y está diseñado para usarse como destino en una operación.

• Ejecutar: Ejecuta un procedimiento en Microsoft Exchange y está diseñado para usarse como destino en una operación.