Introducción

En esta publicación de blog, aprenderá a configurar dominios personalizados para el tiempo de ejecución de integración de SAP Integration Suite basado en Cloud Foundry cuando la subcuenta está en el entorno principal de la misma región (p. ej., eu20) y su servicio de Integration Suite se crea para el entorno de extensión ( por ejemplo, eu20-001).

La configuración es un poco diferente en comparación con la documentación disponible en help.sap.com al momento de escribir este blog y la mayoría de los blogs publicados apuntan a la CLI de Cloud Foundry, que no funcionará para esta configuración específica.

Para mantener este blog al grano, el enfoque es proporcionar pasos e información detallados para este caso. La información sobre la obtención de un certificado o la actualización de los registros DNS solo se menciona brevemente.

requisitos previos

Para seguir los pasos explicados, asegúrese de tener o recopilar:

• Acceso de administrador a la subcuenta en la que se ejecuta Integration Suite. Ser capaz de
  • Configurar el administrador de dominio personalizado
  • Autorización de configuración
• SAP Integration Suite está configurado y funcionando. El Launchpad es accesible.
• Autorización del administrador de DNS.
• Autorización del administrador del certificado.

Conocer la diferencia entre extensión y paisaje principal. A continuación se muestra un ejemplo, pero se aplica a todas las regiones admitidas:

• Paisaje principal = eu20
• Paisaje de extensión = eu20-001

Validación del entorno de extensión de Integration Suite

Antes de pasar a los siguientes párrafos de este blog, valide que tiene su subcuenta en otro panorama en comparación con Integration Suite. Esta es una validación fácil:

1. Inicie sesión en la cabina de BTP y navegue hasta la subcuenta que contiene la pestaña de descripción general del servicio Integration Suite y busque el punto final de la API en la sección Cloud Foundry Environment:
2. Abra la aplicación/launchpad de SAP Integration Suite desde la cabina de BTP:
3. En la URL verás el paisaje utilizado:
4. Si ve algo como -000 detrás de la región principal, significa que SAP Integration Suite está utilizando el panorama de extensión de la región. Tenga en cuenta que este es el caso de los proxies de API, los tiempos de ejecución de flujo de integración, pero no tiene por qué ser el caso de la empresa de centro de negocios de API (anteriormente conocido como portal de desarrolladores de API).

Si su subcuenta coincide con la región, incluido el posible -000 para el paquete de integración, el dominio personalizado se puede configurar mediante el procedimiento normal. De lo contrario, siga el resto de este blog.

Pasos de configuración: configuración del administrador de dominio personalizado

Como se mencionó, la CLI de Cloud Foundry con el complemento de dominio personalizado no se puede usar para la configuración del paisaje de extensiones como se describe anteriormente. Custom Domain Manager es una aplicación web basada en la interfaz de usuario disponible en el mercado de servicios de la subcuenta. Para configurar dominios personalizados para las suites de integración en el entorno de extensión cuando la subcuenta está en el entorno principal, siga los pasos a continuación y en mi configuración, Custom Domain Manager está configurado en una de las subcuentas que contienen una SAP Integration Suite:

1. Inicie sesión en la cabina de BTP y navegue hasta la subcuenta que contiene el servicio Integration Suite.
2. En el menú de derechos dentro de la subcuenta, asigne el servicio de dominio personalizado y solo el plan estándar (aplicación):
3. Después de completar la tarea en el servicios->instancias y suscripciones menú crear una instancia para el plan estándar. Después de que se presten los servicios, primero asigne la autorización correcta para usarlos.
4. Se debe crear una colección de roles que contenga los roles y asignarla a la persona que realiza el resto de las actividades:
   • Administrador de dominio personalizado
   • Visor de dominio personalizado
5. Si abre la aplicación, no debería mostrarse ningún mensaje de error. Si este es el caso, esta parte está completa.

Pasos de configuración: configuración de suscripción SaaS de dominio personalizado

El Administrador de dominio personalizado debe estar abierto para realizar los siguientes pasos.

1. Comience agregando un dominio reservado a la aplicación Custom Domain Manager navegando al menú en la parte superior llamado Dominios y haga clic en el botón Agregar dominio reservado. Esto abrirá una ventana emergente para ingresar el dominio para el cual se creará o se creará el certificado a través del Administrador de dominio personalizado.
   • Mi consejo es ingresar el dominio principal incluyendo el subdominio. Si usa un segundo dominio personalizado para la misma región y dominio principal, se encontrará con el error:
2. Después de agregar el dominio reservado en la otra pestaña llamada dominios personalizados, registre el dominio personalizado mediante el botón Crear dominio personalizado y la opción para la suscripción SaaS de su subcuenta:
3. En este paso es muy importante seleccionar la aplicación Integration Suite en el paisaje correcto. No puede usar un dominio personalizado vinculado al paisaje principal para el paisaje de extensión y viceversa:
4. En el siguiente paso del asistente, selecciona el dominio reservado creado en el paso 1 y, si ya especificó el subdominio en el paso 1, puede dejarlo vacío en el último paso del asistente. Si todo va bien, debería mostrarse una entrada en la pestaña de dominio personalizado, similar a la siguiente:
5. Antes de configurar TLS y el certificado del servidor, se debe crear una ruta SaaS. En el menú superior, navegue hasta Rutas SaaS y si primero configura el enrutamiento SaaS para el servicio SAP Integration Suite en la misma subcuenta, puede dejar la casilla de verificación Continuar con la lista de suscripciones de la subcuenta actual seleccionado. Si configura el Administrador de dominio personalizado en otra subcuenta, asegúrese de haber seleccionado el panorama de extensión correcto para el dominio personalizado como se describe en el paso 3. Proporcione el TenantID de la otra subcuenta disponible en el menú Descripción general de la subcuenta. Después de proporcionarlo y encontrar un paisaje coincidente, se podrá hacer clic en el botón del siguiente paso y podrá seleccionar el paquete de integración para vincularlo. Para posibles problemas, consulte la sección de resolución de problemas de este blog.
6. Actualice la ruta estándar a la URL de tiempo de ejecución; de lo contrario, no se podrá llamar a los puntos finales/iFlow a través de esta configuración. La URL de tiempo de ejecución se puede encontrar en el menú de monitoreo de la suite de integración y navegar a un artefacto implementado que contiene, por ejemplo, un adaptador HTTP:
7. Después de seleccionar un nombre de host para la ruta, debe completarse para la parte de la ruta Saas. Para poder utilizar el dominio personalizado, debe crear un registro TLS y un certificado de servidor. El certificado del servidor se crea desde Custom Domain Manager a través del procedimiento CSR, lo que significa que no puede utilizar un certificado ya existente. La documentación estándar se puede seguir con algunas pequeñas adiciones:
   • Asigne a la configuración de TLS un nombre sensato. Usé el dominio personalizado completo, incluido el subdominio, y lo arreglé con: tls. El resto es seguir al asistente.
   • Para el Certificado de servidor utilicé un certificado comodín específico para este fin. Esto tiene la ventaja de que si en el futuro se agrega un entorno adicional de SAP Integration Suite, el certificado no tiene que cambiarse en relación con los nombres SAN activados para él en comparación con si crea el certificado específico para el Dominios personalizados Rutas SaaS. El certificado tiene la estructura *.[subdomain].[maindomain].[extension] en el que la estrella será el nombre de host para el tiempo de ejecución de Integration Suite.
8. Si se completan los pasos anteriores, el último paso es crear la asignación CNAME en el proveedor de DNS. Para este paso, es importante hacer el mapeo de CNAME hacia el paisaje de extensión correcto. En la documentación de help.sap.com al momento de escribir este blog, se indica que se use el extremo de la API desde la subcuenta como se describe en el paso 1 en la sección Validación del entorno de extensión de Integration Suite pero necesita reflejar el panorama de la extensión. Para evitar errores:En el cambio de mapeo CNAME como ejemplo:
   • Desde principal: api.cf.eu20.hana.ondemand.com
   • A la extensión: api.cf.eu20-001.hana.ondemand.com

Se le informará después de que el dominio personalizado esté activo, la activación del enrutamiento demorará un máximo de 24 horas, aún puede usar el dominio predeterminado para los puntos finales de integración. La única excepción es la URL del token de OAuth (autenticación), esta solo está disponible con el dominio SAP estándar como se describe en la nota 3291485.

La posible solución para la URL de OAuth si se usa la administración de API es crear un proxy de API con un dominio personalizado y usar el punto final del token de OAuth de integración como destino para que no tenga que usar el dominio estándar.

Solución de problemas

Durante la configuración me encontré con múltiples desafíos. Traté de enumerarlos todos a continuación en orden aleatorio:

• CLI de Cloud Foundry: no se admite para la situación, al menos no para el enrutamiento, etc. Si intenta crear una ruta SaaS para Integration Suite cuando creó un dominio personalizado para la organización CF (para fines reutilizables), arrojará el siguiente error:
• CLI de Cloud Foundry: no se pueden enumerar dominios para un entorno que no sea el punto final de la API proporcionado en la subcuenta. En el punto final de la API proporcionado en la subcuenta, indicará que no hay dominios configurados y si intenta usar el panorama de extensiones, recibirá un mensaje de error no autorizado.
• CLI de Cloud Foundry: compartir certificados de dominios personalizados solo es posible dentro del mismo entorno. No puede compartir paisajes en la misma región, por ejemplo, eu20 y eu20-001.
• Administrador de dominio personalizado: el dominio personalizado creado para la organización de CF en el entorno principal (eu20) no puede vincularse con servicios en subcuentas en el entorno de extensión (eu20-001). Si intenta crear una ruta SaaS para otra suscripción de subcuentas después de ingresar el TenandID, recibirá este mensaje de error genérico:
• Administrador de dominio personalizado: en primer lugar, la configuración del dominio personalizado en nuestra organización se realizó en otra subcuenta que no contenía una suite de integración o un servicio en el entorno de extensión y, al crear un dominio personalizado para su organización CF o Suscripción SaaS, solo puede seleccionar el entorno vinculado. la subcuenta (organización CF) o para las Suscripciones SaaS en la misma subcuenta. Actualmente se requiere utilizar un dominio personalizado en la misma subcuenta que la de los entornos de la suite de integración.

Conclusión

Cuando se conocen los pasos para obtener la configuración de dominios personalizados para Integration Suite en la situación mencionada en este blog, es bastante fácil y directo. Parece que encontré una situación que no es tan común y especialmente en combinación con dominios personalizados.

Documentación y enlaces

Si desea leer más información sobre dominios personalizados y la configuración que requiere para otros casos, le recomiendo leer la siguiente información útil:

Si tiene preguntas o comentarios, sea tan amable de dejar un comentario. Se agradece un like.