Integra Google Traduttore con Google SecOps

Questo documento spiega come configurare e integrare Google Traduttore con Google Security Operations (Google SecOps).

Prima di iniziare

Per utilizzare l'integrazione, devi creare e configurare una chiave API.

Crea la chiave API

Per creare la chiave API, completa i seguenti passaggi:

1. Nella console Google Cloud , vai a API e servizi > Credenziali.

   Vai a credenziali

2. Fai clic su add Crea credenziali.

3. Seleziona Chiave API per generare una nuova chiave API. Viene visualizzata una finestra di dialogo con una chiave API generata.

4. Per copiare la chiave API, fai clic su Copia.

Configura le limitazioni relative alle chiavi API

Per configurare la restrizione delle API per la chiave API, completa i seguenti passaggi:

1. Fai clic su Limita chiave.

2. In Restrizioni delle API, seleziona Limita chiave.

3. Seleziona l'API Cloud Translation dall'elenco delle API.

4. Configura le limitazioni applicabili.

5. Fai clic su Salva per salvare la configurazione della chiave API.

Parametri di integrazione

L'integrazione di Google Traduttore richiede i seguenti parametri:

Parametro	Descrizione
API Root	Obbligatorio. La radice dell'API dell'istanza di Google Traduttore. Il valore predefinito è https://translation.googleapis.com. Per saperne di più sull'API Cloud Translation, consulta API Cloud Translation.
API Key	Obbligatorio. La chiave API dell'account Google Traduttore.
Verify SSL	Obbligatorio. Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server di Google Traduttore. Questo tipo di annuncio sarà selezionato per impostazione predefinita.

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configura le integrazioni.

Se necessario, puoi apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supporto di più istanze.

Azioni

Per saperne di più sulle azioni, consulta Rispondi alle azioni in attesa dalla scrivania di lavoro ed Esegui un'azione manuale nel tuo caso.

Elenca le lingue

Utilizza l'azione Elenca lingue per elencare le lingue disponibili in Google Traduttore.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Elenca lingue richiede i seguenti parametri:

Parametro	Descrizione
Filter Key	Facoltativo. Un tasto per filtrare le lingue. I valori possibili sono: Select One Name Il valore predefinito è Select One.
Filter Logic	Facoltativo. Una logica di filtro da applicare. La logica di filtro utilizza il valore impostato nel parametro Filter Key. I valori possibili sono: Not Specified Equal Contains Il valore predefinito è Not Specified.
Filter Value	Facoltativo. Un valore da utilizzare nel filtro. La logica di filtro utilizza il valore impostato nel parametro Filter Key. Se è selezionato Equal, l'azione cerca la corrispondenza esatta tra i risultati. Se è selezionato Contains, l'azione cerca i risultati che contengono la sottostringa specificata. Se non selezioni un valore, l'azione ignora il filtro. La logica di filtro funziona in base al valore fornito nel parametro Filter Key.
Max Records To Return	Facoltativo. Il numero massimo di record da restituire. Il valore massimo è 50. Se non imposti un valore, l'azione restituisce 50 record per impostazione predefinita.

Output azione

L'azione Elenca lingue fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Tabella della bacheca casi

L'azione Elenca lingue può generare la seguente tabella:

Nome tabella: Lingue disponibili

Colonna della tabella: Language Key

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca lingue:

{
    "data": {
        "languages": [
            {
                "language": "af"
            },
            {
                "language": "am"
            },
            {
                "language": "ar"
            }

        ]
    }
}

Messaggi di output

L'azione Elenca lingue può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully found language for the provided criteria in Google Translate. No languages were found for the provided criteria in Google Translate. The filter was not applied, because parameter "Filter Value" has an empty value.	L'azione è andata a buon fine.
Error executing action "List Languages". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca lingue:

Nome del risultato dello script	Valore
is_success	True o False

Dindin

Utilizza l'azione Ping per testare la connettività a Google Traduttore.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

Nessuno.

Output azione

L'azione Ping fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Non disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Messaggi di output

L'azione Ping può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully connected to the Google Translate server with the provided connection parameters!	L'azione è andata a buon fine.
Failed to connect to the Google Translate server! Error is ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Ping:

Nome del risultato dello script	Valore
is_success	True o False

Traduci testo

Utilizza l'azione Traduci testo per tradurre il testo con Google Traduttore.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Traduci testo richiede i seguenti parametri:

Parametro	Descrizione
Source Language	Facoltativo. Una lingua di origine del testo. Se non configuri questo parametro, l'azione rileva automaticamente la lingua.
Target Language	Obbligatorio. Una lingua di destinazione. Il valore predefinito è en.
Text	Obbligatorio. Un testo da tradurre.

Output azione

L'azione Traduci testo fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Traduci testo:

{
    "data": {
        "translations": [
            {
                "translatedText": "TRANSLATED_TEXT"
            }
        ]
    }
}

Messaggi di output

L'azione Traduci testo può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully translated the provided text in Google Translate.	L'azione è andata a buon fine.
Error executing action "Translate Text". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Traduci testo:

Nome del risultato dello script	Valore
is_success	True o False

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.