Introducción
Este módulo trata sobre los conectores personalizados y explica cómo configurarlos y usarlos con Microsoft Power Apps, Microsoft Power Automate y Microsoft Azure Logic Apps.
En este módulo, hará lo siguiente:
Obtener más información sobre el papel de los conectores personalizados.
Crear un conector y usarlo en un flujo de Power Automate.
Los conectores facilitan que los creadores de flujos y aplicaciones se conecten a otras aplicaciones, datos y dispositivos en la nube, de las siguientes maneras:
La conexión se realiza de una manera consistente y repetible que los creadores pueden descubrir.
Los conectores tienen acciones que permiten a los fabricantes controlar cuándo se realiza una operación.
Los conectores pueden tener desencadenadores que permitan que la automatización comience al producirse el evento desencadenador.
Un conector es un proxy o un contenedor en torno a una API que permite que Power Automate, Power Apps y Logic Apps se comuniquen con el servicio subyacente. Muchos conectores están predefinidos y disponibles para su uso sin tener que definir nada. Estas definiciones incorporadas de conectores incluyen servicios de Microsoft y otros. Cuando el servicio o la API que desea utilizar no tiene un conector prediseñado, puede crear su propio conector personalizado. Si un conector prediseñado no expone todos los desencadenadores y acciones que necesita de la API, puede crear un conector personalizado, aparte del disponible, para manejar estos requisitos adicionales. Una vez definido el conector personalizado, queda disponible para su uso cuando se crean aplicaciones y flujos en ese entorno, de forma similar a los conectores incorporados.
Identificar o crear la API
Su primera tarea es comprobar la referencia de conector para determinar si ya existe un conector adecuado para la API o el servicio. Si aún no existe un conector adecuado, puede crear su propio conector personalizado. Puede definir el conector personalizado para describir cualquier API de REST que sea pública (una que esté disponible en Internet) o privada (una que esté solo en su red interna). Las API privadas necesitan la puerta de enlace de datos local para acceder a los recursos internos.
Si aún no existe una API compatible, los desarrolladores pueden crear una utilizando cualquier tecnología que elijan y que pueda hospedar una API de REST, lo que incluye funciones de Microsoft Azure y el servicio de aplicaciones de Azure. También puedes usar Azure API Management para aumentar la capacidad de administración y gobernanza de las API.
Describir la API
Para que Power Apps y Power Automate puedan descubrir qué activadores y acciones están disponibles en la API, debe identificarlos al crear su conector personalizado. Puede realizar esta tarea editando manualmente la definición del conector en el Maker Portal o importando una definición en un formato compatible. Este proceso incluye la identificación de los requisitos de autenticación para la API.
Usar el conector
Una vez creados en un entorno, los conectores personalizados se pueden utilizar de la misma forma que los conectores integrados. Estos conectores también se pueden usar en un ambiente diferente al utilizado para crearlo. La definición del conector debe exportarse desde el ambiente donde se creó y luego importarse a cualquier ambiente que lo necesite. También puede compartir el conector con otras personas para permitirles usarlo como otros recursos compartidos.
Certificar y compartir el conector como código abierto
Debido a que los conectores personalizados solo están disponibles en entornos donde existe su definición, no están disponibles para otros clientes de Microsoft. Al compartir una definición de conector personalizada como código abierto, la deja disponible en GitHub para que otros clientes la importen a sus entornos. Al certificar su conector, puede hacer que el conector personalizado que ha creado esté disponible como conector prediseñado en todos los ambientes del cliente. La certificación de un conector requiere ser el propietario de la API o tener permiso explícito para publicar un conector del propietario de la API.
Para obtener más información, consulte el proceso de certificación.
Este paso del proceso es opcional y solo es necesario si desea compartir su conector y tenerlo enumerado como certificado. Los conectores hacia el interior no necesitan completar este proceso de certificación.
Describir el conector
Para definir las acciones y los desencadenadores de un conector, debe describir el conector. Se puede definir un conector personalizado describiendo solo los desencadenadores y las acciones de API que sean necesarios. Por ejemplo, si una API tiene 100 acciones y 10 desencadenadores disponibles, puede crear un conector personalizado con una única acción. También puede describir más a medida que cambien sus necesidades.
Cuando describa la API, utilizará al menos uno de los siguientes enfoques. Si elige importar una definición OpenAPI, seguirá pudiendo manipular manualmente la definición de su conector en el portal.
Crear manualmente en el portal: al usar este enfoque, usaría la documentación de la API y ejemplos de entradas y salidas, y luego definiría cada acción y el desencadenador. Este enfoque es bueno para las API simples en las que no se tiene la capacidad de importar la definición. También puede utilizar este enfoque para refinar las definiciones después de importarlas.
Importar definición de OpenAPI - OpenAPI es una especificación que describe REST, lo que simplifica las tareas de desarrollar y consumir una API y asigna todos los recursos y operaciones que están asociados con ella. Muchos servicios y API publican una definición de OpenAPI; puede importarla para describir la API en el conector personalizado. Se admite la importación de la versión 2.0, pero, actualmente, no se admite la de la versión 3.0. Es un buen método si el editor de API dispone de una definición OpenAPI; si está desarrollando la API, puede publicar una.
Importar desde GitHub: importe conectores desde el repositorio de conectores de Power Platform. Este es el mejor método cuando ya hay un conector publicado en el repositorio y desea importarlo para modificarlo o usarlo como un conector personalizado.
Exportar desde Azure: si su API está creada como Azure App Service o como funciones de Microsoft Azure, o si se administra mediante Microsoft Azure API Management, puede exportar desde esos servicios; la definición inicial de conector personalizado se creará automáticamente.
Trabajar con API autenticadas
La arquitectura de conector personalizado admite el trabajo con API autenticadas. Cuando defina el conector personalizado, identificará cómo debe autenticarse en la API. Las opciones de autenticación admiten el acceso anónimo, protegido con contraseña, OAuth 2.0 y con clave de API.
Sin autenticación: esta opción es para las API que permiten el acceso anónimo y es la predeterminada si no se configura un tipo de autenticación específico.
Autenticación básica: esta opción es para las API que requieren que se envíe un usuario y una contraseña con cada solicitud.
OAuth 2.0 - OAuth 2.0 es el protocolo estándar del sector para la autorización. Esta opción se puede configurar para cualquier API que utilice OAuth 2.0. Las configuraciones predefinidas están disponibles para seleccionarlas para servicios de Microsoft Entra ID, GitHub y Azure DevOps. Están disponibles configuraciones predefinidas similares para otros servicios como Dropbox, Slack, Stripe, etc. Las configuraciones predefinidas simplifican lo que necesita proporcionar para configurar el proveedor de identidades.
Clave de API: una clave de API es un token que proporciona un cliente al realizar llamadas API. El editor de la API normalmente proporciona la clave y debe incluirse en cada solicitud del conector personalizado.
Los conectores personalizados facilitan el uso de las API y los servicios por parte de los creadores de aplicaciones y flujos. Normalmente, los fabricantes podrían invocar directamente la API sin un conector; sin embargo, tendrían que saber cómo redactar la solicitud e interpretar los resultados, y luego manejar la autenticación. Este proceso debería completarse cada vez que la aplicación o el flujo usaran conectores personalizados.
Además, no siempre es fácil para un fabricante lograr la capacidad de tener conectores personalizados que incluyan desencadenadores que permitan que los eventos inicien flujos. Los conectores personalizados le ayudan a descubrir más fácilmente cómo utilizar las acciones y sus resultados al crear una aplicación o un flujo que utiliza el conector.
La siguiente unidad explica cómo crear un conector personalizado.