Configurar SAP Cloud Platform para sistemas on-premises

<< Clic para mostrar Tabla de Contenidos >>

Navegación:  Bizagi Studio > Integrar aplicaciones externas desde Bizagi > Integración con SAP > SAP Cloud Platform usando OData >

Configurar SAP Cloud Platform para sistemas on-premises

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:

 

SAPCloud_4

 

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.

 

SAPCloud_6

 

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).

 

SAPCloud_7

 

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.

 

SAPCloud_8

 

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.

 

SAPCloud_9

 

Haga clic en Guardar y revise el estado de la Subcuenta.

 

SAPCloud_10

 

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 +.

 

SAPCloud_11

 

Seleccione el Sistema ABAP como el Tipo de Back-end.

 

SAPCloud_12

 

Seleccione el Protocolo HTTP o HTTPS según sus necesidades.

 

SAPCloud_13

 

Registre el Host Interno y el Puerto Interno del sistema SAP on-premises.

 

SAPCloud_14

 

Defina el Tipo Principal del sistema como Ninguno.

 

SAPCloud_15

 

Seleccione la opción Usar Host Virtual en el campo Host en Encabezado de Solicitud.

 

SAPCloud_16

 

Registre una descripción y haga clic en Finalizar.

 

SAPCloud_17

 

Sí selecciona la casilla de verificación Accesible, puede ver si el conector Cloud puede acceder a un sistema.

 

SAPCloud_18

 

Ahora cree un nuevo Recurso haciendo clic en el botón +.

 

SAPCloud_19

 

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.

 

SAPCloud_20

 

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.

 

SAPCloud_22

 

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.

 

SAPCloud_23

 

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.

 

SAPCloud_24

 

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.

 

SAPCloud_25

 

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.

 

SAPCloud_26

 

Seleccione el módulo Servicios y haga clic en el Marketplace de Servicios. Busque Autorización y Gestión de Confianza.

 

SAPCloud_27

 

Cree una nueva instancia haciendo clic en el botón Crear Instancia.

 

SAPCloud_28

 

Seleccione el Plan de Servicio aplicación y registre el nombre de la instancia como xsuaa-dispatcher. Luego, haga clic en Siguiente.

 

note_pin

Si cambia el nombre, revise el manifiesto del Paquete de compilación.

 

SAPCloud_29

 

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:

 

SAPCloud_75

 

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.

 

SAPCloud_30

 

4. Configurar el servicio de Destino

En el mismo Cloud Foundry, vuelva a abrir el Marketplace de Servicios. Ahora busque el servicio de Destino.

 

SAPCloud_31

 

Cree una nueva instancia.

 

SAPCloud_32

 

Seleccione el Plan de Servicio lite y registre el nombre de la instancia como destination-dispatcher.

 

note_pin

Si cambia el nombre, revise el manifiesto del Paquete de compilación.

 

SAPCloud_33

 

 

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.

 

SAPCloud_34

 

5. Configurar el servicio de Conectividad

En el mismo Cloud Foundry, vuelva a abrir el Marketplace de Servicios. Ahora busque el servicio de Conectividad.

 

SAPCloud_35

 

Cree una nueva instancia.

 

SAPCloud_36

 

Seleccione el Plan de Servicio lite y registre el nombre de la instancia como connectivity-dispatcher.

 

note_pin

Si cambia el nombre, revise el manifiesto del Paquete de compilación.

 

SAPCloud_37

 

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.

 

SAPCloud_38

 

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.

 

note_pin

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:

 

SAPCloud_76

 

Si intenta acceder a los endpoints del dispatcher sin autenticación, se muestra el siguiente error:

 

SAPCloud_77

 

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.

 

SAPCloud_6

 

Obtenga el endpoint de la API.

 

SAPCloud_7

 

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.

 

SAPCloud_40

 

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:

 

SAPCloud_41

 

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.

 

SAPCloud_47

 

Revise que los nombres de los servicios concuerden con los nombres registrados en el manifesto:

 

SAPCloud_48

 

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

 

SAPCloud_42

 

Finalmente, debe ver que todas las instancias se han iniciado y el Paquete de compilación está instalado correctamente.

 

SAPCloud_43

 

Acceda al Cloud Foundry. En la sección de Espacios, debe ver una aplicación corriendo.

 

SAPCloud_44

 

Si hace clic en el Espacio, puede ver la aplicación instalada.

 

SAPCloud_45

 

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.

 

SAPCloud_46

 

Finalmente, debe hacer clic en el botón de Iniciar y y asegurarse que la aplicación se haya iniciado.

 

SAPCloud_49

 

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:

 

SAPCloud_78

 

La lista de usuarios debería verse así:

 

SAPCloud_79

 

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.