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 alrededor de una API REST (Logic Apps también admite API SOAP) que permite que Logic Apps, Power Automate o Power Apps se comuniquen con esa API REST o 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).

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 que los conectores personalizados se hayan actualizado para usar el URI de redireccionamiento por conector (ya sea a través de la configuración en la pestaña Seguridad o usando la herramienta CLI), debe eliminar el URI de redireccionamiento global de sus aplicaciones OAuth 2.0 y agregar el redireccionamiento único recién generado. URL de 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 simplemente 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 examinará el conector, comprobará si cumple todas las condiciones técnicas y de contenido, y validará la funcionalidad.

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

Tutorial

El tutorial usa la API Text Analytics de Cognitive Services. Microsoft ya proporciona un conector para esta API. Es un buen ejemplo para enseñar el ciclo de vida del conector personalizado y cómo los conectores personalizados pueden admitir escenarios únicos.

Escenario

El conector que va a crear expone la operación Sentimiento de Text Analytics, que devuelve la puntuación de sentimiento (de 0,000 a 1000) de la entrada del texto.

Requisitos previos

• Una de las siguientes suscripciones:

  • Una suscripción a Azure (Logic Apps)
  • Power Automate
  • Power Apps

• Conocimientos básicos sobre cómo crear Logic Apps, flujos de Power Automate o Power Apps.

• La clave de API para la API de Text Analytics de Cognitive Services.

Obtención de una clave de API

La API Text Analytics utiliza una clave de API para autenticar a los usuarios. Cuando un usuario crea una conexión a la API a través de un conector personalizado, el usuario especifica el valor de esta clave. Para obtener una clave de API:

• Solicite una clave de API para probar la API. Esto no requiere una suscripción a Azure.

• Agregar la API de Text Analytics a su suscripción de Azure. Una vez que tenga el recurso de API en su suscripción, obtenga la clave de API en la sección Claves:

  

Comience el tutorial

• Si está utilizando Logic Apps, consulte:

  • Creación de un conector personalizado de Azure Logic Apps

• Si está utilizando Power Automate o Power Apps, consulte:

  • Creación de un conector personalizado desde una definición de OpenAPI
  • Creación de un conector personalizado a partir de una colección de Postman
  • Creación de un conector personalizado desde cero

Orientación avanzada

Los tutoriales y el video de esta sección le brindarán la información necesaria para aprovechar los conectores de Power Platform como parte de sus implementaciones.

Tutoriales

Los siguientes tutoriales proporcionan más detalles para escenarios de conectores personalizados específicos:

• Ampliación de una definición de OpenAPI
• Crear una colección de Postman para un conector personalizado
• Autenticar mediante Microsoft Entra ID
• Crear un conector para una API web
• Usar un webhook como desencadenador
• Crear un conector API SOAP de Logic Apps

Video

El siguiente video de 45 minutos le muestra cómo funcionan los conectores de Power Platform. También demuestra cómo crear conectores personalizados simples y avanzados.

Consulte también

Lista de todos los conectores

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.