Questo documento mostra come installare e configurare l'edizione on-premise o qualsiasi cloud dell'SDK ABAP per Google Cloud nel tuo sistema host SAP su istanze VM di Compute Engine, on-premise, su un altro cloud provider o in un altro ambiente esterno a Google Cloud.
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 per consentire agli sviluppatori di utilizzare ABAP per accedere in modo programmatico alle API Google Cloud. Incapsulando le funzioni essenziali 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'SDK ABAP per Google Cloud:
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.
Assicurati che le versioni del software SAP che stai utilizzando siano supportate dall'SDK ABAP per Google Cloud. Per maggiori informazioni, consulta i requisiti di versione del software SAP.
Requisiti di versione del software SAP
L'SDK ABAP per Google Cloud utilizza il componente aggiuntivo SAP User Interface (UI) per serializzare i dati ABAP in formato JSON.
Assicurati che siano implementate le ultime correzioni per la classe /UI2/CL_JSON.
La tabella seguente spiega la versione minima dei componenti necessari per l'installazione dell'SDK:
| SAP | SAP NetWeaver | Componente aggiuntivo UI SAP |
|---|---|---|
| SAP ERP 6.0 (ECC) | SAP_BASIS 702 o versioni successive |
/UI2/CL_JSON: PL12 o versioni successive. Per ulteriori informazioni, consulta la nota SAP 22798102 - /UI2/CL_JSON correzioni - PL12 Il componente aggiuntivo SAP UI deve essere compatibile con la tua versione di SAP Netweaver. Per informazioni sulla compatibilità dei componenti aggiuntivi della UI SAP, vedi: |
| S/4HANA 1909 o versioni successive | SAP_BASIS 752 o versioni successive |
Stabilire una connessione di rete a Google Cloud
Se il tuo carico di lavoro SAP non è in esecuzione su Google Cloud, tu o un amministratore di rete dovete stabilire una connessione sicura a Google Cloud a bassa latenza e a larghezza di banda elevata.
Puoi accedere alle API Google Cloud tramite la rete internet pubblica. Per saperne di più, consulta Informazioni sulle API Cloud. Se i tuoi server SAP non hanno accesso a internet pubblico, connettili a Google Cloud utilizzando uno dei seguenti metodi:
- Cloud Interconnect (consigliato)
- Cloud VPN
Per configurare una connessione, segui le istruzioni fornite dal prodotto per la connettività di rete Google Cloud appropriato. Ogni prodotto ha un insieme diverso di istruzioni per scenari diversi, quindi rivedi la documentazione e segui le istruzioni specifiche per il tuo scenario.
Se il carico di lavoro SAP è in esecuzione su Google Cloud, l'SDK ABAP per Google Cloud utilizza la rete VPC sottostante.
Installa l'SDK ABAP per Google Cloud
L'SDK ABAP per Google Cloud viene fornito sotto forma di file di trasporto che installi in SAP NetWeaver.
Scarica il pacchetto di installazione che contiene i file di trasporto dal portale di download.
Copia i file di trasporto dell'SDK ABAP per Google Cloud nelle directory di importazione del trasporto di SAP Server.
L'SDK ABAP per Google Cloud fornisce due insiemi di file di trasporto:
Per le API e l'autenticazione Google Cloud supportate tramite token o chiavi API, copia i seguenti file di trasporto nelle directory di importazione per il trasporto di SAP Server:
/usr/sap/trans/cofiles/K900271.GM1/usr/sap/trans/data/R900271.GM1
Per l'autenticazione basata sulle credenziali client OAuth 2.0, copia i seguenti file di trasporto nelle directory di importazione del trasporto del server SAP:
/usr/sap/trans/cofiles/K900275.GM1/usr/sap/trans/data/R900275.GM1Questi file di trasporto non forniscono funzionalità aggiuntive diverse dall'autenticazione client OAuth 2.0 basata sulle credenziali. Per l'autenticazione basata su credenziali client OAuth 2.0, importa prima i file di trasporto per le API Google Cloud supportate e poi importa i file di trasporto per le credenziali del client OAuth 2.0.
Per utilizzare le credenziali client OAuth 2.0, il sistema SAP deve supportare OAuth 2.0. Per informazioni sui sistemi SAP che supportano OAuth 2.0, consulta la nota SAP 3041322 - Client OAuth 2.0: downport di credenziali client di tipo concessione.
Se aggiorni l'SDK da una versione precedente alla versione 1.7, copia i seguenti file di trasporto nelle directory di importazione del trasporto del server SAP:
/usr/sap/trans/cofiles/K900279.GM1/usr/sap/trans/data/R900279.GM1Questi file di trasporto rimuovono gli artefatti deprecati dall'SDK ABAP per Google Cloud. Se installi l'SDK per la prima volta, non è necessario copiare questi file di trasporto.
Nella GUI di SAP, utilizza il codice transazione
STMS_IMPORToSTMSper importare i file nel sistema SAP.Assicurati che tutti gli oggetti nel pacchetto
/GOOG/ABAP_SDKsiano attivi e coerenti:- Nella GUI di SAP, inserisci il codice transazione
SE80. - Nel selettore del pacchetto, seleziona
/GOOG/ABAP_SDK. - Nel campo Nome oggetto, fai clic con il tasto destro del mouse sul pacchetto
/GOOG/ABAP_SDK, quindi scegli Seleziona > Verifica pacchetto > Oggetti pacchetto (inclusi sottopacchetti). Fai clic sull'icona Passa a visualizzazione elenco.
Un segno di spunta verde nella colonna Risultato del controllo pacchetto indica che tutti gli oggetti hanno superato il controllo del pacchetto.
- Nella GUI di SAP, inserisci il codice transazione
Configura le impostazioni di sicurezza SAP
Segui questi passaggi per collegare in modo sicuro l'SDK ABAP per Google Cloud alle API Google Cloud.
Configura i certificati SSL
Scarica e importa i certificati Google richiesti in STRUST.
Scarica i seguenti certificati dal repository Google Trust Services:
- Radice GTS R1
- GTS CA 1C3
PEMeDERsono formati di certificato di uso comune. Puoi scaricare i certificati in un formato compatibile con il tuo sistema SAP. Se il formato richiesto non è disponibile, consulta la nota SAP 2755238 - Come convertire un certificato nel formato appropriato con OpenSSL per convertire i certificati nel formato richiesto.Nella GUI di SAP, inserisci il codice transazione
STRUST.Passa a cambia modalità.
Fai doppio clic su Client SSL client SSL (Standard).
Fai clic su Certificato > Importa, quindi importa i certificati scaricati dal repository di Google Trust Services.
Fai clic sul pulsante con il segno di spunta verde.
Fai clic su Modifica > Aggiungi all'elenco di certificati. Assicurati che le informazioni del certificato siano visibili nell'area Certificato nel riquadro in basso a destra.
Salva la voce.
Per maggiori informazioni da SAP sull'importazione di certificati in STRUST, consulta la Nota SAP 3238733 - Come importare un certificato in un elenco di certificati di STRUST PSE in un NetWeaver AS ABAP.
Convalida le porte HTTP e HTTPS in Internet Communication Manager (ICM)
Per i sistemi SAP ospitati su Google Cloud, i metadati VM vengono archiviati su un server di metadati, accessibile solo tramite una porta HTTP. Per l'autenticazione è richiesta l'attivazione della porta HTTP. Pertanto, quando il tuo sistema SAP è ospitato su un'istanza VM di Compute Engine, devi assicurarti che sia attiva una porta HTTP per accedere ai metadati della VM e abilitare l'autenticazione. Devi inoltre assicurarti che una porta HTTPS sia attiva per le chiamate API successive.
Se il tuo sistema SAP è ospitato all'esterno di Google Cloud, non è richiesta l'attivazione della porta HTTP.
Per convalidare le porte HTTP e HTTPS, segui questi passaggi:
- Nella GUI di SAP, inserisci il codice transazione
SMICM. - Nella barra dei menu, fai clic su Vai a > Servizi. Un segno di spunta verde nella colonna Actv indica che le porte HTTP e HTTPS sono attive.
Per informazioni sulla configurazione delle porte HTTP e HTTPS, consulta la pagina Impostazioni HTTP(S) in ICM.
Assicurati che il traffico in uscita dalla rete sia in uscita
Il server applicazioni SAP deve connettersi alle API Google Cloud tramite HTTPS.
- Per il tuo sistema host SAP, verifica che le regole firewall e i proxy consentano la connessione HTTPS dai server esterni alle istanze VM di Compute Engine. Per saperne di più, vedi Creare e avviare un'istanza VM.
- Assicurati che l'accesso per raggiungere le API Google Cloud non sia limitato dal punto di vista del networking.
Gestisci autorizzazioni
Per accedere all'SDK ABAP per transazioni specifiche di Google Cloud, devi concedere agli utenti l'accesso all'oggetto SDK autorizzazione. I file di trasporto dell'SDK
includono l'oggetto di autorizzazione dell'SDK ZGOOG_SDK e il gruppo di autorizzazione ZSGC.
Per concedere l'accesso alle transazioni dell'SDK:
- Nella GUI di SAP, inserisci il codice transazione
PFCG. - Definisci un ruolo per l'SDK.
- Per l'oggetto di autorizzazione
ZGOOG_SDK, concedi il ruolo l'accesso all'autorizzazioneActivity 16.
Per limitare l'accesso alle tabelle di configurazione dell'SDK, segui questi passaggi:
- Nella GUI di SAP, inserisci il codice transazione
PFCG. - Definisci un ruolo per limitare l'accesso alle tabelle di configurazione dell'SDK.
- Per limitare l'accesso all'oggetto di autorizzazione
S_TABU_DIS, escludi il gruppo di autorizzazioneZSGC.
Configura la sicurezza di Google Cloud
Se il tuo sistema SAP è ospitato su Google Cloud, configura quanto segue sull'istanza VM di Compute Engine host:
Creare un account di servizio IAM per l'istanza VM host. Per le istruzioni, vedi Creare un account di servizio.
Concedi il ruolo
Service Account Token Creatorall'account di servizio. Per le istruzioni, vedi Concedere un singolo ruolo.Collega l'account di servizio all'istanza VM. Inoltre, imposta l'ambito di accesso della VM su
cloud-platformin modo che le autorizzazioni IAM della VM siano determinate completamente dai ruoli IAM concessi all'account di servizio della VM. Per le istruzioni, consulta Creare una VM e collegare l'account di servizio.Crea un account di servizio IAM dedicato per accedere alle API Google Cloud. Per le istruzioni, vedi Creare un account di servizio.
Concedi all'account di servizio i ruoli IAM richiesti per accedere alla funzionalità API. Per comprendere i requisiti dei ruoli per le API Google Cloud, consulta la documentazione relativa alle singole API e segui il principio del privilegio minimo. Per ulteriori informazioni sui ruoli predefiniti specifici delle API, consulta la documentazione di riferimento sui ruoli IAM di base e predefiniti.
Configura l'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.
Dopo aver completato la configurazione dell'autenticazione, puoi iniziare a utilizzare le guide rapide per creare programmi di esempio.
Configura l'SDK ABAP per Google Cloud
Questa sezione illustra le configurazioni dell'SDK ABAP per Google Cloud.
Specifica l'endpoint Google Cloud
L'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
Per impostazione predefinita, il metodo del costruttore della classe della libreria client API contiene endpoint HTTP per le API Google Cloud supportate. che usa la libreria client quando un metodo viene chiamato per eseguire un'operazione sulle risorse API.
Utilizza destinazioni RFC per gli endpoint
Se devi utilizzare una qualsiasi delle seguenti funzionalità, utilizza le destinazioni RFC per stabilire la connessione a Google Cloud:
- Se utilizzi un server proxy nel tuo panorama SAP e vuoi utilizzarlo per inviare le richieste HTTP a Google Cloud,
- Se vuoi che l'SDK acceda alle API Google Cloud tramite gli endpoint Private Service Connect nella tua rete VPC.
- Se vuoi utilizzare la compressione HTTP.
- Se vuoi accedere all'endpoint di un'API specifico per regione.
I file di trasporto dell'SDK ABAP per Google Cloud contengono le seguenti destinazioni RFC di esempio per gli endpoint dell'API Google Cloud:
| Nome destinazione RFC di esempio | Note |
|---|---|
GOOG_IAMCREDENTIALS |
Questa destinazione RFC ha come target l'API IAM. |
GOOG_OAUTH2_TOKEN |
Questa destinazione RFC ha come target l'endpoint Google Cloud per l'autenticazione basata su token. |
GOOG_PUBSUB_V1 |
Questa destinazione RFC ha come target l'API Pub/Sub. |
GOOG_TRANSLATION_EU_V3 |
Questa destinazione RFC ha come target l'API Cloud Translation v3. |
Per creare una destinazione RFC, segui questi passaggi:
Nella GUI di SAP, inserisci il codice transazione
SM59.Per creare nuove destinazioni RFC, copia le destinazioni RFC di esempio.
Per le destinazioni RFC che hai creato, assicurati che Tipo di connessione sia impostato come segue:
G - HTTP connection to external server.Vai alla scheda Impostazioni tecniche e inserisci i seguenti dettagli:
- Target Host (Host di destinazione): inserisci il nome host dell'API Google Cloud.
Ad esempio, puoi usare
translation.googleapis.com. - Prefisso percorso: inserisci il percorso della risorsa. Ad esempio, puoi usare
/language/translate/. N.servizio: inserisci
443. Questo numero di porta viene utilizzato per le comunicazioni sicure.Per raccogliere i dettagli specifici dell'API Google Cloud necessari per creare una destinazione RFC, vedi Raccogliere dettagli per la creazione di una destinazione RFC.
- Target Host (Host di destinazione): inserisci il nome host dell'API Google Cloud.
Ad esempio, puoi usare
Vai alla scheda Accesso e sicurezza e assicurati che il campo Certificato SSL sia impostato con l'opzione Client SSL CampaignULT (Standard).
(Facoltativo) Puoi configurare le impostazioni del proxy, attivare la compressione HTTP e specificare gli endpoint Private Service Connect.
Salva le modifiche.
Per utilizzare le destinazioni RFC per la connessione alle API Google Cloud, devi configurare le destinazioni RFC nella tabella di mappatura dei servizi che mappa le destinazioni RFC a una chiave client. Per ulteriori informazioni sulla tabella di mappatura dei servizi, consulta la tabella /GOOG/SERVIC_MAP.
Raccogliere i dettagli per creare una destinazione RFC
Per ottenere i dettagli necessari per creare una destinazione RFC, esegui questi passaggi:
-
Nella GUI di SAP, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe fai clic su Riferimento SAP IMG. - Fai clic su ABAP SDK for Google Cloud > Utility > Ottieni impostazioni RFC per i servizi Google Cloud.
- Specifica il nome del servizio Google Cloud.
- Fai clic su Esegui per visualizzare i dettagli.
Configura le impostazioni del proxy
Quando utilizzi destinazioni RFC per connetterti a Google Cloud, puoi instradare la comunicazione dall'SDK tramite il server proxy che stai utilizzando nel tuo panorama SAP.
Se non vuoi utilizzare un server proxy o non ne hai uno nel tuo panorama SAP, puoi saltare questo passaggio.
Per configurare le impostazioni del server proxy, segui questi passaggi:
Nella GUI di SAP, inserisci il codice transazione
SM59.Seleziona la destinazione RFC che ha come target l'API richiesta.
Vai alla scheda Impostazioni tecniche, quindi inserisci i valori per i campi nella sezione Opzioni proxy HTTP.
Devi configurare le impostazioni del server proxy per ogni API a cui prevedi di accedere utilizzando l'SDK.
Attiva la compressione HTTP
Quando usi destinazioni RFC per connetterti a Google Cloud, puoi attivare la compressione HTTP.
Ti consigliamo di abilitare la compressione HTTP se il tuo sistema SAP non è in esecuzione su Google Cloud. Prima di attivare la compressione HTTP nel tuo ambiente di produzione, testa e confronta i vantaggi in base alla configurazione orizzontale, poiché la compressione HTTP potrebbe comportare l'overhead di compressione e decompressione. Per maggiori informazioni da SAP, consulta la nota SAP 1037677 - La compressione HTTP comprime solo determinati documenti.
Se non desideri attivare questa funzione, puoi saltare questo passaggio.
Per attivare la compressione HTTP, procedi nel seguente modo:
Nella GUI di SAP, inserisci il codice transazione
SM59.Seleziona la destinazione RFC che ha come target l'API richiesta.
Vai alla scheda Opzioni speciali.
Nel campo Versione HTTP, seleziona HTTP 1.1.
Per il campo Compressione, seleziona un valore appropriato.
Specifica gli endpoint Private Service Connect
Se vuoi che l'SDK ABAP per Google Cloud utilizzi gli endpoint Private Service Connect per consentire il consumo privato delle API di Google Cloud e IAM, devi creare questi endpoint nel tuo progetto Google Cloud e specificarli nelle rispettive destinazioni RFC.
Se vuoi che l'SDK continui a utilizzare gli endpoint API pubblici predefiniti per connettersi alle API Google Cloud e a IAM, ignora questo passaggio.
Per configurare l'SDK in modo che utilizzi gli endpoint Private Service Connect, esegui questi passaggi:
Nella GUI di SAP, inserisci il codice transazione
SM59.Verifica di aver creato nuove destinazioni RFC per le API Google Cloud e IAM di Google richiesti. Per le istruzioni su come creare queste destinazioni RFC, vedi Creare destinazioni RFC.
Seleziona la destinazione RFC che ha come target un'API Google Cloud specifica, quindi completa i seguenti passaggi:
Vai alla scheda Impostazioni tecniche.
Nel campo Host di destinazione, inserisci il nome dell'endpoint Private Service Connect che hai creato per accedere all'API.
Per il campo N.servizio, assicurati che sia specificato il valore
443.Vai alla scheda Accesso e sicurezza.
Per il campo Certificato SSL, assicurati che sia selezionata l'opzione Client SSL CampaignULT (Standard).
Seleziona la destinazione RFC che ha come target IAM, quindi completa i seguenti passaggi:
Vai alla scheda Impostazioni tecniche.
Nel campo Host di destinazione, inserisci il nome dell'endpoint Private Service Connect che hai creato per accedere a IAM.
Per il campo N.servizio, assicurati che sia specificato il valore
443.Vai alla scheda Accesso e sicurezza.
Per il campo Certificato SSL, assicurati che sia selezionata l'opzione Client SSL CampaignULT (Standard).
Configurare la tabella di mappatura dei servizi per l'API IAM e altre API che prevedi di utilizzare mediante l'SDK ABAP per Google Cloud.
Nella GUI di SAP, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe fai clic su Riferimento SAP IMG.Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura mappa dei servizi.
Fai clic su Nuove voci.
Specifica le destinazioni RFC per l'API IAM e altre API, ad esempio
Cloud Pub/Sub API v1.
| Campo | Descrizione |
|---|---|
| Nome chiave Google Cloud | Specifica il nome della configurazione della chiave client. |
| Nome servizio Google | Specifica il servizio Google Cloud per il quale stai mappando una destinazione RFC. |
| Destinazione RFC | Specifica il nome della destinazione RFC. |
La destinazione RFC specificata nella tabella di mappatura dei servizi viene utilizzata dall'SDK quando viene creata un'istanza di una classe di libreria client e utilizzata dal codice sorgente ABAP per chiamare un'API Google Cloud.
Logging delle applicazioni
Per scrivere i log delle applicazioni, l'SDK ABAP per Google Cloud include un framework di logging incorporato. L'oggetto di log ZGOOG e l'oggetto secondario ZABAP_SDK
vengono forniti con i file di trasporto dell'SDK che puoi utilizzare come oggetti predefiniti
per le configurazioni dei log. Puoi anche aggiungere oggetti di log personalizzati
e oggetti secondari al framework di logging dell'SDK.
Puoi visualizzare i log delle applicazioni SAP standard utilizzando la transazione SLG1.
Per ulteriori informazioni, consulta Logging.
Configura il logging utilizzando l'oggetto log e l'oggetto secondario forniti con l'SDK
Puoi utilizzare l'oggetto di log ZGOOG e l'oggetto secondario ZABAP_SDK forniti con l'SDK come oggetti predefiniti per le configurazioni dei log.
Per configurare il logging, segui questi passaggi:
Nella GUI di SAP, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe fai clic su Riferimento SAP IMG.Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura framework di Logging.
Fai clic su Nuove voci.
Inserisci valori nei seguenti campi:
Campo Descrizione Oggetto Inserisci ZGOOG.Oggetto secondario Inserisci ZABAP_SDK.A 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 su
I, in modo da registrare la maggior parte dei messaggi di log.Fidelizzazione Specifica il numero di giorni di conservazione dei log. Termina alle Specifica la data di fine fino alla quale sarà attiva questa configurazione dei log. La data di fine predefinita è 9999/12/31.È predefinito Per impostare questa configurazione del log come predefinita, seleziona la casella di controllo.
Aggiungi oggetti di log personalizzati
Puoi anche aggiungere oggetti di log e oggetti secondari personalizzati al framework di logging dell'SDK.
Per aggiungere un oggetto log e un oggetto secondario personalizzati, segui questi passaggi:
Nella GUI di SAP, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe fai clic su Riferimento SAP IMG.Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura framework di Logging.
Fai clic su Nuove voci.
Inserisci valori nei seguenti campi:
Campo Descrizione Oggetto Inserisci un nome per l'oggetto log. Oggetto secondario Inserisci un nome per l'oggetto secondario del log. Livello di log Specifica il livello minimo di log. I valori possibili sono:
I: informazioni, avvisi ed erroriW: avvisi ed erroriE: solo errori
Ti consigliamo di impostare il livello di log su
I, in modo da registrare la maggior parte dei messaggi di log.Conservazione Specifica il numero di giorni di conservazione dei log. Ora di fine Data di fine fino alla quale la configurazione dei log sarà attiva. La data di fine predefinita è 9999/12/31.Valore predefinito Specifica se questa è la configurazione predefinita dei log.
Se devi impostare un oggetto di log e un oggetto secondario personalizzati come configurazione di logging predefinita, cancella il campo Is Default (È predefinito) per la voce predefinita corrente, quindi seleziona il campo Is default (È predefinito) per la nuova voce che devi impostare come predefinita.
Puoi mantenere come voce predefinita una sola configurazione di log alla volta.
Puoi utilizzare anche oggetti log personalizzati e oggetti secondari anche senza renderli predefiniti. Per farlo, dopo aver creato oggetti di log e oggetti secondari personalizzati nel framework di logging, devi trasferire gli oggetti e i sottooggetti di log durante la creazione degli stub del client API. Per ulteriori informazioni, consulta Logging.
Se una configurazione del log non è più necessaria, puoi disabilitarla.
Per disattivare una configurazione di log:
Nella GUI di SAP, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe fai clic su Riferimento SAP IMG.Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura framework di Logging.
Imposta il campo Fine alle su una data nel passato.
Tabelle di configurazione delle chiavi nell'SDK ABAP per Google Cloud
Tabella /GOOG/CLIENT_KEY
Per la configurazione relativa all'autenticazione e alla connettività, l'SDK ABAP per Google Cloud utilizza la tabella /GOOG/CLIENT_KEY. Nella tabella /GOOG/CLIENT_KEY, configuri le chiavi client utilizzando i dettagli specifici del tuo metodo di autenticazione. Per ulteriori informazioni sui metodi di autenticazione e sulla relativa configurazione delle chiavi client, consulta Autenticazione.
Per visualizzare la tabella /GOOG/CLIENT_KEY, segui questi passaggi:
Nella GUI di SAP, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe fai clic su Riferimento SAP IMG.Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura chiave client.
La tabella seguente illustra i campi della tabella delle chiavi client:
| Campo | Tipo di dati | Descrizione |
|---|---|---|
| Nome chiave Google Cloud | String | Il nome della configurazione della chiave client. Ad esempio, CLIENT_KEY_API_KEY |
| Nome dell'account di servizio Google Cloud | String | Il nome dell'account di servizio nel formato dell'indirizzo email. |
| Ambito Google Cloud | String | L'ambito di accesso all'API, https://www.googleapis.com/auth/cloud-platform.
Questo ambito di accesso corrisponde all'impostazione Consenti l'accesso completo a tutte le API Cloud sulla VM host.
|
| ID progetto | String | L'ID del progetto Google Cloud che contiene le API di destinazione. |
| Nome comando | String | Nome del comando del sistema operativo. In genere, questo campo viene lasciato vuoto. |
| Classe di autorizzazione | String | La classe di autorizzazione da utilizzare per la comunicazione con Google Cloud. |
| Memorizzazione nella cache dei token | Booleano | Il flag che determina se i token di accesso recuperati da Google Cloud vengono memorizzati o meno nella cache. Ti consigliamo di abilitare la memorizzazione nella cache del token dopo aver completato la configurazione e il test della connessione a Google Cloud. Per ulteriori informazioni sulla memorizzazione nella cache dei token, consulta Attivare la memorizzazione nella cache dei token. |
| Secondi di aggiornamento del token | String | La quantità di tempo, in secondi, prima della scadenza di un token di accesso e deve essere aggiornata.
Se specifichi un valore da 1 a 3599, viene sostituito il tempo di scadenza predefinito di 3500 secondi. Se specifichi 0,
l'SDK utilizza il valore predefinito.
Il valore predefinito è 3500. |
| Parametro di autorizzazione 1 | String | Si tratta di parametri di autorizzazione aggiuntivi che richiedono la configurazione in situazioni specifiche. In genere, questo campo viene lasciato vuoto. |
| Parametro di autorizzazione 2 | String | Si tratta di parametri di autorizzazione aggiuntivi che richiedono la configurazione in situazioni specifiche. In genere, questo campo viene lasciato vuoto. |
Tabella /GOOG/SERVIC_MAP
Per mappare la configurazione del servizio alle destinazioni RFC, l'SDK ABAP per Google Cloud utilizza la tabella /GOOG/SERVIC_MAP.
A seconda dei metodi di autenticazione, questa tabella contiene alcune voci obbligatorie e consigliate.
Per visualizzare la tabella /GOOG/SERVIC_MAP, segui questi passaggi:
Nella GUI di SAP, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe fai clic su Riferimento SAP IMG.Fai clic su ABAP SDK for Google Cloud > Impostazioni di base > Configura Service Mapping.
La tabella seguente illustra i campi della tabella di mappatura dei servizi:
| Campo | Tipo di dati | Descrizione |
|---|---|---|
| Nome | String | Il nome della configurazione della chiave client. |
| Nome servizio Google | String | Il nome del servizio Google Cloud. Per trovare un servizio, usa la guida di ricerca. |
| Destinazione RFC | String | Il nome della destinazione RFC. Per trovare una destinazione RFC pertinente, utilizza la guida di ricerca. |
Guida di Ricerca
Per trovare i valori disponibili per un campo, fai clic sull'icona come mostrato nello screenshot seguente:
Tabella /GOOG/LOG_CONFIG
Per scrivere i log delle applicazioni, l'SDK ABAP per Google Cloud
utilizza la tabella /GOOG/LOG_CONFIG.
Per visualizzare la tabella /GOOG/LOG_CONFIG, svolgi i seguenti passaggi:
Nella GUI di SAP, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe fai clic su Riferimento SAP IMG.Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura framework di Logging.
La tabella seguente illustra i campi della tabella di configurazione del logging:
| Campo | Descrizione |
|---|---|
| Oggetto | Il nome dell'oggetto log. |
| Oggetto secondario | Il nome dell'oggetto secondario di log. |
| Livello di log | Mostra il livello minimo di log. I valori possibili sono:
|
| Conservazione | Numero di giorni di conservazione dei log. Dopo il periodo di conservazione, puoi valutare i log per l'eliminazione utilizzando la transazione |
| Ora di fine | Data di fine fino alla quale la configurazione dei log sarà attiva.
La data di fine predefinita è 9999/12/31.
|
| Valore predefinito | Indica se si tratta della configurazione predefinita dei log. |
| Autore modifica | Nome utente che ha modificato la configurazione del log. |
| Modificate il giorno | Data di modifica della configurazione del log. |
| Ora di modifica | L'ora in cui è stata modificata la configurazione del log. |
Memorizzazione nella cache dei token
Se l'SDK viene utilizzato in un caso d'uso con volumi elevati di chiamate in cui vengono eseguite più chiamate al metodo API in un breve periodo di tempo, abilita la memorizzazione nella cache per il token di accesso o la chiave API ottenuta dalla configurazione della chiave client per accedere alle API Google Cloud.
L'abilitazione della memorizzazione nella cache dei token assicura che un token di accesso o una chiave API vengano riutilizzati fino alla scadenza o alla revoca, il che a sua volta riduce il numero di chiamate HTTP effettuate per recuperare nuovi token di accesso o chiavi API.
Per abilitare la memorizzazione nella cache dei token, seleziona il flag Memorizzazione nella cache dei token nella tabella delle chiavi client.
Quando attivi la memorizzazione nella cache, il token di accesso viene memorizzato nella cache nella memoria condivisa dell'applicazione server per la durata impostata per il campo Secondi di aggiornamento dei token nella tabella delle chiavi client.
Se l'opzione Secondi di aggiornamento del token non viene specificato o viene impostato su 0, il token di accesso viene memorizzato nella cache per il valore specificato nel parametro CMD_SECS_DEFLT nelle impostazioni avanzate.
Cancella il token di accesso memorizzato nella cache
Quando la memorizzazione nella cache dei token è abilitata e aggiorni i ruoli assegnati all'account di servizio che l'SDK ABAP per Google Cloud utilizza per accedere alle API pertinenti, il nuovo token di accesso corrispondente ai ruoli aggiornati viene recuperato solo dopo la scadenza del token memorizzato nella cache esistente. In questi casi, puoi cancellare il token di accesso manualmente.
Per cancellare il token di accesso memorizzato nella cache:
Nella GUI di SAP, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe fai clic su Riferimento SAP IMG.Fai clic su SDK ABAP per Google Cloud > Utility > Svuota cache.
Seleziona un'opzione appropriata:
- Svuota l'area di memoria condivisa: per svuotare l'intera cache.
- Cancella istanza dalla memoria: per cancellare il token di accesso memorizzato nella cache per una determinata istanza. Con questa opzione devi specificare anche un nome istanza.
Crea il report.
Trova i ruoli IAM per le API Google Cloud
Per implementare il principio del privilegio minimo, è essenziale conoscere i ruoli IAM appropriati per le API Google Cloud che prevedi di utilizzare nel tuo programma ABAP. Se concedi solo i ruoli necessari, puoi limitare l'accesso per un account di servizio. L'utilità di ricerca ruoli, integrata nell'SDK, consente di identificare facilmente i ruoli IAM associati alle varie API di Google Cloud.
Per trovare i ruoli IAM, segui questi passaggi:
Nella GUI di SAP, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe fai clic su Riferimento SAP IMG.Fai clic su ABAP SDK for Google Cloud > Utilità > Ruoli pertinenti per l'API di recupero.
In alternativa, puoi accedere all'utilità Ricerca ruoli eseguendo il codice transazione
/GOOG/ROLE_FINDER.Nel campo Chiave client, inserisci un nome di chiave client valido configurato nella tabella
/GOOG/CLIENT_KEY.Nel campo Nome servizio Google, specifica l'API Google Cloud per cui devi verificare i ruoli IAM.
Facoltativamente, per visualizzare le autorizzazioni IAM associate all'interno del ruolo IAM, seleziona il campo Dettagli completi.
Fai clic su Execute (Esegui). Vengono visualizzati i ruoli IAM.
Impostazioni avanzate
Facoltativamente, puoi modificare i parametri delle impostazioni avanzate per l'SDK nella tabella /GOOG/SDK_PARAM. Questi valori parametro vengono applicati a livello di
sistema e sono comuni a tutti i componenti dell'SDK.
L'SDK applica internamente i valori predefiniti per questi parametri. Utilizza le impostazioni avanzate solo se vuoi sostituire i valori predefiniti.
Ti consigliamo di modificare i parametri delle impostazioni avanzate solo dopo un'analisi completa e l'impatto di nuovi valori sulle prestazioni dell'SDK. È tua responsabilità garantire che le nuove impostazioni avanzate non causino guasti e problemi di prestazioni.
Per modificare i parametri delle impostazioni avanzate:
Nella GUI di SAP, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe fai clic su Riferimento SAP IMG.Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura parametri.
Fai clic su Nuove voci.
Nella riga visualizzata, specifica le seguenti impostazioni:
- Nel campo Nome parametro, inserisci il nome del parametro. La descrizione del parametro viene compilata automaticamente.
- Nel campo Valore parametro, inserisci un valore.
Per informazioni sui parametri delle impostazioni avanzate, consulta Parametri delle impostazioni avanzate.
Salva la nuova voce.
Parametri delle impostazioni avanzate
La tabella seguente mostra i parametri delle impostazioni avanzate per l'SDK ABAP per Google Cloud.
| Nome parametro | Descrizione | Valore predefinito | Valore valido |
|---|---|---|---|
CMD_SECS_DEFLT |
Se hai abilitato la memorizzazione nella cache del token, si tratta della durata in secondi dopo la quale scade il token memorizzato nella cache. | 3500 | Il valore deve essere compreso tra 1 e 3599. |
Aggiorna l'SDK ABAP per Google Cloud
Google Cloud offre le nuove release dell'SDK ABAP per Google Cloud durante il trasporto SAP.
Gli amministratori SAP possono aggiornare l'SDK ABAP per Google Cloud seguendo questi passaggi:
- Arresta i job in background che utilizzano qualsiasi stub del client API esistente dell'SDK ABAP per Google Cloud.
- Importare la nuova richiesta di trasporto SAP. Per ulteriori informazioni sui passaggi, consulta Installare l'SDK ABAP per Google Cloud.
- Dopo aver convalidato l'importazione riuscita e l'attivazione degli oggetti, riprendi i job in background.
Metriche di utilizzo
L'SDK ABAP SDK per Google Cloud, on-premise o in qualsiasi versione cloud, raccoglie le metriche di utilizzo e le invia a Google per finalità 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'SDK ABAP on-premise o qualsiasi edizione cloud dell'SDK ABAP per Google Cloud.
- Release SAP_ABA: versione del componente software SAP_ABA.
Licenze
L'SDK ABAP per Google Cloud, on-premise o in qualsiasi edizione cloud, viene 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 alla generale dei termini riportati sopra, non è consentito 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. Procurati separatamente una licenza appropriata per il software SAP.
Supporto dei linguaggi
L'SDK ABAP per Google Cloud supporta solo l'inglese (EN).
Il valore predefinito dell'SDK è l'inglese (EN) per le seguenti lingue di accesso SAP:
cinese (CH), francese (FR), tedesco (DE), giapponese (JA), portoghese (PT)
e russo (RU).
Tutti i messaggi di errore che potresti visualizzare quando lavori con l'SDK vengono generati in inglese indipendentemente dalla lingua attuale del sistema.
Ciclo di vita del supporto
Google Cloud supporta e gestisce l'attuale versione principale 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.