Conectores personalizados
Aunque Azure Logic Apps, Microsoft Power Automate y Microsoft Power Apps ofrecen más de 325+ conectores para conectarse a servicios de Microsoft y que no son de Microsoft, 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:
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 Azure Active Directory):
- OAuth 2.0 genérico
- OAuth 2.0 para determinados servicios, como Azure Active Directory (Azure AD), Dropbox, GitHub y SalesForce
- Autenticación básica
- Clave API
Puede configurar la autenticación de Azure AD 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 Azure AD para conectores personalizados, consulte Proteger su API y su conector con Azure AD.
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)
Una colección de Postman.
Comience desde cero utilizando el portal de conector personalizado (Power Automate y Power Apps solamente)
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 utilizan 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 administrados por Microsoft. 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 la colección Postman para volver a crear 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:
Si está utilizando Power Automate o Power Apps, consulte:
Tutoriales avanzados
Los siguientes tutoriales proporcionan más detalles para escenarios de conectores personalizados específicos: