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 di Google Cloud e ad altri professionisti della sicurezza SAP e Google Cloud .

Panoramica

L'ABAP SDK 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'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 un'ampia gamma di servizi Google Cloudcome Vertex AI, Document AI Warehouse, BigQuery, Dataproc, Pub/Sub, API Google Workspace e Google Maps Platform.

Dalla versione 1.1, la versione SAP BTP dell'SDK ABAP per Google Cloud offre un'interazione senza problemi con la piattaforma Vertex AI di Google Cloudtramite uno strumento dedicato, l'SDK Vertex AI per ABAP. Per informazioni sull'SDK Vertex AI per ABAP, consulta la Panoramica dell'SDK Vertex AI per ABAP.

Per la comunicazione tra SAP e le API Google Cloud , l'ABAP SDK 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. Devi disporre 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 , crea un progetto:

    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 APIGoogle 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 avere 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.1.0.
    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 le app Fiori al Launchpad

A partire dalla versione 1.1, l'edizione SAP BTP dell'SDK ABAP per Google Cloud è pacchettizzata con le app Fiori SAP 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 la registrazione 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 applicazione 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.
SDK Vertex AI: configura i parametri di generazione del modello Utilizza questa app per configurare i parametri di generazione del modello.
SDK Vertex AI: configurazione di Vector Search Utilizza questa app per configurare i parametri di ricerca di vettori.
/GOOG/BRT_SDK_DISPLAY SDK Google: visualizza la configurazione principale 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.
SDK Vertex AI: parametri di generazione del modello di visualizzazione Utilizza questa app per visualizzare i parametri di generazione del modello.
SDK Vertex AI: Display Vector Search Config Utilizza questa app per visualizzare la configurazione del parametro di ricerca vettoriale.

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 aziendale predefinito SAP_BR_ADMINISTRATOR.

Creare un ruolo aziendale e assegnarlo agli utenti

A partire dalla versione 1.1, l'edizione SAP BTP dell'SDK ABAP per Google Cloud viene fornita con lo spazio predefinito /GOOG/SDK_CONFIG_SPACE e la pagina predefinita /GOOG/SDK_CONFIG_PAGE, che ti consentono di fornire più facilmente agli utenti l'accesso alle app SAP Fiori.

Per creare un ruolo aziendale e assegnarlo agli utenti, svolgi i seguenti passaggi:

  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. Fai clic su Crea da modello.
  4. Nella finestra di dialogo Crea ruolo aziendale da modello visualizzata, inserisci i valori per i seguenti campi:
    1. Modello: inserisci /GOOG/BRT_SDK.
    2. Nuovo ID ruolo dell'attività:inserisci un ID ruolo dell'attività.
    3. Nuova descrizione del ruolo dell'attività: inserisci una descrizione per il ruolo dell'attività.
    4. Opzione per gli spazi: verifica che sia selezionata l'opzione Utilizza spazi predefiniti.
    5. Fai clic su OK.
  5. In Categorie di accesso, per il campo Guida Lettura, scrittura, valore, selezionate Senza restrizioni.
  6. Vai alla scheda Utenti dell'attività, fai clic su Modifica e poi su Aggiungi.
  7. Nella finestra di dialogo Aggiungi utenti aziendali visualizzata, cerca e seleziona gli utenti richiesti che devono accedere alle app SDK Fiori.
  8. Fai clic su OK. Gli utenti possono vedere lo spazio e la pagina assegnati con le app SDK Fiori.
  9. Fai clic su Salva.
  10. Se vuoi fornire ad alcuni utenti l'accesso di sola visualizzazione alle app SDK Fiori, ripeti i passaggi descritti in questa sezione utilizzando i seguenti dettagli:
    • Crea un ruolo aziendale utilizzando il modello /GOOG/BRT_SDK_DISPLAY.
    • In Categorie di accesso, per il campo Guida Lettura, Scrittura, Valore, selezionate Nessun accesso.

Configura autenticazione

Per utilizzare le API Google Cloud , devi confermare la tua identità tramite l'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 rilevati 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 i quali 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 dell'API Google Cloud

L'edizione SAP BTP di ABAP SDK for 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 accordo 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 un'API Google Cloud viene invocata 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: 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 viene 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 limitare la generalità 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 altri "Software" e "Servizi" ai sensi del contratto che regola l'utilizzo della piattaforma Google Cloud , 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 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: