Installer et configurer l'édition SAP BTP du SDK ABAP pour Google Cloud

SAP BTP edition v1.0

• SAP BTP edition v1.0
• On-premises or any cloud edition v1.6

Ce document explique comment installer et configurer l'édition SAP BTP du SDK ABAP pour Google Cloud dans SAP BTP, environnement ABAP.

Ce document est destiné aux administrateurs SAP, aux administrateurs Google Cloud et aux autres professionnels de la sécurité SAP et Google Cloud.

Présentation

Le SDK ABAP pour Google Cloud fournit des bibliothèques clientes sous la forme de classes ABAP pour que les développeurs puissent accéder de façon programmatique aux API Google Cloud. En encapsulant les fonctions essentielles telles que la sécurité, l'authentification, la sérialisation et la désérialisation des données, ainsi que la gestion des exceptions en tant que composants réutilisables, ces bibliothèques clientes réduisent la quantité de code que les développeurs doivent écrire. Pour obtenir la liste complète des bibliothèques clientes fournies par le SDK ABAP pour Google Cloud, consultez la page Bibliothèques clientes du SDK ABAP pour Google Cloud.

En tant que développeur ABAP, vous pouvez créer et déployer des solutions basées sur le ML et l'IA à l'aide de nombreux services Google Cloud, comme Vertex AI, Document AI Warehouse, BigQuery, Dataproc, Pub/Sub, API Google Workspace et Google Maps Platform.

Pour la communication entre SAP et les API Google Cloud, le SDK ABAP pour Google Cloud utilise le protocole HTTPS avec SSL.

Avant de commencer

Avant d'installer l'édition SAP BTP du SDK ABAP pour Google Cloud, procédez comme suit :

1. Abonnez-vous au portail SAP BTP Landscape. Pour en savoir plus sur l'abonnement au portail Landscape, consultez la section S'abonner au portail Landscape dans SAP BTP cockpit.

2. Vous disposez d'un ID utilisateur S valide associé à un numéro client disposant d'un contrat d'assistance SAP actif.

3. Si vous débutez sur Google Cloud, créez un compte sur https://cloud.google.com.

4. Si vous n'avez pas encore de projet Google Cloud, créez-en un :

   Accéder au sélecteur de projet

5. Assurez-vous que la facturation est activée pour votre projet. Pour en savoir plus, consultez Vérifier l'état de facturation de votre projet.

6. Activez les API compatibles auxquelles vous prévoyez d'accéder à l'aide du SDK. Pour en savoir plus sur l'activation des API Google Cloud, consultez la page Activer des API.

Importer les certificats Google

Pour sécuriser la communication entre SAP BTP, l'environnement ABAP et les serveurs Google, vous devez importer les certificats Google requis dans l'application Gestion de la liste de confiance des certificats de votre environnement SAP BTP ou ABAP.

Pour importer les certificats dans l'application SAP "Gestion de la liste de confiance des certificats", vous devez avoir accès au catalogue d'entreprise SAP_CORE_BC_SEC. Ce catalogue d'entreprise est inclus dans le rôle d'entreprise prédéfini SAP_BR_ADMINISTRATOR.

Pour importer les certificats Google, procédez comme suit :

1. Téléchargez les certificats suivants à partir du dépôt Google Trust Services :

   • GTS Root R1
   • GTS CA 1C3

2. Connectez-vous à SAP BTP Cockpit. Pour en savoir plus, consultez la page SAP Accéder à Cockpit.

3. Sélectionnez le sous-compte dans lequel votre environnement ABAP est hébergé.

4. Accédez à Instances et abonnements > Instances, puis cliquez sur votre instance ABAP.

5. Dans l'environnement ABAP qui s'affiche, accédez à Tous les espaces > Administration > Sécurité.

6. Ouvrez l'application Gestion de la liste de confiance des certificats.

7. Cliquez sur Ajouter.

8. Sélectionnez les certificats que vous avez téléchargés à partir du dépôt Google Trust Services.

9. Cliquez sur Importer. Les certificats sont ajoutés à la liste de confiance.

Installer l'édition SAP BTP du SDK ABAP pour Google Cloud

Installez l'édition SAP BTP du SDK ABAP pour Google Cloud à l'aide du Portail SAP BTP Landscape.

Pour installer l'édition SAP BTP du SDK ABAP pour Google Cloud, procédez comme suit :

1. Rendez le produit SDK ABAP pour Google Cloud disponible sur le portail Landscape.

   1. Sous le composant BC-CP-ABA, ouvrez une demande de priorité moyenne avec SAP à l'aide de l'une des options suivantes :

      • Ouvrez une demande via l'application SAP for Me. Pour en savoir plus sur la création d'une demande, consultez la page SAP Envoyer une demande.

        

      • Ouvrez une demande via le portail Landscape. Pour obtenir des instructions sur l'ouverture d'une demande, consultez la page SAP Créer des demandes d'assistance.

        

   2. Dans la description de la demande, saisissez les informations suivantes :

      We would like the following product registered to our Landscape Portal:
      * Product: /GOOG/ABAP_SDK
      * Publisher: Google
      

   3. Fournissez d'autres informations si nécessaire, puis envoyez la demande.

   Une fois que SAP a confirmé que le produit est enregistré sur votre portail Landscape, passez à l'étape suivante.

   Remarque : L'obligation d'envoyer une demande à SAP pour obtenir le SDK ABAP pour Google Cloud n'est qu'une approche temporaire jusqu'à ce qu'un mécanisme de distribution permanent soit établi.

2. Déployez le produit SDK ABAP pour Google Cloud :

   1. Dans le portail Landscape, ouvrez l'application Déployer.
   2. Dans le champ Produit, sélectionnez /GOOG/ABAP_SDK.
   3. Dans le champ Version cible, sélectionnez 1.0.1.
   4. Sous Systèmes disponibles, sélectionnez l'instance ABAP sur laquelle vous devez installer le SDK.
   5. Cliquez sur Deploy (Déployer). La section État du déploiement de la version du produit affiche l'état d'achèvement du déploiement.

Ajouter des applications Fiori au lanceur d'applications

L'édition SAP BTP du SDK ABAP pour Google Cloud fournit des applications SAP Fiori pour les configurations du SDK et la journalisation des applications. En tant qu'administrateur ou développeur, vous utilisez ces applications Fiori pour configurer le SDK et configurer la journalisation des applications. Le SDK fournit également des applications Fiori dédiées uniquement pour l'affichage des configurations d'authentification, la journalisation des configurations et l'analyse des journaux du SDK.

Les administrateurs ou les développeurs qui configurent le SDK et la journalisation, ou les utilisateurs qui n'ont besoin que d'afficher les configurations et les journaux du SDK, doivent avoir accès aux applications Fiori correspondantes. Pour accorder l'accès aux applications du SDK Fiori, vous devez ajouter les catalogues d'entreprise du SDK ABAP pour Google Cloud au rôle d'entreprise des utilisateurs qui effectuent la configuration du SDK ou qui ont besoin d'afficher les configurations et la journalisation. L'édition SAP BTP du SDK ABAP pour Google Cloud inclut des modèles de rôles d'entreprise contenant les catalogues d'entreprise requis pour accéder aux applications Fiori.

Le tableau suivant répertorie les modèles de rôles d'entreprise et les applications Fiori associées auxquelles ils donnent accès.

Modèle de rôle d'entreprise	Nom de l'application	Description
/GOOG/BRT_SDK	SDK Google : configuration principale	Utilisez cette application pour configurer l'authentification afin de vous connecter de manière sécurisée aux API Google Cloud.
	SDK Google : configurations des journaux d'application	Utilisez cette application pour configurer la journalisation afin d'enregistrer les erreurs, les avertissements et les messages d'information dans les journaux des applications SAP.
	SDK Google : affichage des journaux d'application	Utilisez cette application pour afficher les journaux de l'application du SDK.
/GOOG/BRT_SDK_DISPLAY	SDK Google : configuration principale de l'affichage	Utilisez cette application pour afficher les configurations du SDK.
	SDK Google : configuration du journal d'affichage	Utilisez cette application pour afficher les configurations de journaux d'application.
	SDK Google : affichage des journaux d'application	Utilisez cette application pour afficher les journaux de l'application du SDK.

Pour ajouter les catalogues d'entreprise du SDK ABAP pour Google Cloud aux rôles d'entreprise des utilisateurs à l'aide des modèles de rôle d'entreprise fournis, vous devez avoir accès au catalogue d'entreprise SAP_CORE_BC_SEC. Ce catalogue d'entreprise est inclus dans le rôle d'entreprise prédéfini SAP_BR_ADMINISTRATOR.

Créer un rôle d'entreprise

1. Dans votre environnement ABAP, accédez à Tous les espaces > Administration > Identity and Access Management.
2. Ouvrez l'application Modèles de rôle d'entreprise.

3. Recherchez et sélectionnez un modèle de rôle d'entreprise selon vos besoins :

   • /GOOG/BRT_SDK : permet d'accéder aux applications Fiori pour configurer le SDK.
   • /GOOG/BRT_SDK_DISPLAY : permet d'accéder aux applications Fiori pour afficher les configurations et les journaux du SDK.

4. Cliquez sur Créer un rôle d'entreprise.

5. Dans la boîte de dialogue Créer un rôle d'entreprise à partir d'un modèle qui s'affiche, saisissez une valeur pour les champs suivants :

   • Nouvel ID de rôle d'entreprise : saisissez un ID de rôle d'entreprise.
   • Description du nouveau rôle d'entreprise : saisissez une description du rôle d'entreprise.

6. Cliquez sur OK. La page Gérer les rôles d'entreprise s'affiche avec le rôle d'entreprise nouvellement créé.

7. Sous Catégories d'accès, spécifiez l'accès du rôle d'entreprise en fonction du modèle de rôle d'entreprise sélectionné :

   • /GOOG/BRT_SDK : dans le champ Lecture, écriture, aide sur la valeur, sélectionnez Pas de restriction.
   • /GOOG/BRT_SDK_DISPLAY : dans le champ Lecture, écriture, aide sur la valeur, sélectionnez Aucun accès.

8. Si vous le souhaitez, dans l'onglet Catalogues d'entreprise attribués, vous pouvez afficher les catalogues d'entreprise des applications Fiori associées au rôle d'entreprise.

9. Cliquez sur Enregistrer.

Attribuer un espace au rôle d'entreprise

1. Dans votre environnement ABAP, accédez à Tous les espaces > Administration > Identity and Access Management.
2. Ouvrez l'application Gestion des rôles d'entreprise.
3. Recherchez et sélectionnez le rôle d'entreprise que vous avez créé dans la section Créer un rôle d'entreprise.
4. Accédez à l'onglet Espaces Launchpad attribués, puis cliquez sur Ajouter.

5. Dans la boîte de dialogue Ajouter un espace Launchpad qui s'affiche, saisissez une valeur pour les champs suivants :

   • Attribuez un espace à un rôle d'entreprise : sélectionnez Créer un espace.
   • ID de l'espace : saisissez un ID pour l'espace.
   • Description de l'espace : saisissez une description pour l'espace.
   • Titre de l'espace : saisissez un titre pour l'espace.

6. Cliquez sur Créer et attribuer un espace.

7. Dans l'onglet Espaces Launchpad attribués, cliquez sur l'ID de votre espace.

8. Sur la page Détails de l'espace qui s'affiche, accédez à l'onglet Pages, puis cliquez sur l'ID de la page.

9. Sur la page Pages Launchpad gérées qui s'affiche, accédez à l'onglet Contenu de la page, puis cliquez sur Modifier.

10. Dans le champ Titre de la section, saisissez un titre pour la section.

11. Dans la section Dérivé du rôle, sélectionnez les applications Fiori, puis cliquez sur Ajouter. Ces applications Fiori sont affichées à partir des catalogues d'entreprise du SDK ABAP pour Google Cloud.

12. Cliquez sur Enregistrer.

Attribuer des rôles aux utilisateurs d'entreprise

Pour accorder l'accès aux applications Fiori du SDK, vous devez attribuer le nouveau rôle aux utilisateurs d'entreprise qui gèrent ou affichent les configurations et les journaux du SDK.

1. Dans votre environnement ABAP, accédez à Tous les espaces > Administration > Identity and Access Management.
2. Ouvrez l'application Gestion des rôles d'entreprise.
3. Recherchez et sélectionnez le rôle d'entreprise que vous avez créé dans la section Créer un rôle d'entreprise.
4. Accédez à l'onglet Utilisateurs d'entreprise attribués, puis cliquez sur Ajouter.
5. Dans la boîte de dialogue Ajouter des utilisateurs d'entreprise qui s'affiche, recherchez et sélectionnez les utilisateurs requis qui ont besoin d'accéder aux applications du SDK Fiori.
6. Cliquez sur OK. Les utilisateurs peuvent voir l'espace et la page attribués avec les applications SDK Fiori.

Configurer l'authentification

Pour utiliser les API Google Cloud, vous devez confirmer votre identité en vous authentifiant. Pour en savoir plus sur les options d'authentification à Google Cloud et les étapes de configuration, consultez la page Authentification.

Configurer la journalisation

L'édition SAP BTP du SDK ABAP pour Google Cloud utilise les journaux d'application SAP pour enregistrer tous les messages générés lors de l'exécution des classes de la bibliothèque cliente. Une fois que vous avez défini une configuration de journal par défaut, le SDK commence à consigner les messages.

L'objet /GOOG/LOG_OBJECT et le sous-objet /GOOG/LOG_SUBOBJECT de journal sont envoyés avec le SDK que vous pouvez utiliser pour créer la configuration de journal par défaut.

Vous utilisez l'application SDK Google : configurations des journaux d'application pour créer une configuration de journal.

Vous pouvez afficher les journaux d'application à l'aide de l'application Google SDK : afficher les journaux d'application. Pour en savoir plus, consultez la section Afficher les journaux.

Pour créer une configuration de journal, procédez comme suit :

1. Accédez à la plate-forme de lancement de SAP Fiori.
2. Accédez à l'espace contenant les applications Fiori pour la configuration du SDK.
3. Ouvrez l'application SDK Google : configuration du journal d'application.
4. Cliquez sur Créer.

5. Dans la boîte de dialogue Créer qui s'affiche, saisissez une valeur pour les champs suivants :

   • Type de configuration du journal : sélectionnez OBJ_SUBOBJ.
   • Objet : sélectionnez /GOOG/LOG_OBJECT.
   • Sous-objet : sélectionnez /GOOG/LOG_SUBOBJECT.

6. Cliquez sur Continuer.

7. Spécifiez les informations suivantes :

   • Jours de conservation : spécifiez le nombre de jours de conservation des journaux.

   • Niveau de journalisation : spécifiez le niveau de journalisation minimal. Les valeurs acceptées sont les suivantes :

     • I : informations, avertissements et erreurs
     • W : avertissements et erreurs
     • E : erreurs uniquement. Nous vous recommandons de définir le niveau de journalisation sur I, afin que la plupart des messages de journal soient enregistrés.

   • Fin le : spécifie la date de fin jusqu'à laquelle cette configuration de journal sera active. La date de fin par défaut est 9999/12/31.

   • Par défaut : pour définir cette configuration de journal par défaut, cochez la case correspondante.

8. Cliquez sur Créer.

Gérer la configuration des journaux

Si une configuration de journal n'est plus requise, vous pouvez la désactiver.

Pour désactiver une configuration de journal, procédez comme suit :

1. Ouvrez l'application SDK Google : configuration du journal d'application.
2. Dans le champ État de la modification, sélectionnez l'état approprié, puis cliquez sur Aller.
3. Cliquez sur l'entrée de configuration du journal que vous devez désactiver.
4. Cliquez sur Modifier.
5. Définissez le champ Fin le sur une date passée.
6. Cliquez sur Enregistrer.

Spécifier le point de terminaison de l'API Google Cloud

L'édition SAP BTP du SDK ABAP pour Google Cloud offre les options suivantes pour spécifier le point de terminaison de l'API lors de l'appel d'une API Google Cloud à l'aide de la classe de la bibliothèque cliente de l'API :

• Points de terminaison par défaut
• Point de terminaison personnalisé

Points de terminaison par défaut

Par défaut, chaque classe d'API code en dur les points de terminaison mondiaux sous la forme d'une valeur constante. La bibliothèque cliente utilise ces points de terminaison lorsqu'une méthode est appelée pour effectuer une opération sur les ressources de l'API. Pour utiliser les points de terminaison par défaut, aucune configuration supplémentaire n'est requise.

Points de terminaison personnalisés

Dans les scénarios où vous avez besoin de définir vos propres points de terminaison, vous pouvez créer des points de terminaison personnalisés. Par exemple, vous créez un point de terminaison personnalisé pour établir une connexion à Google Cloud lorsque vous devez effectuer les opérations suivantes :

• Accédez aux points de terminaison spécifiques à la région d'une API pour les applications réglementaires ou sensibles à la latence.
• Utilisez des API spécifiques telles que Vertex AI, qui ne proposent que des points de terminaison régionaux.

Pour créer un point de terminaison personnalisé, vous utilisez le scénario de communication /GOOG/COM_SDK_SRV fourni avec le SDK ABAP pour Google Cloud.

La procédure suivante montre comment créer un point de terminaison régional pour l'API Pub/Sub. Vous pouvez suivre la même procédure si vous souhaitez créer des points de terminaison personnalisés pour d'autres services Google Cloud compatibles.

1. Accéder à la plate-forme de lancement SAP Fiori du système BTP ABAP dans lequel le SDK ABAP pour Google Cloud est installé.
2. Accédez à Tous les espaces > Administration > Gestion de la communication.
3. Créez un système de communication :
   1. Ouvrez l'application Systèmes de communication.
   2. Cliquez sur New (Nouveau).
   3. Dans la boîte de dialogue Nouveau système de communication qui s'affiche, saisissez une valeur pour les champs suivants :
      • ID système : saisissez un ID système.
      • Nom du système : saisissez un nom du système.
   4. Cliquez sur Créer.
   5. Dans le champ Nom d'hôte, saisissez votre point de terminaison personnalisé. Par exemple, saisissez un point de terminaison régional pour le service Pub/Sub : https://asia-east1-pubsub.googleapis.com.
   6. Dans le champ Port, saisissez 443.
   7. Dans l'onglet Utilisateurs pour la communication sortante, cliquez sur Ajouter.
   8. Dans le champ Méthode d'authentification, sélectionnez Aucune.
   9. Cliquez sur Créer.
   10. Pour enregistrer le système de communication, cliquez sur Enregistrer.

4. Créez une configuration de communication :

   1. Ouvrez l'application Configuration de communication.
   2. Cliquez sur New (Nouveau).

   3. Dans la boîte de dialogue Nouvelle configuration de communication qui s'affiche, saisissez les informations suivantes :

      • Scénario : sélectionnez Communication sortante pour n'importe quelle API (/GOOG/COM_SDK_SRV).
      • Nom de la configuration : saisissez un nom pour la configuration de communication.

   4. Cliquez sur Créer.

   5. Pour la configuration de la communication qui s'affiche, dans le champ Système de communication, sélectionnez le système de communication que vous avez créé à l'étape précédente.

   6. Sous Communication sortante, sélectionnez Aucune dans le champ Nom d'utilisateur.

   7. Cliquez sur Enregistrer.

5. Créez un plan de communication pour un service d'API :

   1. Accédez à l'espace contenant les applications Fiori pour la configuration du SDK.
   2. Ouvrez l'application SDK Google : configuration principale.
   3. Sélectionnez la clé client pour laquelle vous souhaitez créer un point de terminaison personnalisé. Nous partons du principe que vous avez déjà créé une clé client et un mappage de communication pour l'authentification. Si ce n'est pas le cas, créez une clé client et un mappage de communication pour l'authentification. Pour en savoir plus, consultez la section Authentification.
   4. Cliquez sur Créer.
   5. Dans la boîte de dialogue Créer qui s'affiche, sélectionnez un nom de service. Par exemple, sélectionnez pubsub:v1.
   6. Cliquez sur Continuer.
   7. Pour le plan de communication qui s'affiche, dans le champ Configuration de la communication, sélectionnez la configuration que vous avez créée à l'étape précédente. Les autres artefacts de communication sont renseignés automatiquement.
   8. Cliquez sur Appliquer.
   9. Cliquez sur Enregistrer.
   10. Pour valider la configuration personnalisée du point de terminaison, cliquez sur Vérifier la connexion. Une coche verte pour une entrée indique que la configuration a réussi. En cas d'erreur, consultez la page Dépannage pour obtenir des conseils sur la résolution des erreurs courantes.

Métriques d'utilisation

L'édition SAP BTP du SDK ABAP pour Google Cloud collecte les métriques d'utilisation et les envoie à Google à des fins d'assistance, conformément à l'Avis de confidentialité de Google Cloud (données des services que nous collectons). Ces métriques d'utilisation sont collectées chaque fois qu'une API Google Cloud est appelée à partir du SDK ABAP pour Google Cloud.

Le SDK collecte les métriques d'utilisation suivantes :

• Méthode d'authentification : informations sur la méthode d'authentification utilisée pour appeler les services Google Cloud.
• Version du SDK ABAP : numéro de version de l'édition SAP BTP du SDK ABAP pour Google Cloud.
• Version de SAP_ABA : version du composant logiciel SAP_ABA.

Licences

L'édition SAP BTP du SDK ABAP pour Google Cloud est disponible en tant que "Logiciel" dans le cadre du contrat régissant votre utilisation de Google Cloud Platform, y compris les Conditions spécifiques au service disponibles à l'adresse https://cloud.google.com/terms/service-terms. Sans limiter la généralité des termes précédents, vous ne pouvez ni modifier ni distribuer le SDK ABAP pour Google Cloud sans l'autorisation écrite préalable de Google.

Le logiciel du SDK ABAP pour Google Cloud est actuellement proposé gratuitement. Par souci de clarté, l'utilisation d'autres "Logiciels" et "Services" (par exemple, l'API Cloud Translation et l'API Pub/Sub) conformément au contrat régissant votre utilisation de Google Cloud Platform peut entraîner des coûts.

Le SDK ABAP pour Google Cloud n'inclut aucune licence pour les logiciels SAP. Vous devez obtenir séparément une licence appropriée pour le logiciel SAP.

Cycle de vie de l'assistance

Google Cloud assure l'assistance et le maintien de la version majeure actuelle de l'édition SAP BTP du SDK ABAP pour Google Cloud pendant une période d'au moins 12 mois suivant la publication d'une notification d'abandon de la version majeure précédente sur la page des notes de version de SAP sur Google Cloud.

Obtenir de l'aide

Procédez comme suit si vous avez besoin d'aide pour résoudre les problèmes liés au SDK ABAP pour Google Cloud :

• Consultez le guide de dépannage du SDK ABAP pour Google Cloud.

• Posez vos questions concernant le SDK ABAP pour Google Cloud et discutez de celui-ci avec la communauté sur les forums Cloud.

• Recueillez toutes les informations de diagnostic disponibles et contactez Cloud Customer Care. Pour savoir comment contacter le service client, consultez la page Obtenir de l'aide pour SAP sur Google Cloud.