HTTP-REST-API

Integrationsversion: 10.0

HTTP REST API-Integration in Google Security Operations konfigurieren

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

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Auf ausstehende Aktionen im Workdesk reagieren und Manuelle Aktion in einem Fall ausführen.

Daten abrufen

Beschreibung

Senden Sie eine HTTP-Anfrage und rufen Sie eine Antwort ab.

Parameter

Parameter	Typ	Standardwert	Ist obligatorisch	Beschreibung
URL	String	–	Ja	Die URL, an die die Anfrage gesendet werden soll.
Nutzername	String	–	Nein	–
Passwort	String	–	Nein	–
SSL-Überprüfung	Kästchen	Deaktiviert	Nein	Gibt an, ob das SSL-Zertifikat des Zielservers überprüft werden soll.
Header-JSON	String	–	Nein	Ein JSON-Objekt der HTTP-Header, die mit der Anfrage gesendet werden sollen.
HTTP-Fehlercodes ignorieren	Kästchen	Deaktiviert	Nein	Wenn diese Option aktiviert ist, sollte die Aktion HTTP-Fehlercodes vom Typ 4xx oder 5xx ignorieren und keinen Fehler zurückgeben.

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für die URL-Entität ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Skriptergebnisses	Wertoptionen	Beispiel
response_data	–	–

JSON-Ergebnis

{
  "redirects": [
    "http://blank.org/"
  ],
  "response_code": 200,
  "data": "<html>\n\n<head>\n<title>\nblank\n</title>\n</head>\n\n<body bgcolor=#ffffff text=#2222ff link=#ff0000 vlink=#880000 alink=#00ff00>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<center>\n<a style=\"text-decoration:none\" href=\"blank.html\">.</a>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n</center>\n</body>\n</html>\n"
}

URL-Daten abrufen

Beschreibung

HTTP-GET-Anfragen an URL-Entitäten senden.

Parameter

Parameter	Typ	Standardwert	Ist obligatorisch	Beschreibung
Nutzername	String	–	Nein	Nutzername für die Basisauthentifizierung. Optional.
Passwort	String	–	Nein	Passwort für die Basisauthentifizierung. Optional.
SSL-Überprüfung	Kästchen	–	Nein	Gibt an, ob das SSL-Zertifikat des Zielservers überprüft werden soll.

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für die URL-Entität ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Skriptergebnisses	Wertoptionen	Beispiel
is_success	Wahr/falsch	is_success:False

JSON-Ergebnis

[
    {
        "EntityResult": {
            "redirects": ["http://blank.org/"],
            "data": "<html>\\n\\n<head>\\n<title>\\nblank\\n</title>\\n</head>\\n\\n<body bgcolor=#ffffff text=#2222ff link=#ff0000 vlink=#880000 alink=#00ff00>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<center>\\n<a style=\\\"text-decoration:none\\\" href=\\\"blank.html\\\">.</a>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n</center>\\n</body>\\n</html>\\n"
        },
        "Entity": "http://blank.org/"
    }
]

Ping

Beschreibung

Verbindung testen

Parameter

–

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für alle Entitäten ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Skriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

N/A

Post-Daten

Beschreibung

HTTP- und POST-Anfragen senden

Parameter

Parameter	Typ	Standardwert	Beschreibung
URL	String	–	Ja	Die URL, an die die Anfrage gesendet werden soll.
Daten	String	–	Ja	Die Daten, die mit der Anfrage gesendet werden sollen.
Nutzername	String	–	Nein	–
Passwort	String	–	Nein	–
SSL-Überprüfung	Kästchen	–	Deaktiviert	Gibt an, ob das SSL-Zertifikat des Zielservers überprüft werden soll.
Header-JSON	String	–	Nein	Ein JSON-Objekt der HTTP-Header, die mit der Anfrage gesendet werden sollen.
Inhaltstyp	String	–	Nein	Inhaltstyp. Wenn „application“ oder „JSON“ festgelegt ist, müssen die Eingabedaten ein JSON-String sein.

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für alle Entitäten ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Skriptergebnisses	Wertoptionen	Beispiel
response_data	–	–

JSON-Ergebnis

{
  "redirects": [
    "http://blank.org/"
  ],
  "data": "<html>\n\n<head>\n<title>\nblank\n</title>\n</head>\n\n<body bgcolor=#ffffff text=#2222ff link=#ff0000 vlink=#880000 alink=#00ff00>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<center>\n<a style=\"text-decoration:none\" href=\"blank.html\">.</a>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n</center>\n</body>\n</html>\n"
}

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