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

Questo documento descrive come installare e configurare la versione SAP BTP dell'SDK ABAP per Google Cloud nell'ambiente ABAP di SAP BTP.

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

Panoramica

L'ABAP SDK for 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'ABAP SDK for Google Cloud, consulta Librerie client ABAP SDK for Google Cloud.

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

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

Prima di iniziare

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

  1. Abbonati al portale del panorama SAP BTP. Per informazioni sull'abbonamento al portale Landscape, consulta Abbonamento al portale Landscape nella Cockpit di SAP BTP.

  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 all'indirizzo https://cloud.google.com.

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

    Vai al selettore dei progetti

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

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

Carica i certificati Google

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

Per caricare i certificati nell'app SAP Maintain Certificate Trust List, devi disporre dell'accesso al catalogo aziendale SAP_CORE_BC_SEC. Questo catalogo di attività è incluso nel ruolo aziendale predefinitoSAP_BR_ADMINISTRATOR.

Per caricare i certificati Google:

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

    • GTS Root R1
    • GTS CA 1C3

  2. Accedi a SAP BTP Cockpit. Per ulteriori informazioni, 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 sull'istanza ABAP.

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

  6. Apri l'app Gestisci elenco attendibilità dei 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 attendibili.

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

Installa la versione SAP BTP di ABAP SDK for Google Cloud utilizzando il portale del paesaggio SAP BTP.

Per installare la versione SAP BTP dell'SDK ABAP per Google Cloud, svolgi i seguenti passaggi:

  1. Ottieni il prodotto ABAP SDK for Google Cloud disponibile nel tuo Landscape Portal.

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

    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 altri dettagli, se opportuno, e invia la richiesta.

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

    Potrebbero essere necessari fino a 3 giorni lavorativi per registrare l'SDK ABAP per Google Cloud nel tuo Landscape Portal. Se l'SDK non è ancora registrato dopo questo periodo di tempo, contatta l'assistenza clienti Google Cloud per ricevere assistenza. Per informazioni su come contattare l'assistenza clienti, consulta Assistenza per SAP su Google Cloud.

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

    1. In Landscape Portal, apri l'app Deployment.
    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 di implementazione della versione del prodotto mostra lo stato di completamento del deployment.

Aggiungere app Fiori al Launchpad

La versione SAP BTP dell'SDK ABAP per Google Cloud fornisce app SAP Fiori per le configurazioni dell'SDK e la registrazione delle applicazioni. In qualità di amministratore o sviluppatore, utilizzi queste app Fiori per configurare l'SDK e il logging delle applicazioni. L'SDK fornisce anche app Fiori dedicate solo per visualizzare le configurazioni di autenticazione, le configurazioni di registrazione e analizzare i log dell'SDK.

Gli amministratori o gli sviluppatori che configurano l'SDK e la registrazione 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 che devono visualizzare le configurazioni e i log. L'edizione SAP BTP dell'SDK ABAP per Google Cloud include modelli di ruoli aziendali che contengono cataloghi aziendali necessari per accedere alle app Fiori.

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

Modello di ruolo aziendale Nome app Descrizione
/GOOG/BRT_SDK SDK Google: configurazione principale Utilizza questa app per configurare l'autenticazione per connetterti in modo sicuro alle API Google Cloud.
SDK Google: configurazioni dei log delle applicazioni Utilizza questa app per configurare la registrazione in modo da acquisire errori, avvisi e messaggi di informazioni nei log delle applicazioni SAP.
SDK Google: visualizzazione dei log delle applicazioni Utilizza questa app per visualizzare i log dell'applicazione SDK.
/GOOG/BRT_SDK_DISPLAY SDK Google: configurazione principale della visualizzazione 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 delle applicazioni.
SDK Google: visualizzazione dei log delle applicazioni 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 aziendale forniti, devi avere accesso al catalogo aziendaleSAP_CORE_BC_SEC. Questo catalogo di attività è incluso nel ruolo dell'attività predefinito SAP_BR_ADMINISTRATOR.

Creare un ruolo aziendale

  1. Nel tuo ambiente ABAP, vai a Tutti gli spazi > Amministrazione > Gestione dell'identità e dell'accesso.
  2. Apri l'app Modelli di ruoli aziendali.

  3. Cerca e seleziona un modello di ruolo aziendale, a seconda dei casi:

    • /GOOG/BRT_SDK: fornisce l'accesso alle app Fiori per la configurazione dell'SDK.
    • /GOOG/BRT_SDK_DISPLAY: fornisce l'accesso alle app Fiori per visualizzare le configurazioni e i log 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 dell'attività: inserisci un ID ruolo dell'attività.
    • Nuova descrizione del ruolo dell'attività: inserisci una descrizione per il ruolo dell'attività.

  6. Fai clic su OK. Viene visualizzata la pagina Gestisci i ruoli dell'attività con il ruolo dell'attività 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 Guida a Lettura, Scrittura, Valore, seleziona Senza restrizioni.
    • /GOOG/BRT_SDK_DISPLAY: nel campo Guida Lettura, scrittura, valore, seleziona Nessun accesso.

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

  9. Fai clic su Salva.

Assegnare lo spazio al ruolo aziendale

  1. Nel tuo ambiente ABAP, vai a Tutti gli spazi > Amministrazione > Gestione dell'identità e dell'accesso.
  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 Launchpad assegnati e fai clic su Aggiungi.

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

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

  6. Fai clic su Crea e assegna spazio.

  7. Nella scheda Spazi Launchpad assegnati, fai clic sull'ID dello spazio.

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

  9. Nella pagina Pagine Launchpad gestite visualizzata, vai alla scheda Contenuti pagina e fai clic su Modifica.

  10. Nel campo Titolo sezione, inserisci un titolo della sezione.

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

  12. Fai clic su Salva.

Assegnare il ruolo agli 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 > Gestione dell'identità e dell'accesso.
  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 Utenti aziendali assegnati e fai clic su Aggiungi.
  5. Nella finestra di dialogo Aggiungi utenti aziendali che viene 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 e la pagina assegnati 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 per Google Cloud e sulla procedura di configurazione, consulta Autenticazione.

Configurazione logging

La versione SAP BTP dell'SDK ABAP per Google Cloud utilizza i log delle applicazioni SAP per salvare tutti i messaggi sollevati durante l'esecuzione delle classi della libreria client. Una volta definita una configurazione di log predefinita, l'SDK inizia a registrare i messaggi.

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

Utilizza l'app Google SDK: configurazioni dei log delle applicazioni per creare una configurazione dei log.

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

Per creare una configurazione dei log, segui questi passaggi:

  1. Accedi alla piattaforma di lancio SAP Fiori.
  2. Vai allo spazio che contiene le app Fiori per la configurazione dell'SDK.
  3. Apri l'app Google SDK: configurazione dei log delle applicazioni.
  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 per 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 Consigliamo di impostare il livello del log su I, in modo che la maggior parte dei messaggi del log venga registrata.

    • Fine: specifica la data di fine fino alla quale sarà attiva questa configurazione del log. La data di fine predefinita è 9999/12/31.

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

  8. Fai clic su Crea.

Gestire la configurazione dei log

Se una configurazione dei log non è più necessaria, puoi disattivarla.

Per disattivare una configurazione dei log, segui questi passaggi:

  1. Apri l'app Google SDK: configurazione dei log delle applicazioni.
  2. Nel campo Stato di modifica, seleziona uno stato appropriato e poi fai clic su Vai.
  3. Fai clic sulla voce di configurazione del log da disattivare.
  4. Fai clic su Modifica.
  5. Imposta Fine su una data passata.
  6. Fai clic su Salva.

Specifica l'endpoint API 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 dell'API:

  • Endpoint predefiniti
  • Endpoint personalizzato

Endpoint predefiniti

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

Endpoint personalizzati

Negli scenari in cui hai bisogno della flessibilità di definire i tuoi endpoint, puoi creare endpoint personalizzati. Ad esempio, crei un endpoint personalizzato per stabilire la connessione a Google Cloud quando devi:

  • Accedi agli endpoint specifici per regione di un'API per applicazioni soggette a normative o sensibili alla latenza.
  • Utilizza API specifiche come Vertex AI, che offrono solo endpoint regionali.

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

La procedura seguente illustra come creare un endpoint regionale 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 ABAP BTP in cui è 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 sistema: inserisci un nome di sistema.
    4. Fai clic su Crea.
    5. Nel campo Nome host, inserisci l'endpoint personalizzato. Ad esempio, inserisci un endpoint regionale 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 Nessuna.
    9. Fai clic su Crea.
    10. Per salvare il sistema di comunicazione, fai clic su Salva.

  4. Crea un'organizzazione delle comunicazioni:

    1. Apri l'app Accordo di comunicazione.
    2. Fai clic su New (Nuovo).

    3. Nella finestra di dialogo Nuovo arrangiamento di comunicazione visualizzata, inserisci i seguenti dettagli:

      • Scenario: seleziona Comunicazione in uscita per qualsiasi API (/GOOG/COM_SDK_SRV).
      • Nome organizzazione: inserisci un nome per l'organizzazione delle comunicazioni.

    4. Fai clic su Crea.

    5. Per l'organizzazione della comunicazione visualizzata, nel campo Sistema di comunicazione, seleziona il sistema di comunicazione creato nel passaggio precedente.

    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 un nome del servizio. Ad esempio, seleziona pubsub:v1.
    6. Fai clic su Continua.
    7. Per la mappa di comunicazione visualizzata, nel campo Disposizione della comunicazione, seleziona la disposizione della comunicazione creata nel passaggio precedente. Gli altri elementi di comunicazione vengono compilati automaticamente.
    8. Fai clic su Applica.
    9. Fai clic su Salva.
    10. Per convalidare la configurazione dell'endpoint personalizzato, fai clic su Verifica connessione. Un segno di spunta verde per una voce indica che la configurazione è andata a buon fine. In caso di errori, consulta la pagina sulla risoluzione dei problemi per indicazioni 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 per scopi di assistenza, in conformità con Informativa sulla privacy di Google Cloud (Dati di servizio raccolti). Queste metriche di utilizzo vengono raccolte ogni volta che viene invocata un'API Google Cloud dall'ABAP SDK 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: numero di versione dell'edizione SAP BTP dell'SDK ABAP per Google Cloud.
  • Release SAP_ABA: versione del componente software SAP_ABA.

Licenze

La versione SAP BTP dell'SDK ABAP per Google Cloud è resa disponibile come "Software" ai sensi del contratto che regola l'utilizzo della Google Cloud Platform, inclusi i Termini di servizio specifici disponibili all'indirizzo https://cloud.google.com/terms/service-terms. Senza alcuna limitazione alla portata generale dei termini precedenti, non puoi modificare o distribuire l'SDK ABAP per Google Cloud senza l'autorizzazione scritta espressa di Google.

Il software ABAP SDK for Google Cloud è offerto senza costi. Per chiarire, l'utilizzo di altro "Software" e "Servizi" ai sensi del contratto che regola l'utilizzo della Google Cloud Platform, come 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 dell'assistenza

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 dalla pubblicazione di una notifica di ritiro della versione principale precedente nella pagina delle note di rilascio per SAP su Google Cloud.

Assistenza

Se hai bisogno di aiuto per risolvere i problemi relativi all'SDK ABAP per Google Cloud, segui questi passaggi: