Creación y administración de cuentas de integración para flujos de trabajo B2B en Azure Logic Apps con Enterprise Integration Pack
Se aplica a: Azure Logic Apps (consumo + estándar)
Para poder crear flujos de trabajo de integración de negocio a negocio (B2B) y de empresa mediante Azure Logic Apps, debe crear un recurso de cuenta de integración. Esta cuenta es un contenedor escalable basado en la nube en Azure que simplifica la forma de almacenar y administrar artefactos B2B que se definen y usan en los flujos de trabajo de escenarios B2B, por ejemplo:
También necesita una cuenta de integración para intercambiar electrónicamente mensajes B2B con otras organizaciones. Cuando otras organizaciones usen protocolos y formatos de mensaje diferentes de los que usa su organización, debe convertir estos formatos para que el sistema de su organización pueda procesar esos mensajes. Con Azure Logic Apps, puede crear flujos de trabajo que admitan los siguientes protocolos estándar del sector:
En esta guía se muestra cómo completar las tareas siguientes:
- Crear una cuenta de integración.
- Configurar el acceso de almacenamiento para una cuenta de integración Premium.
- Vincular la cuenta de integración a un recurso de una aplicación lógica.
- Cambiar el plan de tarifa de la cuenta de integración.
- Vincular la cuenta de integración a un recurso de una aplicación lógica.
- Mover una cuenta de integración a otra suscripción o grupo de recursos de Azure.
- Eliminar una cuenta de integración.
Si no está familiarizado con la creación de flujos de trabajo de integración empresarial B2B en Azure Logic Apps, consulte Flujos de trabajo de integración empresarial B2B con Azure Logic Apps y Enterprise Integration Pack.
Requisitos previos
Una cuenta y una suscripción de Azure. Si no tiene una suscripción de Azure, regístrese para obtener una cuenta gratuita de Azure. Asegúrese de que usa la misma suscripción de Azure para la cuenta de integración y para el recurso de aplicación lógica.
Si está trabajando en un flujo de trabajo de aplicación lógica de consumo o en uno estándar, el recurso de la aplicación lógica ya debe existir antes de vincular la cuenta de integración.
Para los recursos de una aplicación lógica de consumo, este vínculo es necesario para poder usar los artefactos de la cuenta de integración con el flujo de trabajo. Aunque puede crear los artefactos sin este vínculo, este será necesario cuando esté listo para usar estos artefactos.
En el caso de los recursos de una aplicación lógica estándar, este vínculo es opcional en función del escenario:
Si tiene una cuenta de integración con los artefactos que necesita o quiere usar, puede vincular la cuenta de integración a cada recurso de la aplicación lógica estándar en los que desee utilizar los artefactos.
Algunos conectores de cuentas de integración hospedadas en Azure, como AS2, EDIFACT y X12, le permiten crear una conexión a la cuenta de integración. Si solo usa estos conectores, no necesita el vínculo.
Los conectores integrados denominados Liquid y Archivo sin formato permiten seleccionar mapas y esquemas que haya cargado previamente en el recurso de aplicación lógica o en una cuenta de integración vinculada.
Si no tiene o no necesita una cuenta de integración, puede usar la opción de carga. De lo contrario, puede usar la opción de vinculación, lo que también significa que no tendrá que cargar mapas y esquemas en cada recurso de la aplicación lógica. En cualquier caso, puede usar estos artefactos en todos los flujos de trabajo secundarios dentro del mismo recurso de la aplicación lógica.
Conocimientos básicos sobre cómo crear flujos de trabajo de aplicaciones lógicas. Para más información, consulte la siguiente documentación:
Creación de una cuenta de integración
Las cuentas de integración están disponibles en distintos niveles con precios variables. En función del nivel que elija, la creación de una cuenta de integración podría generar costos. Para más información, vea Modelos de precios y facturación en Azure Logic Apps y Precios de Azure Logic Apps.
En función de sus requisitos y escenarios, determine el nivel de cuenta de integración adecuado para crear. En la tabla siguiente se describen los niveles disponibles:
La cuenta de integración usa una identidad administrada asignada por el sistema creada y habilitada automáticamente para autenticar el acceso.
| Nivel | Descripción |
|---|---|
| Premium (versión preliminar) | Nota:Esta funcionalidad está en versión preliminar y está sujeta a las Condiciones de uso complementarias para las versiones preliminares de Microsoft Azure. Para escenarios con los siguientes criterios: - Almacenar y usar artefactos ilimitados, como asociados, contratos, esquemas, mapas, certificados, etc. - Traer y usar su propio almacenamiento, que contiene los estados de tiempo de ejecución pertinentes para acciones B2B específicas y estándares EDI. Por ejemplo, estos estados incluyen el número MIC para las acciones AS2 y los números de control de las acciones X12, si están configurados en los contratos. Para acceder a este almacenamiento, la cuenta de integración usa su identidad administrada asignada por el sistema, que se crea y habilita automáticamente para la cuenta de integración. También puede aplicar más directivas y gobernanza a los datos, como las claves administradas por el cliente ("Bring Your Own") para el cifrado de datos. Para almacenar estas claves, necesitará un almacén de claves. - Configurar y usar un almacén de claves para almacenar certificados privados o claves administradas por el cliente. Para acceder a estas claves, la cuenta de integración Premium usa su identidad administrada asignada por el sistema, no una entidad de servicio compartida de Azure Logic Apps. Los precios siguen los precios de la cuenta de integración estándar. Nota: Durante la versión preliminar, la factura de Azure usa el mismo nombre y identificador de medidor que una cuenta de integración estándar, pero cambia cuando el nivel Premium está disponible con carácter general. Limitaciones y problemas conocidos: - Actualmente no admite redes virtuales. - Si usa un almacén de claves para almacenar certificados privados, es posible que la identidad administrada de la cuenta de integración no funcione. Por ahora, use la identidad administrada de la aplicación lógica vinculada en su lugar. - Actualmente no admite la CLI de Azure para Azure Logic Apps. |
| Estándar | Para los escenarios en los que se tienen relaciones B2B más complejas y un número mayor de entidades que debe administrar. Compatible con el Acuerdo de Nivel de Servicio de Azure Logic Apps. |
| Basic | Para los escenarios en los que quiere utilizar solo el control de mensajes o actuar como un asociado de pequeña empresa que tiene una relación empresarial con una entidad empresarial mayor. Compatible con el Acuerdo de Nivel de Servicio de Azure Logic Apps. |
| Gratis | Para escenarios de exploración, no en escenarios de producción. Este nivel tiene límites en cuanto a disponibilidad, rendimiento y uso de regiones. Por ejemplo, el nivel Gratis solo está disponible para regiones públicas de Azure, por ejemplo, el Oeste de EE. UU. o el Sudeste Asiático, pero no para Microsoft Azure operado por 21Vianet o Azure Government. Nota: No compatible con el Acuerdo de Nivel de Servicio de Azure Logic Apps. |
En esta tarea, puede usar Azure Portal, la CLI de Azure o Azure PowerShell.
Importante
Para que pueda vincular y usar correctamente la cuenta de integración con la aplicación lógica, asegúrese de que ambos recursos existen en la misma suscripción y región de Azure.
En el cuadro de búsqueda de Azure Portal, escriba cuentas de integración y seleccione Cuentas de integración.
En Cuentas de integración, seleccione Crear.
En el panel Crear una cuenta de integración, proporcione la siguiente información sobre la cuenta de integración:
Propiedad Necesario Valor Descripción Suscripción Sí <Azure-subscription-name> El nombre de la suscripción a Azure Grupos de recursos Sí <nombre del grupo de recursos de Azure> Nombre del grupo de recursos de Azure que se va a usar para organizar recursos relacionados. Para este ejemplo, cree un grupo de recursos denominado FabrikamIntegration-RG. Nombre de la cuenta de integración Sí <integration-account-name> El nombre de la cuenta de integración, que solo puede contener letras, números, guiones ( -), caracteres de subrayado (_), paréntesis (()) y puntos (.). En este ejemplo se usa Fabrikam-Integration.Plan de tarifa Sí <pricing-level> Plan de tarifa de la cuenta de integración, que puede cambiar más adelante. En este ejemplo, seleccione Gratis. Para más información, revise la siguiente documentación:
- Modelo de precios de Logic Apps
- Límites y configuración de Logic Apps
- Precios de Logic AppsCuenta de almacenamiento Disponible solo para la cuenta de integración Premium (versión preliminar) Ninguno El nombre para una cuenta de almacenamiento de Azure existente. En el ejemplo de esta guía, esta opción no se aplica. Región Sí <Azure-region> Región de Azure en la que quiere almacenar los metadatos de la cuenta de integración. Seleccione la misma ubicación que el recurso de la aplicación lógica o cree las aplicaciones lógicas en la misma ubicación que la cuenta de integración. En este ejemplo, use Oeste de EE. UU.
Para usar su cuenta de integración con un entorno de servicio de integración (ISE), seleccione Asociar con el entorno de servicio de integración y seleccione su ISE como ubicación. Para crear una cuenta de integración desde dentro de un ISE, consulte Creación de cuentas de integración desde dentro de un ISE.
Nota: Se retirará el recurso ISE el 31 de agosto de 2024, debido a su dependencia de Azure Cloud Services (clásico), que se retirará al mismo tiempo. Actualmente en versión preliminar, la funcionalidad está disponible para exportar una cuenta de integración Estándar para un ISE a una cuenta de integración Premium.Habilitación de análisis de registros No No seleccionado En este ejemplo, no seleccione esta opción. Seleccione Revisar y crear cuando haya terminado.
Una vez completada la implementación, Azure abre la cuenta de integración.
Si ha creado una cuenta de integración Premium, asegúrese de configurar el acceso a la cuenta de Azure Storage asociada.
Configuración del acceso de almacenamiento para la cuenta de integración Premium
Para leer artefactos y escribir cualquier información de estado, la cuenta de integración Premium necesita acceso a la cuenta de almacenamiento de Azure seleccionada y asociada. La cuenta de integración usa su identidad administrada asignada por el sistema creada y habilitada automáticamente para autenticar el acceso.
En el Azure Portal, abra la cuenta de integración Premium.
En el menú de la cuenta de integración, en Configuración, seleccione Identidad.
En la pestaña Asignado por el sistema, que muestra la identidad administrada asignada por el sistema habilitada, en Permisos, seleccione Asignaciones de roles de Azure.
En la barra de herramientas asignaciones de roles de Azure, seleccione Agregar asignación de roles (versión preliminar), proporcione la siguiente información, seleccione Guardar y, a continuación, repita para cada rol necesario:
Parámetro valor Descripción Ámbito Storage Para obtener más información, vea Descripción del ámbito de Azure RBAC. Suscripción <Azure-subscription> La suscripción de Azure al recurso al que se va a acceder. Recurso <Azure-storage-account-name> Nombre de la cuenta de almacenamiento de Azure a la que se va a acceder.
Nota Si recibe un error que no tiene permisos para agregar asignaciones de roles en este ámbito, debe obtener esos permisos. Para más información, consulte Roles integrados de Microsoft Entra.Rol - Colaborador de la cuenta de almacenamiento
- Colaborador de datos de blobs de almacenamiento
- Colaborador de datos de la tabla de almacenamientoLos roles que la cuenta de integración Premium requiere para acceder a la cuenta de almacenamiento. Para más información, consulte Asignación de un rol de Azure a una identidad administrada asignada por el sistema
A continuación, vincule la cuenta de integración al recurso de la aplicación lógica.
Vincular a la aplicación lógica
Para que pueda vincular correctamente la cuenta de integración con el recurso de la aplicación lógica, asegúrese de que ambos recursos usan la misma suscripción y región de Azure.
En esta sección se describe cómo completar esta tarea mediante Azure Portal. Si usa Visual Studio y la aplicación lógica está en un proyecto de grupo de recursos de Azure, puede vincular la aplicación lógica a una cuenta de integración mediante Visual Studio.
En Azure Portal, abra el recurso de aplicación lógica.
En el menú de navegación de la aplicación lógica, en Configuración, seleccione Configuración de flujo de trabajo. En Cuenta de integración, abra la lista Select an Integration account (Seleccionar una cuenta de integración), y seleccione la cuenta de integración deseada.
Para finalizar la vinculación, seleccione Guardar.
Una vez que la cuenta de integración se haya vinculado correctamente, Azure muestra un mensaje de confirmación.
Ahora, el flujo de trabajo de la aplicación lógica puede usar los artefactos de la cuenta de integración, además de conectores B2B, como la validación XML y la codificación o descodificación de archivos sin formato.
Cambiar el plan de tarifa
Para aumentar los límites de una cuenta de integración, puede actualizar a un plan de tarifa superior, si está disponible. Por ejemplo, puede actualizar del nivel Gratis al nivel básico, el estándar o el premium. También puede cambiar a un nivel inferior, si está disponible. Para más información sobre los precios, revise la siguiente documentación:
Actualización del plan de tarifa
Para realizar este cambio, puede usar Azure Portal o la CLI de Azure.
En el cuadro de búsqueda de Azure Portal, escriba cuentas de integración y seleccione Cuentas de integración.
Azure muestra todas las cuentas de integración en las suscripciones de Azure.
En Cuentas de integración, seleccione la cuenta de integración que quiera mover. En el menú del recurso de la cuenta de integración, seleccione Información general.
En la página de Información general, seleccione Actualizar plan de tarifa, donde se enumeran todos los niveles superiores disponibles. Al seleccionar un nivel, el cambio surte efecto de inmediato.
Cambio del plan de tarifa a un nivel inferior
Para cambiarlo, use la CLI de Azure.
Si aún no lo ha hecho, instale los requisitos previos de la CLI de Azure.
En Azure Portal, abra el entorno de Azure Cloud Shell.
En el símbolo del sistema, escriba el comando az resource y establezca
skuNameen el nivel inferior que quiera.az resource update --resource-group <resourceGroupName> --resource-type Microsoft.Logic/integrationAccounts --name <integrationAccountName> --subscription <AzureSubscriptionID> --set sku.name=<skuName>Por ejemplo, si tiene el nivel estándar, puede establecer
skuNameenBasic:az resource update --resource-group FabrikamIntegration-RG --resource-type Microsoft.Logic/integrationAccounts --name Fabrikam-Integration --subscription XXXXXXXXXXXXXXXXX --set sku.name=Basic
Desvinculación de aplicación lógica
Si quiere vincular la aplicación lógica a otra cuenta de integración o dejar de usar una cuenta de integración con la aplicación lógica, elimine el vínculo mediante Azure Resource Explorer.
Abra la ventana del explorador y vaya a Azure Resource Explorer (https://resources.azure.com). Inicie sesión con las mismas credenciales de la cuenta de Azure.
En el cuadro de búsqueda, escriba el nombre de la aplicación lógica y abra la aplicación lógica.
En la barra de título del explorador, seleccione Lectura/escritura.
En la pestaña Datos, seleccione Editar.
En el editor, busque el objeto integrationAccount, que tiene el formato siguiente y elimine el objeto:
{ // <other-attributes> "integrationAccount": { "name": "<integration-account-name>", "id": "<integration-account-resource-ID>", "type": "Microsoft.Logic/integrationAccounts" }, }Por ejemplo:
En la pestaña Datos, seleccione Colocar para guardar los cambios.
Abra la aplicación lógica en Azure Portal. En el menú de la aplicación lógica, en Configuración del flujo de trabajo, asegúrese de que la propiedad Cuenta de integración aparece ahora vacía.
Mover la cuenta de integración
Puede mover la cuenta de integración a otro grupo de recursos de Azure o suscripción a Azure. Al mover recursos, Azure crea nuevos identificadores de recurso, por lo que debe asegurarse de usar los nuevos identificadores en su lugar y actualizar los scripts o las herramientas asociados a los recursos que ha movido. Si quiere cambiar la suscripción, también debe especificar un grupo de recursos nuevo o existente.
Para esta tarea, puede usar Azure Portal si sigue los pasos de esta sección o la CLI de Azure.
En el cuadro de búsqueda de Azure Portal, escriba cuentas de integración y seleccione Cuentas de integración.
Azure muestra todas las cuentas de integración en las suscripciones de Azure.
En Cuentas de integración, seleccione la cuenta de integración que quiera mover. En el menú de la cuenta de integración, seleccione Información general.
En el panel Información general, junto a Grupo de recursos o Nombre de suscripción, seleccione cambiar.
Seleccione los recursos relacionados que también quiera mover.
En función de lo que seleccione, siga estos pasos para cambiar el grupo de recursos o la suscripción:
Grupo de recursos: En la lista Grupo de recursos, seleccione el grupo de recursos de destino. O bien, para crear otro grupo de recursos, seleccione Crear un nuevo grupo de recursos.
Suscripción: En la lista Suscripción, seleccione la suscripción de destino. En la lista Grupo de recursos, seleccione el grupo de recursos de destino. O bien, para crear otro grupo de recursos, seleccione Crear un nuevo grupo de recursos.
Para confirmar que comprende que los scripts o las herramientas asociados a los recursos que se han movido no funcionarán hasta que los actualice con los nuevos identificadores de recurso, seleccione el cuadro de confirmación y después seleccione Aceptar.
Cuando finalice, asegúrese de actualizar todos los scripts con los nuevos identificadores de los recursos que ha movido.
Eliminar una cuenta de integración
Para esta tarea, puede usar Azure Portal si sigue los pasos de esta sección, la CLI de Azure o Azure PowerShell.
En el cuadro de búsqueda de Azure Portal, escriba cuentas de integración y seleccione Cuentas de integración.
Azure muestra todas las cuentas de integración en las suscripciones de Azure.
En Cuentas de integración, seleccione la cuenta de integración que quiera eliminar. En el menú de la cuenta de integración, seleccione Información general.
En la página Información general, seleccione Eliminar.
Para confirmar que quiere eliminar la cuenta de integración, seleccione Sí.
