Questo documento descrive come installare e configurare la versione SAP BTP dell'SDK ABAP per Google Cloud nell'ambiente SAP BTP e ABAP.
Questo documento è rivolto agli amministratori SAP, agli amministratori di Google Cloud, e 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 a livello di programmazione 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:
Iscriviti al SAP BTP Landscape Portal. Per informazioni sull'iscrizione al portale Landscape, consulta la sezione Iscrizione al portale Landscape nel SAP BTP cockpit.
Devi avere un S-User ID valido associato a un numero cliente con un contratto di assistenza SAP attivo.
Se non hai mai utilizzato Google Cloud, crea un account su https://cloud.google.com.
Se non hai ancora un progetto Google Cloud, creane uno:
Assicurati che la fatturazione sia abilitata per il tuo progetto. Per ulteriori informazioni, consulta Verificare lo stato di fatturazione del progetto.
Abilita le API supportate a cui prevedi di accedere utilizzando l'SDK. Per informazioni su come attivare API Google Cloud, vedi Abilitazione delle API.
Carica i certificati Google
Per proteggere le comunicazioni tra l'ambiente SAP BTP, ABAP e Google , devi caricare i certificati Google richiesti nel App Gestisci l'elenco di attendibilità dei certificati del tuo ambiente SAP BTP e ABAP.
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 aziendale è incluso nel ruolo aziendale predefinito
SAP_BR_ADMINISTRATOR.
Per caricare i certificati Google, svolgi i seguenti passaggi:
Scarica i seguenti certificati dal repository di Google Trust Services:
- Radice GTS R1
- GTS CA 1C3
Accedi a SAP BTP Cockpit. Per ulteriori informazioni, consulta la pagina SAP Access the Cockpit (Accesso al cockpit).
Seleziona il subaccount in cui è ospitato l'ambiente ABAP.
Vai a Istanze e sottoscrizioni > Istanze, e fai clic sulla tua istanza ABAP.
Nell'ambiente ABAP che si apre, vai a Tutti gli spazi > Amministrazione > Sicurezza.
Apri l'app Gestisci l'elenco di attendibilità dei certificati.
Fai clic su Aggiungi.
Seleziona i certificati che hai scaricato da Google Trust Services repository Git.
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 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:
Scarica il prodotto ABAP SDK for Google Cloud disponibile nel tuo portale orizzontale.
Nel componente BC-CP-ABA, apri una richiesta con priorità media con SAP utilizzando una delle seguenti opzioni:
Aprire una richiesta tramite il servizio SAP for Me un'applicazione. Per le linee guida su come aprire una richiesta, consulta la pagina SAP Invio di una richiesta.
Apri una richiesta tramite il portale orizzontale. Per le linee guida su come aprire una richiesta, consulta la pagina SAP Create Support Tickets.
Nella descrizione della richiesta, inserisci i seguenti dettagli:
We would like the following product registered to our Landscape Portal: * Product: /GOOG/ABAP_SDK * Publisher: GoogleFornisci altri dettagli, se necessario, e invia la richiesta.
Dopo che SAP ha confermato che il prodotto è registrato nel tuo Portale orizzontale, vai al passaggio successivo.
Esegui il deployment del prodotto ABAP SDK for Google Cloud:
- Nel portale orizzontale, apri l'app Deploy.
- Nel campo Product, seleziona
/GOOG/ABAP_SDK. - Nel campo Versione di destinazione, seleziona
1.0.1. - In Sistemi disponibili, seleziona l'istanza ABAP in cui hai bisogno per installare l'SDK.
- Fai clic su Esegui il deployment. La sezione Stato di deployment 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 SDK e il logging delle applicazioni. In qualità di amministratore o sviluppatore, utilizzerai queste app Fiori per configurare l'SDK e configurare il logging dell'applicazione. 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. La versione SAP BTP dell'SDK ABAP per Google Cloud include modelli di ruolo aziendale che contengono cataloghi delle attività 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 log display | 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. |
Aggiungere i cataloghi aziendali dell'SDK ABAP per Google Cloud a
il ruolo aziendale degli utenti che utilizzano i modelli di ruolo aziendali forniti, devi
hanno accesso al catalogo aziendale
SAP_CORE_BC_SEC. Questo catalogo aziendale è incluso nella definizione aziendale predefinita
ruolo SAP_BR_ADMINISTRATOR.
Creare un ruolo aziendale
- Nell'ambiente ABAP, vai a Tutti gli spazi > Amministrazione > Identity and Access Management.
- Apri l'app Modelli per il ruolo aziendale.
Cerca e seleziona un modello di ruolo aziendale appropriato:
/GOOG/BRT_SDK: fornisce accesso alle app Fiori per configurazione dell'SDK./GOOG/BRT_SDK_DISPLAY: fornisce accesso alle app Fiori per la visualizzazione dei log e delle configurazioni dell'SDK.
Fai clic su Crea ruolo aziendale.
Nella finestra di dialogo Crea ruolo aziendale da modello che viene visualizzata, inserisci un valore per i seguenti campi:
- Nuovo ID ruolo aziendale: inserisci un ID ruolo aziendale.
- Nuova descrizione per il ruolo aziendale: inserisci una descrizione per il ruolo aziendale.
Fai clic su OK. La pagina Gestisci i ruoli aziendali viene visualizzata con le ruolo aziendale.
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 di lettura, scrittura, valore, seleziona Senza restrizioni./GOOG/BRT_SDK_DISPLAY: nel campo Guida lettura, scrittura, valore, seleziona Nessun accesso.
Facoltativamente, nella scheda Cataloghi aziendali assegnati, puoi visualizza i cataloghi delle attività delle app Fiori associate a ruolo aziendale.
Fai clic su Salva.
Assegna uno spazio al ruolo aziendale
- Nell'ambiente ABAP, vai a Tutti gli spazi > Amministrazione > Identity and Access Management.
- Apri l'app Gestisci ruoli aziendali.
- Cerca e seleziona il ruolo aziendale che hai creato nella sezione Creare un ruolo aziendale.
- Vai alla scheda Assign Launchpad Space (Spazi di Launchpad assegnati) e fai clic su Add (Aggiungi).
Nella finestra di dialogo Aggiungi spazio di 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.
Fai clic su Crea e assegna spazio.
Nella scheda Assign Launchpad Space (Spazi di Launchpad assegnati), fai clic sull'ID dello spazio del tuo spazio.
Nella pagina Dettagli spazio visualizzata, vai alla scheda Pagine, quindi fai clic sull'ID pagina.
Nella pagina Pagine del Launchpad gestito che viene visualizzata, vai alla Contenuti pagina e poi fai clic su Modifica.
Nel campo Titolo sezione, inserisci un titolo per la sezione.
Nella sezione Derivata dal ruolo, seleziona le app Fiori e poi fai clic su Aggiungi. Queste app Fiori sono visualizzate dai cataloghi delle attività di l'SDK ABAP per Google Cloud.
Fai clic su Salva.
Assegnare un ruolo agli utenti aziendali
Per concedere l'accesso all'SDK alle app Fiori, tu assegnerai le app appena create agli utenti aziendali che gestiscono o visualizzano le configurazioni e i log dell'SDK.
- Nell'ambiente ABAP, vai a Tutti gli spazi > Amministrazione > Identity and Access Management.
- Apri l'app Gestisci ruoli aziendali.
- Cerca e seleziona il ruolo aziendale che hai creato nella sezione Creare un ruolo aziendale.
- Vai alla scheda Utenti aziendali assegnati e fai clic su Aggiungi.
- Nella pagina Aggiungi utenti aziendali cerca e seleziona gli utenti richiesti che necessitano dell'accesso le app SDK Fiori.
- Fai clic su OK. Gli utenti possono visualizzare lo spazio e la pagina assegnati con le app SDK Fiori.
Configura l'autenticazione
Per utilizzare le API Google Cloud, devi confermare la tua identità entro il giorno 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 SDK Google: configurazioni dei log delle applicazioni per creare configurazione di log.
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, segui questi passaggi:
- Accedi al Launchpad di SAP Fiori.
- Vai allo spazio che contiene le app Fiori per la configurazione dell'SDK.
- Apri l'app Google SDK: configurazione dei log delle applicazioni.
- Fai clic su Crea.
Nella finestra di dialogo Crea visualizzata, inserisci un valore. per i seguenti campi:
- Tipo di configurazione del log: seleziona
OBJ_SUBOBJ. - Oggetto: seleziona
/GOOG/LOG_OBJECT. - Oggetto secondario: seleziona
/GOOG/LOG_SUBOBJECT.
- Tipo di configurazione del log: seleziona
Fai clic su Continua.
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 erroriW: avvisi ed erroriE: solo errori Ti consigliamo di impostare il livello di log suI, in modo che la maggior parte delle vengono registrati i messaggi di log.
End at (Fine alle): specifica la data di fine della configurazione del log sarà attiva. La data di fine predefinita è
9999/12/31.È predefinita: per impostare questa configurazione del log come predefinita, seleziona la casella di controllo.
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:
- Apri l'app Google SDK: configurazione dei log delle applicazioni.
- Nel campo Stato modifica, seleziona uno stato appropriato, quindi fai clic su Vai.
- Fai clic sulla voce di configurazione del log che devi disabilitare.
- Fai clic su Modifica.
- Imposta Fine alle su una data nel passato.
- Fai clic su Salva.
Specifica l'endpoint API di Google Cloud
La versione SAP BTP dell'SDK ABAP per Google Cloud offre le seguenti opzioni per specificando l'endpoint API durante la chiamata di un'API Google Cloud utilizzando la classe della libreria client API:
- Endpoint predefiniti
- Endpoint personalizzato
Endpoint predefiniti
Per impostazione predefinita, ogni classe API esegue l'hardcode degli endpoint globali come valore costante. La libreria client utilizza questi endpoint quando viene chiamato un metodo per eseguire un'operazione sulle risorse API. Per utilizzare gli endpoint predefiniti, non è necessario configurazione obbligatoria.
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:
- Accesso agli endpoint specifici per regione di un'API per applicazioni 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 API. Puoi seguire la stessa procedura per creare endpoint personalizzati per altri e i servizi Google Cloud supportati.
- Accedi al Launchpad SAP Fiori del sistema BTP ABAP dove sia installato l'SDK ABAP per Google Cloud.
- Vai a Tutti gli spazi > Amministrazione > Gestione delle comunicazioni.
- Crea un sistema di comunicazione:
- Apri l'app Communication Systems.
- Fai clic su New (Nuovo).
- Nella finestra di dialogo Nuovo sistema di comunicazione visualizzata, inserisci un valore per
nei seguenti campi:
- .
- ID sistema: inserisci un ID di sistema.
- Nome sistema: inserisci un nome di sistema.
- Fai clic su Crea.
- 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. - Nel campo Porta, inserisci
443. - Nella scheda Utenti per le comunicazioni in uscita, fai clic su Aggiungi.
- Nel campo Metodo di autenticazione, seleziona Nessuno.
- Fai clic su Crea.
- Per salvare il sistema di comunicazione, fai clic su Salva.
Stabilisci un accordo di comunicazione:
- Apri l'app Comunicazione.
- Fai clic su New (Nuovo).
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 dell'organizzazione: inserisci un nome per l'accordo di comunicazione.
- Scenario: seleziona Outbound Communication for any API (Comunicazione in uscita per qualsiasi API) (
Fai clic su Crea.
Per le modalità di comunicazione visualizzate, nel campo Sistema di comunicazione seleziona il sistema di comunicazione che hai creato nel passaggio precedente.
In Comunicazione in uscita, nel campo Nome utente, seleziona Nessuno.
Fai clic su Salva.
Crea una mappa di comunicazione per un servizio API:
- Vai allo spazio che contiene le app Fiori per la configurazione dell'SDK.
- Apri l'app SDK Google: configurazione principale.
- Seleziona la chiave client in base alla quale 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 autenticazione. Per ulteriori informazioni, consulta la sezione Autenticazione.
- Fai clic su Crea.
- Nella finestra di dialogo Crea che viene visualizzata, seleziona il nome di un servizio. Per
Ad esempio, seleziona
pubsub:v1. - Fai clic su Continua.
- 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.
- Fai clic su Applica.
- Fai clic su Salva.
- Per convalidare la configurazione personalizzata dell'endpoint, fai clic su Verifica connessione. Il segno di spunta verde per una voce indica che la configurazione è riuscita. In caso di errori, visita la pagina di risoluzione dei problemi per avere 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 le 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 un'API Google Cloud viene chiamato 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. 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 è stata resa disponibile come "Software" nel contratto che regola l'utilizzo della Google Cloud Platform, tra cui i Termini specifici del servizio 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 chiarezza, l'uso da parte dell'utente di altro "Software" e "Servizi" ai sensi del contratto che disciplina l'utilizzo della Google Cloud Platform, ad esempio L'API Cloud Translation e l'API Pub/Sub potrebbero comportare dei costi.
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 le principali della versione SAP BTP dell'SDK ABAP per Google Cloud per un periodo di almeno 12 mesi dopo la pubblicazione di un avviso di ritiro per i alla versione principale Pagina delle note di rilascio per SAP su Google Cloud.
Assistenza
Se hai bisogno di aiuto per risolvere i problemi con l'SDK ABAP per Google Cloud, procedi le seguenti:
Consulta la guida alla risoluzione dei problemi relativi all'SDK ABAP per Google Cloud.
Poni le tue domande e discuti dell'SDK ABAP per Google Cloud con la community attivo Forum di Cloud.
Raccogli tutte le informazioni di diagnostica disponibili. e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare Per l'assistenza clienti, vedi Ottenere assistenza per SAP su Google Cloud.