Compartir a través de

Información general sobre los conectores personalizados

  • Artículo

Si bien Azure Logic Apps, Microsoft Power Automate y Microsoft Power Apps ofrecen más de 1000 conectores para conectarse a Microsoft y servicios 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.

Captura de pantalla que muestra cómo los conectores personalizados conectan la API de análisis de texto con las aplicaciones.

Lifecycle

Captura de pantalla del ciclo de vida de los conectores personalizados en cinco etapas.

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úblico (visible en Internet público), como Spotify, Slack, Rackspace o una API que usted 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:

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

2. Proteger la API

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

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 el ID de los conectores personalizados, consulte Cómo proteger su API y conector con el ID. Microsoft Entra Microsoft Entra

2.1. OAuth 2.0

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

  • Si creó sus conectores personalizados con la interfaz web, edite sus conectores personalizados, vaya a la pestaña Seguridad y marque la casilla Actualizar a URL de redireccionamiento única, y luego guarde para habilitar la URI de redireccionamiento por conector.
  • Si creó sus conectores personalizados con multi-auth usando la herramienta de interfaz de línea de comandos (CLI), debe actualizar su conector usando la herramienta CLI para configurar "redirectMode": "GlobalPerConnector".
  • Una vez que los conectores personalizados se actualizan para usar la URI de redirección por conector, ya sea a través de la configuración en la pestaña Seguridad o la herramienta CLI, elimine la URI de redirección global de sus aplicaciones OAuth 2.0. Debes agregar la URL de redireccionamiento única recién generada a tus aplicaciones 2.0. OAuth
  • Implementaremos esta actualización para los conectores personalizados 2.0 existentes a partir del 17 de febrero de 2024. OAuth Cualquier conector personalizado que no se actualice para usar una URI de redirección por conector deja de funcionar para nuevas conexiones y muestra 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 que use la acción Obtener conectores personalizados como administrador para el conector de administrador y analizar su resultado. Power Apps 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 los conectores personalizados que no son 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:

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, y los conectores creados en Power Apps están disponibles en Power Automate. Esta disponibilidad no es válida 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:

Propina

Si actualiza (elimina, agrega o cambia) un campo en la API, realice estos pasos:

  1. Vuelva a publicar el conector para que se vea en el Swagger actualizado para la API.
  2. Elimina cualquier conexión/fuente de datos en cualquier aplicación que haya utilizado ese conector.
  3. Vuelva a agregar la conexión/fuente de datos para ese conector en las aplicaciones.

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.

Obtenga más información en Comparta conectores personalizados en su 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, consulte Envíe sus conectores para la certificación de Microsoft.

Soporte de Virtual Network

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

  • 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 creados antes de que el entorno se asociara a una red virtual.

  • No se admiten los activadores que devuelven un encabezado de ubicación que no vuelve a llamar al conector personalizado.

Proporcionar comentarios

Agradecemos enormemente los comentarios sobre problemas con nuestra plataforma de conectores o nuevas ideas de funciones. Para proporcionar comentarios, vaya a Enviar problemas u obtener ayuda con los conectores y seleccione su tipo de comentario.