Integrare Google Traduttore con Google SecOps

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

Versione integrazione: 4.0

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 ad API e servizi > Credenziali.

   Vai a credenziali

2. Fai clic su Aggiungi 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.

Configurare le limitazioni relative alle chiavi API

Per configurare la limitazione dell'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 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 Translate. 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 Translate.
Verify SSL	Obbligatorio. Se selezionata, l'integrazione convalida il certificato SSL quando si connette al server di Google Traduttore. Questa opzione è selezionata per impostazione predefinita.

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

Se necessario, potrai 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 Supportare più istanze.

Azioni

Per ulteriori informazioni sulle azioni, vedi Rispondere alle azioni in attesa dalla tua scrivania e Eseguire un'azione manuale.

Elenco 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 i seguenti: Select One Name Il valore predefinito è Select One.
Filter Logic	Facoltativo. Una logica di filtro da applicare. La logica di filtraggio 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 filtraggio utilizza il valore impostato nel parametro Filter Key. Se è selezionato Equal, l'azione cerca la corrispondenza esatta tra i risultati. Se è selezionata l'opzione Contains, l'azione cerca risultati che contengano la sottostringa specificata. Se non selezioni un valore, l'azione ignora il filtro. La logica di filtraggio 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 dell'azione

L'azione Elenca lingue fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	Non disponibile
Link alla bacheca richieste	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: Available Languages

Colonna della tabella: Chiave lingua

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando si utilizza 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 è riuscita.
Error executing action "List Languages". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore dell'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 dell'azione

L'azione Ping fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	Non disponibile
Link alla bacheca richieste	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 è riuscita.
Failed to connect to the Google Translate server! Error is ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

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

Nome del risultato dello script	Valore
is_success	True o False

Traduzione di 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 dell'azione

L'azione Traduci testo fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	Non disponibile
Link alla bacheca richieste	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 si utilizza 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 è riuscita.
Error executing action "Translate Text". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La seguente tabella elenca il valore dell'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.