Instala y configura la edición SAP BTP del SDK de ABAP para Google Cloud

En este documento, se describe cómo instalar y configurar la edición SAP BTP del SDK de ABAP para Google Cloud en el entorno de SAP BTP, ABAP.

Este documento va dirigido a los administradores de SAP, los administradores de Google Cloud y otros profesionales de seguridad de SAP y Google Cloud.

Descripción general

El SDK de ABAP para Google Cloud proporciona bibliotecas cliente en forma de clases ABAP para que los desarrolladores accedan a las APIs de Google Cloud de manera programática. A través del encapsulamiento de funciones esenciales, como la seguridad, la autenticación, la serialización y deserialización de datos, y el manejo de errores como componentes reutilizables, estas bibliotecas cliente reducen la cantidad de código que los desarrolladores deben escribir. Si deseas obtener una lista completa de las bibliotecas cliente que proporciona el SDK de ABAP para Google Cloud, consulta el SDK de ABAP para bibliotecas cliente de Google Cloud.

Como desarrollador de ABAP, puedes compilar y, luego, implementar soluciones basadas en el AA y la IA con una amplia gama de servicios de Google Cloud, como los siguientes: Vertex AI, Document AI Warehouse, BigQuery, Dataproc, Pub/Sub, APIs de Google Workspace y Google Maps Platform.

Para la comunicación entre las APIs de SAP y Google Cloud, el SDK de ABAP para Google Cloud usa el protocolo HTTPS con SSL.

Antes de comenzar

Antes de instalar la edición SAP BTP del SDK de ABAP para Google Cloud, haz lo siguiente:

  1. Suscríbete a SAP BTP Landscape Portal. Para obtener información sobre cómo suscribirse al portal de Landscape, consulta Suscríbete a Landscape Portal en SAP BTP Cockpit.

  2. Tienes un ID de S-user válido asociado con un número de cliente que tiene un contrato de asistencia de SAP activo.

  3. Si es la primera vez que usas Google Cloud, crea una cuenta en https://cloud.google.com.

  4. Si aún no tienes un proyecto de Google Cloud, crea uno:

    Ir al selector de proyectos

  5. Asegúrate de tener habilitada la facturación para tu proyecto. Para obtener más información, consulta Verifica el estado de la facturación de tu proyecto.

  6. Habilita las APIs compatibles a las que planeas acceder a través del SDK. Para obtener información sobre cómo habilitar las APIs de Google Cloud, consulta Habilita las API.

Sube los certificados de Google

Para proteger la comunicación entre el entorno SAP BTP, ABAP y los servidores de Google, debes subir los certificados de Google necesarios a la app Maintain Certificate Trust List de tu entorno de SAP BTP, ABAP.

Para subir los certificados a la app SAP Maintain Certificate Trust List, debes tener acceso al catálogo de empresas SAP_CORE_BC_SEC. Este catálogo de empresas se incluye en el rol empresarial predefinido SAP_BR_ADMINISTRATOR.

Para subir los certificados de Google, sigue estos pasos:

  1. Descarga los siguientes certificados del repositorio de Google Trust Services:

    • GTS Root R1
    • GTS CA 1C3
  2. Accede a SAP BTP Cockpit. Para obtener más información, consulta Access the Cockpit en la página de SAP.

  3. Selecciona la cuenta secundaria en la que se aloja tu entorno de ABAP.

  4. Ve a Instancias y suscripciones > Instancias y haz clic en tu instancia de ABAP.

  5. En el entorno de ABAP que se abre, ve a Todos los espacios > Administración > Seguridad.

  6. Abre la app Maintain Certificate Trust List.

  7. Haz clic en Agregar.

  8. Selecciona los certificados que descargaste del repositorio de Google Trust Services.

  9. Haz clic en Subir. Los certificados se agregan a la lista de confianza.

Instala la edición SAP BTP del SDK de ABAP para Google Cloud

Instala la edición SAP BTP del SDK de ABAP para Google Cloud a través de SAP Landscape Portal.

Si deseas instalar la edición SAP BTP del SDK de ABAP para Google Cloud, sigue estos pasos:

  1. Obtén el producto SDK de ABAP para Google Cloud disponible en Landscape Portal.

    1. En el componente BC-CP-ABA, abre un caso de prioridad media con SAP a través de una de las siguientes opciones:

      • Abre un caso a través de la aplicación SAP for Me. Si deseas obtener los lineamientos para abrir un caso, consulta Submitting a Case en la página de SAP.

        Crea la aplicación SAP for Me de un caso Crea la aplicación SAP for Me de un caso

      • Abre un caso a través de Landscape Portal. Si deseas obtener lineamientos para abrir un caso, consulta Create Support Tickets en la página de SAP.

        Crea un caso: Landscape Portal

    2. En la descripción del caso, ingresa los siguientes detalles:

      We would like the following product registered to our Landscape Portal:
      * Product: /GOOG/ABAP_SDK
      * Publisher: Google
      
    3. Proporciona otros detalles según corresponda y envía el caso.

    Una vez que SAP confirme que el producto está registrado en Landscape Portal, continúa con el siguiente paso.

  2. Implementa el producto SDK de ABAP para Google Cloud:

    1. En Landscape Portal, abre la app Deploy.
    2. En el campo Producto, selecciona /GOOG/ABAP_SDK.
    3. En el campo Versión objetivo, selecciona 1.0.1.
    4. En Available systems, selecciona la instancia de ABAP en la que necesitas instalar el SDK.
    5. Haz clic en Implementar. En la sección Product Version Deployment Status, se muestra el estado de finalización de la implementación.

Agrega apps de Fiori al launchpad

La edición SAP BTP del SDK de ABAP para Google Cloud proporciona apps de Fiori de SAP para la configuración del SDK y el registro de aplicaciones. Como administrador o desarrollador, usas estas apps de Fiori para configurar el SDK y el registro de aplicaciones. El SDK también proporciona apps de Fiori dedicadas solo para ver configuraciones de autenticación, configuraciones de registro y analizar los registros del SDK.

Los administradores o desarrolladores que configuran el SDK y el registro, o los usuarios que solo necesitan ver las configuraciones y los registros del SDK, deben tener acceso a las apps de Fiori relevantes. Para otorgar acceso a las apps de Fiori del SDK, debes agregar los catálogos de empresas del SDK de ABAP para Google Cloud al rol empresarial de los usuarios que realizan la configuración del SDK o necesitan ver las configuraciones y el registro. La edición SAP BTP del SDK de ABAP para Google Cloud incluye plantillas de roles empresariales que contienen catálogos de empresas necesarios para acceder a las apps de Fiori.

En la siguiente tabla, se enumeran las plantillas de roles empresariales y las apps de Fiori relacionadas a las que proporcionan acceso.

Plantilla de rol empresarial Nombre de la aplicación Descripción
/GOOG/BRT_SDK SDK de Google: configuración principal Usa esta app para configurar la autenticación para conectarte de manera segura con las APIs de Google Cloud.
SDK de Google: configuraciones de registro de aplicaciones Usa esta app para configurar el registro para capturar errores, advertencias y mensajes de información en los registros de la aplicación de SAP.
SDK de Google: visualización de registros de aplicaciones Usa esta app para ver los registros de la aplicación del SDK.
/GOOG/BRT_SDK_DISPLAY SDK de Google: configuración principal de visualización Usa esta app para ver las configuraciones del SDK.
SDK de Google: configuración del registro de visualización Usa esta app para ver las configuraciones de registro de aplicaciones.
SDK de Google: visualización de registros de aplicaciones Usa esta app para ver los registros de la aplicación del SDK.

Para agregar los catálogos de empresas del SDK de ABAP para Google Cloud al rol empresarial de los usuarios a través de las plantillas de roles empresariales proporcionadas, debes tener acceso al catálogo de empresas SAP_CORE_BC_SEC. Este catálogo de empresas se incluye en el rol empresarial predefinido SAP_BR_ADMINISTRATOR.

Crea un rol empresarial

  1. En tu entorno de ABAP, ve a Todos los espacios > Administración > Identity and Access Management.
  2. Abre la app Business Role Templates.
  3. Busca y selecciona una plantilla de rol empresarial según corresponda:

    • /GOOG/BRT_SDK: proporciona acceso a las apps de Fiori para configurar el SDK.
    • /GOOG/BRT_SDK_DISPLAY: proporciona acceso a las apps de Fiori para ver las configuraciones y los registros del SDK.
  4. Haz clic en Create Business Role.

  5. En el cuadro de diálogo Create Business Role from Template que aparece, ingresa un valor para los siguientes campos:

    • New business role ID: ingresa un ID de rol empresarial.
    • New business role description: ingresa una descripción para el rol empresarial.
  6. Haz clic en Aceptar. La página Maintain Business Roles aparece con el rol empresarial recién creado.

  7. En Access categories, especifica el acceso para el rol empresarial según la plantilla de rol empresarial seleccionada:

    • /GOOG/BRT_SDK: en el campo Read, Write, Value Help, selecciona Sin restricciones.
    • /GOOG/BRT_SDK_DISPLAY: En el campo Read, Write, Value Help, selecciona No access.
  8. De manera opcional, en la pestaña Assigned Business Catalogs, puedes ver los catálogos de empresas de las apps de Fiori que están asociadas con el rol empresarial.

  9. Haz clic en Guardar.

Asigna espacio al rol empresarial

  1. En tu entorno de ABAP, ve a Todos los espacios > Administración > Identity and Access Management.
  2. Abre la app Maintain Business Roles.
  3. Busca y selecciona el rol empresarial que creaste en la sección Crea un rol empresarial.
  4. Ve a la pestaña Assigned Launchpad Spaces y haz clic en Agregar.
  5. En el cuadro de diálogo Add Launchpad Space que aparece, ingresa un valor para los siguientes campos:

    • Assign space to business role: Selecciona Crear espacio nuevo.
    • Space ID: Ingresa un ID de espacio.
    • Space description: ingresa una descripción para el espacio.
    • Space title: ingresa un título para el espacio.
  6. Haz clic en Create and assign space.

  7. En la pestaña Assigned Launchpad Spaces, haz clic en el ID de tu espacio.

  8. En la página Space Details que aparece, ve a la pestaña Páginas y, luego, haz clic en el ID de la página.

  9. En la página Managed Launchpad Pages que aparece, ve a la pestaña Page Content y haz clic en Editar.

  10. En el campo Section Title, ingresa un título para la sección.

  11. En la sección Derived from Role, selecciona las apps de Fiori y, luego, haz clic en Agregar. Estas apps de Fiori se muestran desde los catálogos de empresas del SDK de ABAP para Google Cloud.

  12. Haz clic en Guardar.

Asigna roles a los usuarios empresariales

Para otorgar acceso a las apps de Fiori del SDK, debes asignar el rol recién creado a los usuarios empresariales que administran o ven las configuraciones y los registros del SDK.

  1. En tu entorno de ABAP, ve a Todos los espacios > Administración > Identity and Access Management.
  2. Abre la app Maintain Business Roles.
  3. Busca y selecciona el rol empresarial que creaste en la sección Crea un rol empresarial.
  4. Ve a la pestaña Assigned Business Users y haz clic en Agregar.
  5. En el cuadro de diálogo Add Business Users que aparece, busca y selecciona los usuarios necesarios que deben acceder a las apps de Fiori del SDK.
  6. Haz clic en Aceptar. Los usuarios pueden ver el espacio y la página asignados con las apps de Fiori del SDK.

Configura la autenticación

Para usar las APIs de Google Cloud, debes confirmar tu identidad a través de la autenticación. Para obtener información sobre las opciones de autenticación en Google Cloud y los pasos de configuración, consulta Autenticación.

Configura el registro

La edición SAP BTP del SDK de ABAP para Google Cloud usa los registros de aplicaciones de SAP para guardar todos los mensajes generados durante la ejecución de las clases de biblioteca cliente. Una vez que defines una configuración de registro predeterminada, el SDK comienza a registrar los mensajes.

El objeto de registro /GOOG/LOG_OBJECT y el subobjeto /GOOG/LOG_SUBOBJECT se envían con el SDK que puedes usar para crear tu configuración de registro predeterminada.

Usa la app SDK de Google: configuraciones de registros de la aplicación para crear una configuración del registro.

Puedes ver los registros de la aplicación con la app SDK de Google: visualización de los registros de la aplicación. Para obtener más información, consulta Visualiza registros.

Para crear una configuración de registro, realiza los siguientes pasos:

  1. Accede al launchpad de SAP Fiori.
  2. Ve al espacio que contiene las apps de Fiori para la configuración del SDK.
  3. Abre la app SDK de Google: configuración del registro de la aplicación.
  4. Haz clic en Crear.
  5. En el cuadro de diálogo Crear que aparece, ingresa un valor para los siguientes campos:

    • Log config type: selecciona OBJ_SUBOBJ.
    • Objeto: selecciona /GOOG/LOG_OBJECT.
    • Subobject: selecciona /GOOG/LOG_SUBOBJECT.
  6. Haz clic en Continuar.

  7. Proporciona los siguientes detalles:

    • Retention days: especifica la cantidad de días que se conservarán los registros.
    • Log level: especifica el nivel de registro mínimo. Los valores admitidos son los siguientes:

      • I: Información, advertencias y errores
      • W: Advertencias y errores
      • E: solo errores Te recomendamos establecer el nivel de registro en I para que se registren la mayoría de los mensajes de registro.
    • Finaliza el: especifica la fecha de finalización hasta la que esta configuración de registro estará activa. La fecha de finalización predeterminada es el 9999/12/31.

    • Is default: para que esta opción sea tu configuración de registro predeterminada, selecciona la casilla de verificación.

  8. Haz clic en Crear.

Administra la configuración del registro

Si ya no se requiere una configuración de registro, puedes inhabilitarla.

Para inhabilitar una configuración de registro, realiza los siguientes pasos:

  1. Abre la app SDK de Google: configuración del registro de la aplicación.
  2. En el campo Editing status, selecciona un estado según corresponda y, luego, haz clic en Ir.
  3. Haz clic en la entrada de configuración de registro que necesitas inhabilitar.
  4. Haz clic en Editar.
  5. Configura Finalizar el en una fecha pasada.
  6. Haz clic en Guardar.

Especifica el extremo de API de Google Cloud

La edición SAP BTP del SDK de ABAP para Google Cloud proporciona las siguientes opciones para especificar el extremo de la API cuando se llama a una API de Google Cloud con la clase de biblioteca cliente de la API:

  • Extremos predeterminados
  • Extremo personalizado

Extremos predeterminados

De forma predeterminada, cada clase de API codifica los extremos globales como un valor constante. La biblioteca cliente usa estos extremos cuando se llama a un método para realizar una operación en los recursos de la API. Para usar los extremos predeterminados, no se requiere ninguna configuración adicional.

Extremos personalizados

En situaciones, en las que necesitas la flexibilidad para definir tus propios extremos, puedes crear extremos personalizados. Por ejemplo, creas un extremo personalizado para establecer una conexión con Google Cloud cuando necesitas hacer lo siguiente:

  • Accede a los extremos específicos de la región de una API para aplicaciones reglamentarias o sensibles a la latencia.
  • Usa APIs específicas como Vertex AI, que solo ofrecen extremos regionales.

Para crear un extremo personalizado, usa la situación de comunicación /GOOG/COM_SDK_SRV que se envía con el SDK de ABAP para Google Cloud.

En el siguiente procedimiento, se ilustra cómo crear un extremo regional para la API de Pub/Sub. Puedes seguir el mismo procedimiento a fin de crear extremos personalizados para otros servicios de Google Cloud compatibles.

  1. Accede al launchpad de SAP Fiori del sistema BTP ABAP en el que está instalado el SDK de ABAP para Google Cloud.
  2. Ve a Todos los espacios > Administración > Administración de la comunicación.
  3. Crear un sistema de comunicación:
    1. Abre la app Communication Systems.
    2. Haz clic en Nuevo.
    3. En el diálogo Nuevo sistema de comunicación que aparece, ingresa un valor para los siguientes campos:
      • ID del sistema: ingresa un ID del sistema.
      • Nombre del sistema: ingresa un nombre del sistema.
    4. Haz clic en Crear.
    5. En el campo Nombre de host, ingresa tu extremo personalizado. Por ejemplo, ingresa un extremo regional para el servicio de Pub/Sub: https://asia-east1-pubsub.googleapis.com.
    6. En el campo Puerto, escribe 443.
    7. En la pestaña Usuarios para la comunicación saliente, haz clic en Agregar.
    8. En el campo Método de autenticación, selecciona Ninguno.
    9. Haz clic en Crear.
    10. Para guardar el sistema de comunicación, haz clic en Guardar.
  4. Crea un acuerdo de comunicación:

    1. Abre la app Communication Arrangement.
    2. Haz clic en Nuevo.
    3. En el cuadro de diálogo Nuevo acuerdo de comunicaciones que aparece, ingresa los siguientes detalles:

      • Scenario: selecciona Outbound Communication for any API (/GOOG/COM_SDK_SRV).
      • Nombre del acuerdo: ingresa un nombre para el acuerdo de comunicación.
    4. Haz clic en Crear.

    5. Para el acuerdo de comunicación que aparece, en el campo Sistema de comunicación, selecciona el sistema de comunicación que creaste en el paso anterior.

    6. En Outbound communication, en el campo Nombre de usuario, selecciona Ninguno.

    7. Haz clic en Guardar.

  5. Crea un mapa de comunicación para un servicio de API:

    1. Ve al espacio que contiene las apps de Fiori para la configuración del SDK.
    2. Abre la app de SDK de Google: configuración principal.
    3. Selecciona la clave de cliente con la que necesitas crear un extremo personalizado. Se supone que ya creaste una clave de cliente y un mapa de comunicación para la autenticación. De lo contrario, crea una clave de cliente y un mapa de comunicación para la autenticación. Para obtener más información, consulta Autenticación.
    4. Haz clic en Crear.
    5. En el cuadro de diálogo Crear que aparece, selecciona un nombre de servicio. Por ejemplo, selecciona pubsub:v1.
    6. Haz clic en Continuar.
    7. Para el mapa de comunicación que aparece, en el campo Communication arrangement, selecciona la acuerdo de comunicación que creaste en el paso anterior. Los otros artefactos de comunicación se propagan de forma automática.
    8. Haz clic en Aplicar.
    9. Haz clic en Guardar.
    10. Para validar la configuración del extremo personalizado, haz clic en Verificar conexión. Una marca de verificación verde en una entrada indica que la configuración se realizó correctamente. Si se produce algún error, visita la página de solución de problemas para obtener orientación sobre cómo resolver los errores comunes.

Métricas de uso

La edición SAP BTP del SDK de ABAP para Google Cloud recopila métricas de uso y las envía a Google con fines de asistencia, en conformidad con el Aviso de Privacidad de Google Cloud (Datos del Servicio que recopilamos). Estas métricas de uso se recopilan cada vez que se llama a una API de Google Cloud desde el SDK de ABAP para Google Cloud.

El SDK recopila las siguientes métricas de uso:

  • Método de autenticación: información sobre el método de autenticación usado para llamar a los servicios de Google Cloud.
  • Versión del SDK de ABAP: número de versión de la edición SAP BTP del SDK de ABAP para Google Cloud.
  • Versión de SAP_ABA: versión del componente de software SAP_ABA

Licencias

La edición SAP BTP del SDK de ABAP para Google Cloud está disponible como "Software" en virtud del acuerdo que rige el uso de Google Cloud Platform, incluidas las Condiciones Específicas del Servicio disponibles en https://cloud.google.com/terms/service-terms. Sin limitar la generalidad de los términos anteriores, no puedes modificar ni distribuir el SDK de ABAP para Google Cloud sin el permiso expreso por escrito de Google.

El SDK ABAP para el software de Google Cloud se ofrece sin costo. Para mayor claridad, el uso de otros “Software” y “Servicios” en el acuerdo que rige el uso de Google Cloud Platform, como la API de Cloud Translation y la API de Pub/Sub pueden generar un costo.

El SDK de ABAP para Google Cloud no incluye ninguna licencia para el software de SAP, debes obtener una licencia adecuada para el software de SAP por separado.

Ciclo de vida de la asistencia

Google Cloud admite y mantiene la versión principal actual de la edición SAP BTP del SDK de ABAP para Google Cloud durante un período de al menos 12 meses después de la publicación de un aviso de baja de la versión principal anterior en Página de notas de la versión de SAP en Google Cloud

Obtenga asistencia

Si necesitas ayuda para resolver problemas con el SDK de ABAP para Google Cloud, haz lo siguiente: