Installa e configura l'edizione SAP BTP dell'SDK ABAP per Google Cloud

SAP BTP edition v1.0

• Versione SAP BTP v1.0
• On-premise o qualsiasi versione cloud v1.7

Questo documento descrive come installare e configurare l'edizione SAP BTP dell'SDK ABAP per Google Cloud nell'ambiente SAP BTP, ABAP.

Questo documento è destinato agli amministratori SAP, agli amministratori di Google Cloud e ad altri professionisti della sicurezza SAP e Google Cloud.

Panoramica

L'SDK ABAP per Google Cloud fornisce librerie client sotto forma di classi ABAP per consentire agli sviluppatori di accedere in modo programmatico alle API Google Cloud. Incapsulando funzioni essenziali come sicurezza, autenticazione, serializzazione e deserializzazione dei dati e gestione degli errori come componenti riutilizzabili, queste librerie client riducono la quantità di codice che gli sviluppatori devono scrivere. Per un elenco completo delle librerie client fornite dall'SDK ABAP per Google Cloud, consulta ABAP SDK per le librerie client di Google Cloud.

In qualità di sviluppatore ABAP, puoi creare ed eseguire il deployment di soluzioni ML e basate sull'IA utilizzando un'ampia gamma di servizi Google Cloud come Vertex AI, Document AI Warehouse, BigQuery, Dataproc, Pub/Sub, API di Google Workspace e Google Maps Platform.

Per la comunicazione tra SAP e le API Google Cloud, l'SDK ABAP per Google Cloud utilizza il protocollo HTTPS con SSL.

Prima di iniziare

Prima di installare l'edizione SAP BTP dell'SDK ABAP per Google Cloud, segui questi passaggi:

1. Iscriviti al SAP BTP Landscape Portal. Per informazioni sull'iscrizione al portale Landscape, consulta la sezione Iscrizione a Landscape Portal in SAP BTP cockpit.

2. Disponi di un ID utente S valido associato a un numero cliente con un contratto di assistenza SAP attivo.

3. Se non hai mai utilizzato Google Cloud, crea un account su https://cloud.google.com.

4. Se non hai ancora un progetto Google Cloud, creane uno:

   Vai al selettore progetti

5. Assicurati che la fatturazione sia abilitata per il tuo progetto. Per ulteriori informazioni, consulta Verificare lo stato di fatturazione del progetto.

6. Abilita le API supportate a cui prevedi di accedere utilizzando l'SDK. Per informazioni su come abilitare le API Google Cloud, consulta Abilitazione delle API.

Carica i certificati Google

Per proteggere le comunicazioni tra l'ambiente SAP BTP, ABAP e i server Google, devi caricare i certificati Google richiesti nell'app Mantieni elenco di attendibilità certificati del tuo ambiente SAP BTP, ABAP.

Per caricare i certificati nell'app SAP Keep Certificate Trust List, devi avere accesso al catalogo aziendale SAP_CORE_BC_SEC. Questo catalogo aziendale è incluso nel ruolo aziendale predefinito SAP_BR_ADMINISTRATOR.

Per caricare i certificati Google, segui questi passaggi:

1. Scarica i seguenti certificati dal repository Google Trust Services:

   • Radice GTS R1
   • GTS CA 1C3

2. Accedi al SAP BTP Cockpit. Per saperne di più, consulta la pagina SAP Accedere al Cockpit.

3. Seleziona il subaccount in cui è ospitato l'ambiente ABAP.

4. Vai a Istanze e abbonamenti > Istanze e fai clic sulla tua istanza ABAP.

5. Nell'ambiente ABAP che si apre, vai a Tutti gli spazi > Amministrazione > Sicurezza.

6. Apri l'app Mantieni elenco di attendibilità certificati.

7. Fai clic su Aggiungi.

8. Seleziona i certificati che hai scaricato dal repository di Google Trust Services.

9. Fai clic su Carica. I certificati vengono aggiunti all'elenco di attendibilità.

Installa la versione SAP BTP dell'SDK ABAP per Google Cloud

Puoi installare l'edizione SAP BTP dell'SDK ABAP per Google Cloud utilizzando il SAP BTP Landscape Portal.

Per installare l'edizione SAP BTP dell'SDK ABAP per Google Cloud, segui questi passaggi:

1. Scarica il prodotto ABAP SDK per Google Cloud disponibile nel portale orizzontale.

   1. Nel componente BC-CP-ABA, apri una richiesta di assistenza con priorità media per SAP utilizzando una delle seguenti opzioni:

      • Apri una richiesta tramite l'applicazione SAP for Me. Per le linee guida per aprire una richiesta, consulta la pagina SAP Inviare una richiesta.

        

      • Apri una richiesta tramite il portale Landscape. Per le linee guida per aprire una richiesta, consulta la pagina SAP Creare ticket di assistenza.

        

   2. Nella descrizione della richiesta, inserisci i seguenti dettagli:

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

   3. Fornisci eventuali altri dettagli e invia la richiesta.

   Dopo che SAP ha confermato che il prodotto è registrato nel tuo portale orizzontale, vai al passaggio successivo.

   Nota: il requisito di inviare una richiesta a SAP per ottenere l'SDK ABAP per Google Cloud è solo un approccio temporaneo fino a quando non viene stabilito un meccanismo di distribuzione permanente.

2. Esegui il deployment del prodotto ABAP SDK for Google Cloud:

   1. Nel portale orizzontale, apri l'app Deploy.
   2. Nel campo Prodotto, seleziona /GOOG/ABAP_SDK.
   3. Nel campo Versione di destinazione, seleziona 1.0.1.
   4. In Sistemi disponibili, seleziona l'istanza ABAP in cui devi installare l'SDK.
   5. Fai clic su Esegui il deployment. La sezione Stato del deployment della versione del prodotto mostra lo stato di completamento del deployment.

Aggiungi app Fiori a Launchpad

La versione SAP BTP dell'SDK ABAP per Google Cloud fornisce app Fiori SAP per le configurazioni SDK e il logging delle applicazioni. In qualità di amministratore o sviluppatore, puoi usare queste app Fiori per configurare l'SDK e configurare il logging dell'applicazione. L'SDK fornisce inoltre app Fiori dedicate solo per la visualizzazione delle configurazioni di autenticazione, delle configurazioni di logging e l'analisi dei log dell'SDK.

Gli amministratori o gli sviluppatori che configurano l'SDK e il logging o gli utenti che devono solo visualizzare le configurazioni e i log dell'SDK devono avere accesso alle app Fiori pertinenti. Per concedere l'accesso alle app SDK Fiori, devi aggiungere i cataloghi aziendali dell'SDK ABAP per Google Cloud al ruolo aziendale degli utenti che eseguono la configurazione dell'SDK o devono visualizzare le configurazioni e il logging. L'edizione SAP BTP dell'SDK ABAP per Google Cloud include modelli di ruolo aziendali che contengono cataloghi aziendali necessari per accedere alle app Fiori.

La seguente tabella elenca i modelli di ruolo aziendali e le relative app Fiori a cui forniscono l'accesso.

Modello di ruolo aziendale	Nome dell'app	Descrizione
/GOOG/BRT_SDK	SDK Google: configurazione principale	Utilizza questa app per configurare l'autenticazione in modo da connetterti in modo sicuro alle API Google Cloud.
	SDK Google: configurazioni dei log delle applicazioni	Usa questa app per configurare il logging e acquisire errori, avvisi e messaggi informativi nei log delle applicazioni SAP.
	SDK Google: visualizzazione dei log dell'applicazione	Utilizza questa app per visualizzare i log dell'applicazione SDK.
/GOOG/BRT_SDK_DISPLAY	Google SDK: configurazione principale display	Utilizza questa app per visualizzare le configurazioni dell'SDK.
	SDK Google: configurazione dei log di visualizzazione	Utilizza questa app per visualizzare le configurazioni dei log.
	SDK Google: visualizzazione dei log dell'applicazione	Utilizza questa app per visualizzare i log dell'applicazione SDK.

Per aggiungere i cataloghi aziendali dell'SDK ABAP per Google Cloud al ruolo aziendale degli utenti che utilizzano i modelli di ruolo aziendali forniti, devi avere accesso al catalogo aziendale SAP_CORE_BC_SEC. Questo catalogo aziendale è incluso nel ruolo aziendale predefinito SAP_BR_ADMINISTRATOR.

Creare un ruolo aziendale

1. Nel tuo ambiente ABAP, vai a Tutti gli spazi > Amministrazione > Identity and Access Management.
2. Apri l'app Modelli del ruolo aziendale.

3. Cerca e seleziona un modello di ruolo aziendale appropriato:

   • /GOOG/BRT_SDK: fornisce l'accesso alle app Fiori per configurare l'SDK.
   • /GOOG/BRT_SDK_DISPLAY: fornisce l'accesso alle app Fiori per visualizzare i log e le configurazioni dell'SDK.

4. Fai clic su Crea ruolo aziendale.

5. Nella finestra di dialogo Crea ruolo aziendale da modello visualizzata, inserisci un valore per i seguenti campi:

   • Nuovo ID ruolo aziendale: inserisci un ID ruolo aziendale.
   • Descrizione del nuovo ruolo aziendale: inserisci una descrizione per il ruolo aziendale.

6. Fai clic su Ok. Viene visualizzata la pagina Gestisci ruoli aziendali con il ruolo aziendale appena creato.

7. In Categorie di accesso, specifica l'accesso per il ruolo aziendale in base al modello di ruolo aziendale selezionato:

   • /GOOG/BRT_SDK: nel campo Lettura, scrittura, valore della guida, seleziona Senza restrizioni.
   • /GOOG/BRT_SDK_DISPLAY: nel campo Lettura, scrittura, valore della guida, seleziona Nessun accesso.

8. Facoltativamente, nella scheda Cataloghi aziendali assegnati puoi visualizzare i cataloghi aziendali delle app Fiori associate al ruolo aziendale.

9. Fai clic su Salva.

Assegnare uno spazio al ruolo aziendale

1. Nel tuo ambiente ABAP, vai a Tutti gli spazi > Amministrazione > Identity and Access Management.
2. Apri l'app Gestisci i ruoli aziendali.
3. Cerca e seleziona il ruolo aziendale che hai creato nella sezione Creare un ruolo aziendale.
4. Vai alla scheda Spazi di Launchpad assegnati e fai clic su Aggiungi.

5. Nella finestra di dialogo Aggiungi spazio Launchpad visualizzata, inserisci un valore per i seguenti campi:

   • Assegnare uno spazio al ruolo aziendale: seleziona Crea nuovo spazio.
   • ID spazio: inserisci un ID spazio.
   • Descrizione spazio: inserisci una descrizione per lo spazio.
   • Titolo dello spazio: inserisci un titolo per lo spazio.

6. Fai clic su Crea e assegna spazio.

7. Nella scheda Spazi in Launchpad assegnati, fai clic sull'ID del tuo spazio.

8. Nella pagina Dettagli spazio visualizzata, vai alla scheda Pagine e fai clic sull'ID pagina.

9. Nella pagina Pagine di Launchpad gestite che viene visualizzata, vai alla scheda Contenuti pagina, quindi fai clic su Modifica.

10. Nel campo Titolo sezione, inserisci un titolo per la sezione.

11. Nella sezione Derivata da ruolo, seleziona le app Fiori e fai clic su Aggiungi. Queste app Fiori vengono visualizzate dai cataloghi aziendali dell'SDK ABAP per Google Cloud.

12. Fai clic su Salva.

Assegna il ruolo a utenti aziendali

Per concedere l'accesso alle app SDK Fiori, assegna il ruolo appena creato agli utenti aziendali che gestiscono o visualizzano le configurazioni e i log dell'SDK.

1. Nel tuo ambiente ABAP, vai a Tutti gli spazi > Amministrazione > Identity and Access Management.
2. Apri l'app Gestisci i ruoli aziendali.
3. Cerca e seleziona il ruolo aziendale creato nella sezione Creare un ruolo aziendale.
4. Vai alla scheda Utenti aziendali assegnati e fai clic su Aggiungi.
5. Nella finestra di dialogo Aggiungi utenti aziendali visualizzata, cerca e seleziona gli utenti richiesti che devono accedere alle app SDK Fiori.
6. Fai clic su Ok. Gli utenti possono vedere lo spazio assegnato e la pagina con le app SDK Fiori.

Configura autenticazione

Per utilizzare le API Google Cloud, devi confermare la tua identità tramite autenticazione. Per informazioni sulle opzioni di autenticazione in Google Cloud e sui passaggi di configurazione, consulta Autenticazione.

Configurazione logging

L'edizione SAP BTP di ABAP SDK per Google Cloud utilizza i log delle applicazioni SAP per salvare tutti i messaggi generati durante l'esecuzione delle classi delle librerie client. Una volta definita una configurazione predefinita del log, l'SDK inizia a registrare i messaggi.

L'oggetto log /GOOG/LOG_OBJECT e l'oggetto secondario /GOOG/LOG_SUBOBJECT vengono forniti con l'SDK, che puoi utilizzare per creare la configurazione predefinita dei log.

Per creare una configurazione del log, utilizza l'app SDK di Google: configurazioni del log delle applicazioni.

Puoi visualizzare i log delle applicazioni utilizzando l'app Google SDK: Application Logs Display. Per ulteriori informazioni, consulta Visualizzare i log.

Per creare una configurazione di log:

1. Accedi al Launchpad SAP Fiori.
2. Vai allo spazio che contiene le app Fiori per la configurazione dell'SDK.
3. Apri l'app SDK Google: configurazione del log dell'applicazione.
4. Fai clic su Crea.

5. Nella finestra di dialogo Crea visualizzata, inserisci un valore per i seguenti campi:

   • Tipo di configurazione log: seleziona OBJ_SUBOBJ.
   • Oggetto: seleziona /GOOG/LOG_OBJECT.
   • Oggetto secondario: seleziona /GOOG/LOG_SUBOBJECT.

6. Fai clic su Continua.

7. Fornisci i seguenti dettagli:

   • Giorni di conservazione: specifica il numero di giorni in cui i log verranno conservati.

   • Livello di log: specifica il livello minimo di log. I valori supportati sono:

     • I: informazioni, avvisi ed errori
     • W: avvisi ed errori
     • E: solo errori Ti consigliamo di impostare il livello di log su I, in modo da registrare la maggior parte dei messaggi di log.

   • Termina alle: specifica la data di fine entro la quale sarà attiva la configurazione dei log. La data di fine predefinita è 9999/12/31.

   • È predefinita: per impostare questa configurazione come predefinita, seleziona la casella di controllo.

8. Fai clic su Crea.

Gestisci configurazione dei log

Se una configurazione del log non è più necessaria, puoi disabilitarla.

Per disattivare una configurazione di log:

1. Apri l'app SDK Google: configurazione del log dell'applicazione.
2. Nel campo Modifica stato, seleziona uno stato appropriato e fai clic su Vai.
3. Fai clic sulla voce di configurazione del log da disabilitare.
4. Fai clic su Modifica.
5. Imposta Termina alle su una data nel passato.
6. Fai clic su Salva.

Specifica l'endpoint API di Google Cloud

L'edizione SAP BTP dell'SDK ABAP per Google Cloud fornisce le seguenti opzioni per specificare l'endpoint API quando si chiama un'API Google Cloud utilizzando la classe della libreria client API:

• Endpoint predefiniti
• Endpoint personalizzato

Endpoint predefiniti

Per impostazione predefinita, ogni classe API codifica gli endpoint globali come valore costante. La libreria client utilizza questi endpoint quando un metodo viene chiamato per eseguire un'operazione sulle risorse API. Per utilizzare gli endpoint predefiniti, non è necessaria alcuna configurazione aggiuntiva.

Endpoint personalizzati

Negli scenari in cui è necessaria la flessibilità per definire i tuoi endpoint, puoi creare endpoint personalizzati. Ad esempio, puoi creare un endpoint personalizzato per stabilire la connessione a Google Cloud quando devi fare quanto segue:

• Accedi agli endpoint specifici per regione di un'API per applicazioni normative o sensibili alla latenza.
• Usare API specifiche come Vertex AI, che offre solo endpoint a livello di regione.

Per creare un endpoint personalizzato, devi utilizzare lo scenario di comunicazione /GOOG/COM_SDK_SRV fornito con l'SDK ABAP per Google Cloud.

La procedura seguente illustra come creare un endpoint a livello di regione per l'API Pub/Sub. Puoi seguire la stessa procedura per creare endpoint personalizzati per altri servizi Google Cloud supportati.

1. Accedi al Launchpad SAP Fiori del sistema BTP ABAP dove è installato l'SDK ABAP per Google Cloud.
2. Vai a Tutti gli spazi > Amministrazione > Gestione delle comunicazioni.
3. Crea un sistema di comunicazione:
   1. Apri l'app Sistemi di comunicazione.
   2. Fai clic su New (Nuovo).
   3. Nella finestra di dialogo Nuovo sistema di comunicazione visualizzata, inserisci un valore per i seguenti campi:
      • ID sistema: inserisci un ID sistema.
      • Nome del sistema: inserisci un nome per il sistema.
   4. Fai clic su Crea.
   5. Nel campo Nome host, inserisci il tuo endpoint personalizzato. Ad esempio, inserisci un endpoint a livello di regione per il servizio Pub/Sub: https://asia-east1-pubsub.googleapis.com.
   6. Nel campo Porta, inserisci 443.
   7. Nella scheda Utenti per le comunicazioni in uscita, fai clic su Aggiungi.
   8. Nel campo Metodo di autenticazione, seleziona Nessuno.
   9. Fai clic su Crea.
   10. Per salvare il sistema di comunicazione, fai clic su Salva.

4. Crea un accordo di comunicazione:

   1. Apri l'app Communication Arrangement.
   2. Fai clic su New (Nuovo).

   3. Nella finestra di dialogo Nuova disposizione della comunicazione visualizzata, inserisci i seguenti dettagli:

      • Scenario: seleziona Comunicazione in uscita per qualsiasi API (/GOOG/COM_SDK_SRV).
      • Nome disposizione: inserisci un nome per l'accordo di comunicazione.

   4. Fai clic su Crea.

   5. Per l'accordo di comunicazione visualizzato, seleziona il sistema di comunicazione creato nel passaggio precedente nel campo Sistema di comunicazione.

   6. In Comunicazione in uscita, nel campo Nome utente, seleziona Nessuno.

   7. Fai clic su Salva.

5. Crea una mappa di comunicazione per un servizio API:

   1. Vai allo spazio che contiene le app Fiori per la configurazione dell'SDK.
   2. Apri l'app Google SDK: configurazione principale.
   3. Seleziona la chiave client in base alla quale devi creare un endpoint personalizzato. Si presume che tu abbia già creato una chiave client e una mappa di comunicazione per l'autenticazione. In caso contrario, crea una chiave client e una mappa di comunicazione per l'autenticazione. Per ulteriori informazioni, consulta la sezione Autenticazione.
   4. Fai clic su Crea.
   5. Nella finestra di dialogo Crea visualizzata, seleziona il nome di un servizio. Ad esempio, seleziona pubsub:v1.
   6. Fai clic su Continua.
   7. Per la mappa di comunicazione che viene visualizzata, nel campo Disposizione di comunicazione, seleziona la disposizione di comunicazione creata nel passaggio precedente. Gli altri artefatti di comunicazione vengono compilati automaticamente.
   8. Fai clic su Applica.
   9. Fai clic su Salva.
   10. Per convalidare la configurazione personalizzata dell'endpoint, fai clic su Verifica connessione. Un segno di spunta verde indica una voce che indica che la configurazione è andata a buon fine. In caso di errori, visita la pagina per la risoluzione dei problemi per istruzioni su come risolvere gli errori comuni.

Metriche di utilizzo

La versione SAP BTP dell'SDK ABAP per Google Cloud raccoglie le metriche di utilizzo e le invia a Google a scopi di assistenza, in conformità con l'Informativa sulla privacy di Google Cloud (Dati di servizio che raccogliamo). Queste metriche di utilizzo vengono raccolte ogni volta che un'API Google Cloud viene richiamata dall'SDK ABAP per Google Cloud.

L'SDK raccoglie le seguenti metriche di utilizzo:

• Metodo di autenticazione: informazioni sul metodo di autenticazione utilizzato per chiamare i servizi Google Cloud.
• Versione SDK ABAP: n. versione dell'edizione SAP BTP dell'SDK ABAP per Google Cloud.
• Release SAP_ABA: versione del componente software SAP_ABA.

Licenze

L'edizione SAP BTP dell'SDK ABAP per Google Cloud è resa disponibile come "Software" in base al contratto che regola l'utilizzo della Google Cloud Platform da parte dell'utente, inclusi i Termini di servizio specifici disponibili all'indirizzo https://cloud.google.com/terms/service-terms. Senza alcuna limitazione ai termini precedenti, non puoi modificare o distribuire l'SDK ABAP per Google Cloud senza l'espressa autorizzazione scritta di Google.

L'SDK ABAP per il software Google Cloud è offerto senza costi aggiuntivi. Per maggiore chiarezza, l'utilizzo da parte dell'utente di altri "Software" e "Servizi" ai sensi del contratto che regola l'utilizzo della Google Cloud Platform, ad esempio l'API Cloud Translation e l'API Pub/Sub, potrebbe comportare un costo.

L'SDK ABAP per Google Cloud non include alcuna licenza per il software SAP. Devi procurarti separatamente una licenza appropriata per il software SAP.

Ciclo di vita del supporto

Google Cloud supporta e gestisce l'attuale versione principale dell'edizione SAP BTP dell'SDK ABAP per Google Cloud per un periodo di almeno 12 mesi dopo la pubblicazione di una notifica di ritiro per la versione principale precedente nella pagina delle note di rilascio per SAP su Google Cloud.

Richiedi assistenza

Se hai bisogno di aiuto per risolvere problemi con l'SDK ABAP per Google Cloud:

• Consulta la guida alla risoluzione dei problemi relativi all'SDK ABAP per Google Cloud.

• Poni le tue domande e discuti l'SDK ABAP per Google Cloud con la community sui forum Cloud.

• Raccogli tutte le informazioni di diagnostica disponibili e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare l'assistenza clienti, vedi Ricevere assistenza per SAP su Google Cloud.