Google Übersetzer in Google SecOps einbinden

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

Hinweis

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

API-Schlüssel erstellen

So erstellen Sie den API-Schlüssel:

  1. Rufen Sie in der Google Cloud Console APIs und Dienste > Anmeldedaten auf.

    Zu den Anmeldedaten

  2. Klicken Sie auf add 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

Pflichtangabe.

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

Pflichtangabe.

Der API-Schlüssel des Google Übersetzer-Kontos.
Verify SSL

Pflichtangabe.

Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum Google Übersetzer-Server hergestellt wird.

Standardmäßig ausgewählt.

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

Sie können später bei Bedarf Ä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 Auf ausstehende Aktionen im Workdesk reagieren und Manuelle Aktion in einem Fall ausführen.

Sprachen auflisten

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

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Sprachen auflisten 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 anzuwendende Filterlogik.

Die Filterlogik verwendet den Wert, den Sie im Parameter Filter Key festgelegt haben.

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 festgelegt haben.

Wenn Equal ausgewählt ist, sucht die Aktion nach der genauen Übereinstimmung in den Ergebnissen. Wenn Contains ausgewählt ist, sucht die Aktion nach Ergebnissen, die den angegebenen Teilstring enthalten.

Wenn Sie keinen Wert auswählen, wird der Filter von 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, gibt die Aktion standardmäßig 50 Einträge zurück.

Aktionsausgaben

Die Aktion Sprachen auflisten liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Tabelle mit Fall-Repository

Mit der Aktion Sprachen auflisten kann die folgende Tabelle generiert werden:

Tabellenname: Available Languages

Tabellenspalte: Language Key

JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Sprachen auflisten zurückgegeben wird:

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

        ]
    }
}
Ausgabenachrichten

Die Aktion Sprachen auflisten kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

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 war erfolgreich.
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 Sprachen auflisten aufgeführt:

Name des Skriptergebnisses Wert
is_success True oder False

Ping

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

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Keine.

Aktionsausgaben

Die Aktion Ping liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Ausgabenachrichten

Die Aktion Ping kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully connected to the Google Translate server with the provided connection parameters!

 Die Aktion war erfolgreich.
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 aufgeführt, wenn die Aktion Ping verwendet wird:

Name des Skriptergebnisses Wert
is_success True oder False

Text übersetzen

Verwenden Sie die Aktion Text übersetzen, um Text mit Google Übersetzer zu übersetzen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

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

Parameter Beschreibung
Source Language

Optional.

Eine Ausgangssprache des Textes.

Wenn Sie diesen Parameter nicht konfigurieren, erkennt die Aktion die Sprache automatisch.
Target Language

Pflichtangabe.

Eine Zielsprache.

Der Standardwert ist en.
Text

Pflichtangabe.

Ein zu übersetzender Text.

Aktionsausgaben

Die Aktion Text übersetzen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten 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"
            }
        ]
    }
}
Ausgabenachrichten

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

Ausgabemeldung Beschreibung der Nachricht

Successfully translated the provided text in Google Translate.

 Die Aktion war erfolgreich.
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 sind die Werte für die Skriptausgabe aufgeführt, wenn die Aktion Text übersetzen verwendet wird:

Name des Skriptergebnisses Wert
is_success True oder False

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