Información general sobre los conectores personalizados

Aunque Azure Logic Apps, Microsoft Power Automate y Microsoft Power Apps ofrecen más de 1.000 conectores para conectarse a servicios de Microsoft y verificados, es posible que desee comunicarse con servicios que no están disponibles como conectores prediseñados. Para afrontar este escenario, los conectores personalizados permiten crear (e incluso compartir) un conector con sus propios desencadenadores y acciones.

Lifecycle

1. Crear la API

Un conector personalizado es un contenedor relacionado con una API de REST que permite que Logic Apps, Power Automate o Power Apps se comuniquen con la API de REST o la API de SOAP. Estas API pueden ser:

• Públicas (visibles en Internet público) como Spotify, Slack, Rackspace o una API que administre.
• Privadas (visibles solo para su red).

Logic Apps también admite API de SOAP.

Para las API públicas que planea crear y administrar, considere usar uno de estos productos de Microsoft Azure:

• Funciones de Azure
• Azure Web Apps
• Aplicaciones de API de Azure

Para API privadas, Microsoft ofrece conectividad de datos local a través de una puerta de enlace de datos local.

2. Proteger la API

Use uno de estos métodos de autenticación estándar para sus API y conectores (se recomienda Microsoft Entra ID):

• OAuth 2.0 genérico
• OAuth 2.0 para determinados servicios, como Microsoft Entra ID, Dropbox, GitHub y SalesForce
• Autenticación básica
• Clave API

Puede configurar la autenticación de Microsoft Entra ID para su API en Azure Portal para no tener que implementar la autenticación. O bien, puede requerir y aplicar la autenticación en el código de la API. Para obtener más información sobre Microsoft Entra ID para conectores personalizados, consulte Proteger su API y su conector con Microsoft Entra ID.

2.1. OAuth 2.0

Los conectores personalizados recién creados que utilizan OAuth 2.0 para autenticarse automáticamente tienen un URI de redireccionamiento por conector. Los conectores OAuth 2.0 existentes deben actualizarse para utilizar un URI de redireccionamiento por conector antes del 17 de febrero de 2024.

• Si creó sus conectores personalizados con la interfaz web, edítelos, vaya a la pestaña Seguridad y marque la casilla Actualizar a único URL de redireccionamiento y luego guárdelo para habilitar el URI de redireccionamiento por conector.
• Si creó sus conectores personalizados con autenticación múltiple usando la herramienta de interfaz de línea de comando (CLI), debe actualizar su conector usando la herramienta CLI para configurar "redirectMode": "GlobalPerConnector".
• Una vez actualizados los conectores personalizados para utilizar el URI de redirección por conector, ya sea a través de la configuración en la pestaña Seguridad o utilizando la herramienta CLI, deberá eliminar el URI de redirección global de sus aplicaciones OAuth 2.0. Debe agregar la URL de redireccionamiento única recién generada a sus aplicaciones OAuth 2.0.
• Aplicaremos esta actualización para los conectores personalizados de OAuth 2.0 existentes a partir del 17 de febrero de 2024. Cualquier conector personalizado que no se haya actualizado para utilizar un URI de redireccionamiento por conector dejará de funcionar para nuevas conexiones y mostrará un mensaje de error al usuario.
• Para saber qué conectores personalizados necesitan una actualización para migrar a la URL de redireccionamiento por conector, puede crear un flujo simple que utilice la acción Obtener conectores personalizados como administrador de Power Apps . para el conector de administración y analiza su resultado. El flujo adjunto más adelante en este artículo recupera todos los conectores personalizados utilizando el mismo. Luego aplica una condición de filtro en la propiedad del parámetro de conexión para filtrar el conector personalizado no Oauth, seguido de otro filtro para seleccionar solo los conectores que no usan la URL de redireccionamiento única por conector. Finalmente, coloca los conectores personalizados seleccionados en una variable de matriz inicializada al comienzo del flujo y genera una tabla HTML que muestra el nombre y el creador de esos conectores. Puede importar este flujo a su entorno importando esta solución. Puede ampliar aún más el flujo para enviarse la tabla HTML como un correo electrónico. O puede ampliarlo para enviar correos electrónicos directamente a los creadores del conector y proporcionarles los nombres del conector que debe actualizarse.

3. Describir la API y definir el conector personalizado

Una vez que tenga una API con acceso autenticado, lo siguiente que debe hacer es describir su API para que Logic Apps, Power Automate o Power Apps puedan comunicarse con ella. Se admiten los siguientes enfoques:

• Una definición de OpenAPI (anteriormente conocida como archivo Swagger)

  • Creación de un conector personalizado desde una definición de OpenAPI
  • Documentación de OpenAPI

• Una colección de Postman

  • Crear una colección Postman
  • Creación de un conector personalizado a partir de una colección de Postman
  • Documentación de Postman

• Comience desde cero utilizando el portal de conector personalizado (Power Automate y Power Apps solamente)

  • Creación de un conector personalizado desde cero

Las definiciones de OpenAPI y las colecciones Postman utilizan distintos formatos, pero ambos son documentos legibles en máquina independientes del lenguaje que describen la API. Puede generar estos documentos desde distintas herramientas, según el lenguaje y la plataforma que use la API. En segundo plano, Logic Apps, Power Automate y Power Apps usan OpenAPI para definir conectores.

4. Usar su conector en una aplicación de Logic Apps, Power Automate o Power Apps

Los conectores personalizados se usan la misma manera que los conectores prediseñados. Será preciso crear una conexión a la API para usar dicha conexión para llamar a cualquier operación que haya expuesto en el conector personalizado.

Los conectores creados en Power Automate están disponibles en Power Apps. De igual modo, los conectores creados en Power Apps están disponibles en Power Automate. Esto no es cierto para los conectores creados en Logic Apps. Sin embargo, puede reutilizar la definición de OpenAPI o colección de Postman para recrear el conector en cualquiera de estos servicios. Para obtener más información, consulte el tutorial correspondiente:

• Uso de un conector personalizado desde un flujo
• Usar un conector personalizado a partir de una aplicación
• Uso de un conector personalizado desde una aplicación lógica

5. Compartir el conector

Puede compartir el conector con usuarios de su organización de la misma manera que comparte recursos en Logic Apps, Power Automate o Power Apps. Compartir es opcional, pero puede que tenga escenarios en los que desee compartir sus conectores con otros usuarios.

Para obtener más información, vea Uso compartido de un conector personalizado en la organización.

6. Certificar el conector

Si desea compartir el conector con todos los usuarios de Logic Apps, Power Automate y Power Apps, puede enviar el conector para la certificación de Microsoft. Microsoft examina el conector, comprueba si cumple todas las condiciones técnicas y de contenido, y valida la funcionalidad.

Para obtener más información, vea Envío de conectores para que Microsoft los certifique.

Soporte de Virtual Network

Cuando el conector se utiliza en un entorno de Power Platform vinculado a una red virtual, se aplican limitaciones:

• Cuando se utiliza código personalizado: las limitaciones se explican en Escribir código en un conector personalizado.

• Es necesario volver a guardar los conectores personalizados que se crearon antes de asociar el entorno a una red virtual.

Proporcionar comentarios

Agradecemos enormemente los comentarios sobre problemas con nuestra plataforma de conectores o nuevas ideas de características. Para enviar comentarios, vaya a Enviar problemas u obtener ayuda con los conectores y seleccione el tipo de comentario.