Introducción
Bizagi utiliza SAP Cloud Platform como una herramienta de integración para establecer una conexión entre Bizagi y el sistema on-premises SAP S/4 HANA. Este artículo explica cómo realizar las configuraciones necesarias para la integración (como el conector de SAP Cloud y los diferentes servicios de SAP) dentro de SAP Cloud Platform.
Servicios SAP
Los servicios necesarios se describen de acuerdo con el siguiente flujo:
1.Enrutador (Router): Cuando Bizagi llama a SAP Cloud Platform, se redirige al Router, que es el punto de entrada para todas las aplicaciones de negocio.
2.Autorización y Confianza (Authorization and Trust): Como capa de seguridad, SAP brinda un servicio de autorización para que Bizagi pueda obtener un token de autorización para realizar invocaciones de funciones de SAP. Si la autenticación falla, Bizagi muestra un error enviado por el servicio de Autorización y Confianza.
3.Paquete de compilación (Buildpack): Para obtener la ruta adecuada al sistema on-premises, existe un servicio de destino que contiene la información de la ubicación del sistema on-premises de SAP. Una vez que el Paquete de compilación obtiene la información de destino, utiliza el servicio de Conectividad para establecer una conexión segura. Este servicio permite determinar las dependencias para descargar, construir y ejecutar la aplicación.
4.Destino (Destination): Este servicio contiene la información de la configuración del backend del sistema SAP.
5.Conectividad (Connectivity): Este servicio establece una conexión entre SAP Cloud Platform y sus sistemas SAP con redes aisladas.
6.Conector Cloud: Es un enlace con sistemas on-premises para que la SAP Cloud Platform y sus servicios pueden acceder a través del conector. Para más información, consulte la documentación del SAP Cloud Connector.
El siguiente diagrama muestra el flujo descrito:
Requisitos
Antes de comenzar a realizar configuraciones en SAP Cloud Platform, verifique que tenga:
1. Configurado el SAP Cloud Foundry. Para más información, consulte Cuenta empresarial en un ambiente Cloud Foundry.
2. Una instancia del conector SAP Cloud Connector. Para más información, consulte la Guía de instalación del Cloud Connector.
3. Un sistema SAP S/4 HANA, ECC o R/3 on-premises con la capa OData expuesta.
4. Instalada la interfaz de línea de comandos (CLI) de Cloud Foundry. Para obtener más información sobre el proceso de instalación, consulte el artículo Cómo instalar la CLI.
Pasos de configuración
1. Configurar el conector Cloud
2. Definir una nueva configuración de Destino para el sistema SAP
3. Configurar el servicio de Autorización y Confianza
4. Configurar el servicio de Destino
5. Configurar el servicio de Conectividad
6. Instalar el Enrutador y el Paquete de compilación
1. Configurar el conector Cloud
Obtenga la información de su Subcuenta de Cloud Foundry. Acceda a la cabina (cockpit) Cloud Platform y haga clic en su Subcuenta.
Obtenga la siguiente información:
•ID de la Subcuenta.
•Región del endpoint de su API: Por ejemplo, esta está ubicada en US East (VA) - AWS (ver la imagen superior).
Ahora, acceda al conector Cloud (usualmente ubicado en http://localhost:8443). En el panel izquierdo, haga clic en el módulo Conector y luego en el botón Agregar Subcuenta.
Registre la siguiente información:
•Región: Región del endpoint de la API obtenida de la cabina SAP Cloud Platform.
•ID de la Subcuenta: ID de la subcuenta de Cloud Platform obtenida en la cabina.
•Nombra para mostrar: Cualquier nombre para mostrar de la conexión a la Subcuenta.
•E-mail de acceso: correo electrónico para acceder a la SAP Cloud Platform.
•Contraseña: Contraseña del usuario con acceso a la SAP Cloud Platform.
Haga clic en Guardar y revise el estado de la Subcuenta.
En el sitio del conector Cloud, debajo de la Subcuenta creada, haga clic en el módulo Cloud A On-Premise y luego agregue un nuevo sistema con el icono +.
Seleccione el Sistema ABAP como el Tipo de Back-end.
Seleccione el Protocolo HTTP o HTTPS según sus necesidades.
Registre el Host Interno y el Puerto Interno del sistema SAP on-premises.
Defina el Tipo Principal del sistema como Ninguno.
Seleccione la opción Usar Host Virtual en el campo Host en Encabezado de Solicitud.
Registre una descripción y haga clic en Finalizar.
Sí selecciona la casilla de verificación Accesible, puede ver si el conector Cloud puede acceder a un sistema.
Ahora cree un nuevo Recurso haciendo clic en el botón +.
Incluya el endpoint de OData de su sistema SAP on-premises en el campo Ruta URL.
/sap/opu/odata
Seleccione la Política de Acceso Ruta Y Todas Las Sub-Rutas.
Definir el destino on-premises en el Cloud Foundry
El servicio de Destino en SAP almacena las diferentes configuraciones de servicios a los que desea acceder desde SAP Cloud Platform. Por lo tanto, debe registrar la información relacionada con su sistema on-premises.
Como administrador de Cloud Platform, debe acceder a la cabina de SAP Cloud Platform, abrir el módulo Conectividad, seleccionar Destinos y hacer clic en el botón Nuevo Destino.
Registre la siguiente información:
•Nombre: nombre del nuevo destino.
•Tipo: seleccione el Protocolo HTTP o HTTPS según sus necesidades.
•URL: URL del Host Virtual del sistema on-premises con Puerto Virtual.
•Tipo de Proxy: seleccione OnPremise.
•Autenticación: seleccione la opción BasicAuthentication.
•Usuario: nombre de usuario del usuario del sistema on-premises.
•Contraseña: contraseña del usuario del sistema on-premises.
Haga clic en Guardar. Una vez registrado el destino, verifique la conexión haciendo clic en el botón Verificar Conexión.
2. Definir una nueva configuración de Destino para el sistema SAP
Un Destino en SAP contiene la configuración del sistema backend para que la SAP Cloud Platform puede tener la información para acceder a este. Para configurar un Destino, acceda a la cabina de SAP Cloud Platform, seleccione su Subcuenta, abra el módulo Conectividad, seleccione Destinos y haga clic en el botón Nuevo destino.
Registre los siguientes parámetros:
•Nombre: nombre del nuevo destino. Si tiene múltiples sistemas, asegúrese de dar un nombre claro.
•Tipo: seleccione el Protocolo HTTP o HTTPS según sus necesidades, como la conexión al sistema on-premises. El servicio de Conectividad y el conector SAP Cloud Connector utilizan conexiones HTTP o HTTPS.
•Descripción: breve desripción del destino.
•URL: este debe ser el Host Virtual del conector Cloud (configurado previamente). Para más información, consulte Configurar el conector Cloud.
•Tipo de Proxy: seleccione OnPremise.
•Autenticación: debe seleccionar el mismo tipo de autenticación definido en el conector Cloud para OData. Por lo tanto, seleccione la opción BasicAuthentication.
•Usuario: usuario de su servicio SAP con permiso de acceso a los servicios OData.
•Contraseña: contraseña del usuario SAP.
Haga clic en Guardar y pruebe la conexión.
3. Configurar el servicio de Autorización y Confianza
En SAP Cloud Platform, seleccione Cloud Foundry, abra los Espacios y seleccione el espacio de Foundry.
Seleccione el módulo Servicios y haga clic en el Marketplace de Servicios. Busque Autorización y Gestión de Confianza.
Cree una nueva instancia haciendo clic en el botón Crear Instancia.
Seleccione el Plan de Servicio aplicación y registre el nombre de la instancia como xsuaa-dispatcher. Luego, haga clic en Siguiente.
|
Si cambia el nombre, revise el manifiesto del Paquete de compilación. |
En el paso número dos, ingrese un JSON con la siguiente configuración:
{
"xsappname": "sapapp",
"tenant-mode": "dedicated",
"oauth2-configuration": {
"redirect-uris": [
"https://build.bizagi.com/redirectOauth2.html"
]
}
}
La configuración se debería ver de la siguiente manera:
El redirect URI corresponde al URL de callback de Bizagi para recibir los datos de autenticación con el protocolo OAuth 2.0.
En el paso tres, revise toda la información y haga clic en el botón Crear instancia. Una vez creada la instancia, puede revisarla en el módulo Instancias de Servicio.
4. Configurar el servicio de Destino
En el mismo Cloud Foundry, vuelva a abrir el Marketplace de Servicios. Ahora busque el servicio de Destino.
Cree una nueva instancia.
Seleccione el Plan de Servicio lite y registre el nombre de la instancia como destination-dispatcher.
|
Si cambia el nombre, revise el manifiesto del Paquete de compilación. |
En el paso número dos, no cargue ningún JSON. Déjelo vacío y haga clic en Siguiente. En el paso tres, revise toda la información y haga clic en el botón Crear instancia. Una vez creada la instancia, puede revisarla en el módulo Instancias de Servicio.
5. Configurar el servicio de Conectividad
En el mismo Cloud Foundry, vuelva a abrir el Marketplace de Servicios. Ahora busque el servicio de Conectividad.
Cree una nueva instancia.
Seleccione el Plan de Servicio lite y registre el nombre de la instancia como connectivity-dispatcher.
|
Si cambia el nombre, revise el manifiesto del Paquete de compilación. |
En el paso número dos, no cargue ningún JSON. Déjelo vacío y haga clic en Siguiente. En el paso tres, revise toda la información y haga clic en el botón Crear instancia. Una vez creada la instancia, puede revisarla en el módulo Instancias de Servicio.
6. Instalar el Enrutador y el Paquete de compilación
El Paquete de compilación contiene un módulo JavaScript que integra todos los servicios previamente configurados. Este Paquete de compilación es desarrollado por Bizagi y debe estar instalado en su SAP Cloud Platform. Antes de instalar el paquete, usted debe haber:
•Descargado y descomprimido el archivo dispatcher de Bizagi.
|
Para garantizar que descargue la última versión del archivo del dispatcher de Bizagi, asegúrese de limpiar el caché del navegador. |
•Instalado la Interfaz de Línea de Comandos (CLI) de Cloud Foundry. Para obtener más información sobre el proceso de instalación, consulte el artículo Cómo instalar la CLI.
•Obtenido el URL de Cloud Foundry.
•Revisado el manifiesto del Paquete de compilación, asegurándose de que los nombres de los servicios sean los mismos instalados en SAP Cloud Foundry.
Al probar el estado del dispatcher debería ver lo siguiente:
Si intenta acceder a los endpoints del dispatcher sin autenticación, se muestra el siguiente error:
Obtenga el URL del Cloud Foundry
Para ejecutar la Interfaz de Línea de Comandos (CLI), debe obtener el URL de Cloud Foundry donde instalará el Paquete de compilación. Acceda a la cabina de SAP Cloud Platform y seleccione su Subcuenta.
Obtenga el endpoint de la API.
Abra la CLI del Cloud Foundry y conéctese usando el siguiente comando:
cf login -a <URL>
Donde <URL> es el endpoint de la API obtenido previamente.
Se le pide que registre el correo electrónico y la contraseña de un usuario con permisos de administrador en Cloud Foundry. Una vez autenticado, el comando tiene el siguiente aspecto:
Revise el manifesto del Paquete de compilación
En la carpeta donde descomprime el Paquete de compilación de Bizagi, puede encontrar el manifiesto. Este manifiesto es un archivo YAML que contiene el nombre de los servicios de SAP Cloud Foundry que son usados en la integración en la nube.
Revise que los nombres de los servicios concuerden con los nombres registrados en el manifesto:
Instale el Paquete de compilación de Bizagi en su SAP Cloud Platform
En el mismo símbolo del sistema, cambie el directorio a la carpeta donde descomprimió el archivo del dispatcher de Bizagi. Ejecute el siguiente comando:
cf push
Finalmente, debe ver que todas las instancias se han iniciado y el Paquete de compilación está instalado correctamente.
Acceda al Cloud Foundry. En la sección de Espacios, debe ver una aplicación corriendo.
Si hace clic en el Espacio, puede ver la aplicación instalada.
Al hacer clic en la aplicación, puede ver los detalles de la aplicación Bizagi instalada en Cloud Foundry. Es importante guardar la Ruta de la Aplicación.
Finalmente, debe hacer clic en el botón de Iniciar y y asegurarse que la aplicación se haya iniciado.
Siguientes pasos
1. Configurar el conector de SAP Cloud Platform en Bizagi
2. Definir el proceso donde quiere ejecutar una acción de SAP
Seguridad
Los usuarios habilitados para autenticarse son los que están configurados para la Subcuenta en la sección Usuarios dentro de Seguridad:
La lista de usuarios debería verse así:
Para que el usuario pueda autenticarse con OAuth 2.0 desde Bizagi, debe estar incluido en SAP con un SAP Universal ID. Si no se ha registrado, puede obtener el ID en el enlace Crear cuentas de usuarios SAP o registrarse con SAP Universal ID.
Solución de problemas
En los procedimientos de instalación del dispatcher se debe hacer uso de la CLI de Cloud Foundry. Si al realizar el cf push para aprovisionar el dispatcher en el Espacio de Cloud Foundry obtiene un error similar al siguiente:
Applying manifest file [Ruta local dispatcher]\manifest.yml... For application 'bizaginodedispatcher': Routes cannot be mapped to destinations in different spaces
Debe modificar la propiedad name dentro del archivo manifest.yml.