Google Übersetzer in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie Google Translate konfigurieren und in Google Security Operations (Google SecOps) einbinden.

Integrationsversion: 4.0

Hinweise

Wenn Sie die Integration nutzen möchten, müssen Sie einen API-Schlüssel erstellen und konfigurieren.

API-Schlüssel erstellen

Führen Sie die folgenden Schritte aus, um den API-Schlüssel zu erstellen:

1. Rufen Sie in der Google Cloud Console die Seite APIs & Dienste > Anmeldedaten auf.

   Zu den Anmeldedaten

2. Klicken Sie auf Hinzufügen Anmeldedaten erstellen.

3. Wählen Sie API-Schlüssel aus, um einen neuen API-Schlüssel zu generieren. Ein Dialogfeld mit einem generierten API-Schlüssel wird angezeigt.

4. Klicken Sie auf  Kopieren, um den API-Schlüssel zu kopieren.

Einschränkungen für API-Schlüssel konfigurieren

So konfigurieren Sie die API-Einschränkung für den API-Schlüssel:

1. Klicken Sie auf Schlüssel einschränken.

2. Wählen Sie unter API-Einschränkungen die Option Schlüssel einschränken aus.

3. Wählen Sie in der API-Liste die Cloud Translation API aus.

4. Konfigurieren Sie die entsprechenden Einschränkungen.

5. Klicken Sie auf Speichern, um die API-Schlüsselkonfiguration zu speichern.

Integrationsparameter

Für die Google Übersetzer-Integration sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
API Root	Erforderlich. Der API-Stamm der Google Übersetzer-Instanz. Der Standardwert ist https://translation.googleapis.com. Weitere Informationen zur Cloud Translation API finden Sie unter Cloud Translation API.
API Key	Erforderlich. Der API-Schlüssel des Google Translate-Kontos.
Verify SSL	Erforderlich. Wenn diese Option ausgewählt ist, wird das SSL-Zertifikat bei der Verbindung zum Google Translate-Server validiert. Standardmäßig ausgewählt.

Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Bei Bedarf können Sie später Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Ausstehende Aktionen über „Mein Arbeitsbereich“ bearbeiten und Manuelle Aktion ausführen.

Sprachen auflisten

Verwenden Sie die Aktion List Languages, um die verfügbaren Sprachen in Google Übersetzer aufzulisten.

Diese Aktion wird nicht für Google SecOps-Elemente ausgeführt.

Aktionseingaben

Für die Aktion List Languages sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Filter Key	Optional. Ein Schlüssel zum Filtern von Sprachen. Folgende Werte sind möglich: Select One Name Der Standardwert ist Select One.
Filter Logic	Optional. Eine Filterlogik, die angewendet werden soll. Die Filterlogik verwendet den Wert, den Sie im Parameter Filter Key festlegen. Folgende Werte sind möglich: Not Specified Equal Contains Der Standardwert ist Not Specified.
Filter Value	Optional. Ein Wert, der im Filter verwendet werden soll. Die Filterlogik verwendet den Wert, den Sie im Parameter Filter Key festlegen. Wenn Equal ausgewählt ist, wird in den Ergebnissen nach der genauen Übereinstimmung gesucht. Wenn Contains ausgewählt ist, wird bei der Aktion nach Ergebnissen gesucht, die den angegebenen Teilstring enthalten. Wenn Sie keinen Wert auswählen, wird der Filter bei der Aktion ignoriert. Die Filterlogik basiert auf dem Wert, der im Parameter Filter Key angegeben ist.
Max Records To Return	Optional. Die maximale Anzahl der zurückzugebenden Datensätze. Der Höchstwert ist 50. Wenn Sie keinen Wert festlegen, werden standardmäßig 50 Datensätze zurückgegeben.

Aktionsausgaben

Die Aktion List Languages (Sprachen auflisten) gibt Folgendes aus:

Ausgabetyp der Aktion	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall‑Repository	Nicht verfügbar
Tabelle „Fall-Repository“	Verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabemeldungen	Verfügbar
Scriptergebnis	Verfügbar

Tabelle „Fall-Repository“

Mit der Aktion List Languages kann die folgende Tabelle generiert werden:

Tabellenname: Verfügbare Sprachen

Tabellenspalte: Sprachschlüssel

JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion List Languages (Sprachen auflisten) empfangen wird:

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

        ]
    }
}

Ausgabemeldungen

Die Aktion List Languages (Sprachen auflisten) kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung	Nachrichtenbeschreibung
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.	Die Aktion wurde ausgeführt.
Error executing action "List Languages". Reason: ERROR_REASON	Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion List Languages aufgeführt:

Name des Scriptergebnisses	Wert
is_success	True oder False

Ping

Verwenden Sie die Aktion Ping, um die Verbindung zu Google Translate zu testen.

Diese Aktion wird nicht für Google SecOps-Elemente ausgeführt.

Aktionseingaben

Keine.

Aktionsausgaben

Die Aktion Ping bietet die folgenden Ausgaben:

Ausgabetyp der Aktion	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall‑Repository	Nicht verfügbar
Tabelle „Fall-Repository“	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Nicht verfügbar
Ausgabemeldungen	Verfügbar
Scriptergebnis	Verfügbar

Ausgabemeldungen

Die Aktion Ping kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung	Nachrichtenbeschreibung
Successfully connected to the Google Translate server with the provided connection parameters!	Die Aktion wurde ausgeführt.
Failed to connect to the Google Translate server! Error is ERROR_REASON	Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Ping aufgeführt:

Name des Scriptergebnisses	Wert
is_success	True oder False

Text übersetzen

Mit der Aktion Text übersetzen können Sie Text mit Google Übersetzer übersetzen lassen.

Diese Aktion wird nicht für Google SecOps-Elemente ausgeführt.

Aktionseingaben

Für die Aktion Text übersetzen sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Source Language	Optional. Die Ausgangssprache des Texts. Wenn Sie diesen Parameter nicht konfigurieren, wird die Sprache automatisch erkannt.
Target Language	Erforderlich. Eine Zielsprache. Der Standardwert ist en.
Text	Erforderlich. Ein zu übersetzender Text.

Aktionsausgaben

Die Aktion Text übersetzen bietet die folgenden Ausgaben:

Ausgabetyp der Aktion	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall‑Repository	Nicht verfügbar
Tabelle „Fall-Repository“	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabemeldungen	Verfügbar
Scriptergebnis	Verfügbar

JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Text übersetzen empfangen wird:

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

Ausgabemeldungen

Die Aktion Text übersetzen kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung	Nachrichtenbeschreibung
Successfully translated the provided text in Google Translate.	Die Aktion wurde ausgeführt.
Error executing action "Translate Text". Reason: ERROR_REASON	Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Text übersetzen verwendet wird:

Name des Scriptergebnisses	Wert
is_success	True oder False

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten