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. Mediante l'incapsulamento funzioni essenziali come sicurezza, autenticazione, serializzazione dei dati e la deserializzazione e la gestione degli errori come componenti riutilizzabili, questi client le librerie riducono la quantità di codice che gli sviluppatori devono scrivere. Per un elenco completo librerie client fornite dall'SDK ABAP per Google Cloud, consulta Librerie client dell'SDK ABAP per Google Cloud.

In qualità di sviluppatore ABAP, puoi creare ed eseguire il deployment di soluzioni ML e basate su AI di Google Cloud con un'ampia gamma 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 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 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 in SAP Gestire l'app Elenco di attendibilità dei certificati, devi avere accesso al catalogo aziendale SAP_CORE_BC_SEC. Questo catalogo di attività è incluso nel ruolo predefinito per le attivitàSAP_BR_ADMINISTRATOR.

Per caricare i certificati Google, svolgi i seguenti passaggi:

  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 Access the Cockpit (Accesso 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 da Google Trust Services repository Git.

  9. Fai clic su Carica. I certificati vengono aggiunti all'elenco attendibile.

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

Puoi installare la versione SAP BTP dell'SDK ABAP per Google Cloud utilizzando SAP BTP Landscape Portal.

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

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

    1. Nel componente BC-CP-ABA, apri una richiesta con priorità media 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 Portale orizzontale, vai al passaggio successivo.

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

    1. In Landscape Portal, apri l'app Deployment.
    2. Nel campo Product, 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.

Aggiungi le app Fiori al Launchpad

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

Gli amministratori o gli sviluppatori che configurano l'SDK e il logging o coloro agli utenti che devono solo le configurazioni e i log dell'SDK, devono avere accesso ai le app Fiori pertinenti. Per concedere l'accesso all'SDK Per le app Fiori, devi aggiungere i cataloghi aziendali dell'SDK ABAP per Google Cloud il ruolo aziendale degli utenti che eseguono la configurazione dell'SDK o che devono visualizzare configurazioni e logging. L'edizione SAP BTP dell'SDK ABAP per Google Cloud include modelli di ruoli aziendali che contengono i 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 Usa questa app per configurare l'autenticazione e connetterti in modo sicuro alle API Google Cloud.
SDK Google: configurazioni dei log delle applicazioni Utilizza questa app per configurare il logging in modo da acquisire errori, avvisi e messaggi informativi 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 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 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. Nell'ambiente ABAP, vai a Tutti gli spazi > Amministrazione > Identity and Access Management.
  2. Apri l'app Modelli per il ruolo aziendale.

  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 che viene visualizzata, inserisci un valore per i seguenti campi:

    • Nuovo ID ruolo dell'attività: inserisci un ID ruolo dell'attività.
    • Nuova descrizione per il ruolo aziendale: inserisci una descrizione per il ruolo aziendale.

  6. Fai clic su OK. La pagina Gestisci i ruoli aziendali viene visualizzata con le ruolo aziendale.

  7. In Categorie di accesso, specifica l'accesso per l'attività basata sul ruolo aziendale sul 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 visualizza i cataloghi delle attività delle app Fiori associate a ruolo aziendale.

  9. Fai clic su Salva.

Assegnare lo spazio al ruolo aziendale

  1. Nell'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 Assign Launchpad Space (Spazi di Launchpad assegnati) e fai clic su Add (Aggiungi).

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

    • Assegna uno spazio al ruolo aziendale: seleziona Crea nuovo spazio.
    • ID spazio: inserisci un ID spazio.
    • Descrizione dello 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 Assign Launchpad Space (Spazi di Launchpad assegnati), fai clic sull'ID dello spazio del tuo spazio.

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

  9. Nella pagina Pagine della piattaforma di lancio 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 Derivata 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 un 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. Nell'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 Utenti aziendali assegnati e fai clic su Aggiungi.
  5. Nella pagina Aggiungi utenti aziendali cerca e seleziona gli utenti richiesti che necessitano dell'accesso le app SDK Fiori.
  6. Fai clic su OK. Gli utenti possono visualizzare 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 Google Cloud e la procedura di configurazione, vedi Autenticazione.

Configurazione logging

La versione SAP BTP dell'SDK ABAP per Google Cloud utilizza i log delle applicazioni SAP per salvare tutti i messaggi vengono sollevate durante l'esecuzione delle classi della libreria client. Dopo aver definito configurazione predefinita dei log, l'SDK inizia a registrare i messaggi.

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

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 Ti consigliamo di impostare il livello di log su I, in modo che la maggior parte delle vengono registrati i messaggi di log.

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

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

  8. Fai clic su Crea.

Gestisci la configurazione dei log

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

Per disabilitare una configurazione di log, segui questi passaggi:

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

Specifica l'endpoint dell'API Google Cloud

L'edizione SAP BTP dell'SDK ABAP per Google Cloud fornisce le seguenti opzioni per specificare l'endpoint dell'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 codifica gli 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 è necessaria la flessibilità per definire i propri endpoint, puoi creare endpoint personalizzati. Ad esempio, crei un endpoint personalizzato per stabilire la connessione a Google Cloud quando devi eseguire queste operazioni:

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

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 a livello di regione per Pub/Sub tramite Google Cloud CLI o tramite l'API Compute Engine. Puoi seguire la stessa procedura per creare endpoint personalizzati per altri e i servizi Google Cloud supportati.

  1. Accedi al Launchpad SAP Fiori del sistema BTP ABAP dove sia 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 il tuo endpoint personalizzato. Ad esempio: inserisci un endpoint a livello di regione per Pub/Sub servizio: 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'organizzazione delle comunicazioni:

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

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

      • Scenario: seleziona Outbound Communication for any API (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 SDK Google: 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 un 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. Per Ad esempio, seleziona pubsub:v1.
    6. Fai clic su Continua.
    7. Per la mappa delle comunicazioni che viene visualizzata, nel campo Disposizione di comunicazione: seleziona l'accordo di comunicazione che hai creato 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 metriche di utilizzo e li invia a Google per finalità di assistenza, in conformità con Informativa sulla privacy di Google Cloud (Dati di servizio che raccogliamo). 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: n. di versione della versione 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 piattaforma Google Cloud, inclusi i Termini di servizio specifici disponibili all'indirizzo https://cloud.google.com/terms/service-terms. Senza alcuna limitazione ai generalità dei termini precedenti, non puoi modificare o distribuire SDK ABAP per Google Cloud senza l'esplicita autorizzazione scritta di Google.

L'SDK ABAP per Google Cloud è offerto senza costi. Per chiarire, l'utilizzo di altro "Software" e "Servizi" ai sensi del contratto che regola l'utilizzo della piattaforma Google Cloud, 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 acquistare 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: