Stellar Cyber Starlight

In diesem Dokument finden Sie eine Anleitung zum Einbinden von Stellar Cyber Starlight in Google SecOps.

Anwendungsfälle für Produkte

  1. Stellar Cyber Starlight-Sicherheitsereignisse aufnehmen, um damit Google Security Operations-Benachrichtigungen zu erstellen. Als Nächstes können in Google SecOps Benachrichtigungen verwendet werden, um Orchestrierungen mit Playbooks oder manuellen Analysen durchzuführen.
  2. Suchen in Stellar Cyber Starlight ausführen

Produktberechtigung

Basisauthentifizierung (Nutzername:api_key)

Stellar Cyber Starlight-Integration in Google SecOps konfigurieren

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

Integrationsparameter

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Instanzname String – Nein Name der Instanz, für die Sie die Integration konfigurieren möchten.
Beschreibung String – Nein Beschreibung der Instanz.
API-Stamm String https://{ip address}/connect/api/ Ja API-Stamm der Stellar Cyber Starlight-Instanz.
Nutzername String – Ja Nutzername des Stellar Cyber Starlight-Kontos.
API-Schlüssel Passwort – Nein

API-Schlüssel des Stellar Cyber Starlight-Kontos. Dieser Parameter wurde für die Basisauthentifizierung verwendet.

Wenn sowohl API Key als auch API Token angegeben sind, hat API Token Priorität.

API-Token Passwort – Nein

API-Token des Stellar Cyber Starlight-Kontos. Dieser Parameter wird für die JWT-Authentifizierung verwendet.

Wenn sowohl API Key als auch API Token angegeben sind, hat API Token Priorität.

SSL überprüfen Kästchen Deaktiviert Nein Wenn diese Option aktiviert ist, prüfen Sie, ob das SSL-Zertifikat für die Verbindung zum Stellar Cyber Starlight-Server gültig ist.
Remote ausführen Kästchen Deaktiviert Nein Klicken Sie das Feld an, um die konfigurierte Integration remote auszuführen. Nachdem Sie das Häkchen gesetzt haben, wird die Option zum Auswählen des Remote-Nutzers (Agenten) angezeigt.

Aktionen

Ping

Beschreibung

Testen Sie die Verbindung zu Stellar Cyber Starlight mit den Parametern, die auf der Seite „Integrationskonfiguration“ im Google SecOps Content Hub angegeben sind.

Parameter

–

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ (Entität / Allgemein)
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn der Vorgang erfolgreich war:

Geben Sie „Successfully connected to the Stellar Cyber Starlight server with the provided connection parameters!“ aus.

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn die Zahlung nicht erfolgreich ist:

Print "Failed to connect to the Stellar Cyber Starlight server! Error is {0}".format(exception.stacktrace)

Wenn 401 für API-Token:

Geben Sie „Failed to connect to the Stellar Cyber Starlight server. Ungültiges API-Token oder ungültiger Nutzername angegeben. Bitte überprüfen Sie die Anmeldedaten.“

Wenn 401 für API-Schlüssel:

Geben Sie „Failed to connect to the Stellar Cyber Starlight server. Der angegebene API-Schlüssel oder Nutzername ist ungültig. Bitte überprüfen Sie die Anmeldedaten.“

Allgemein

Beschreibung

Einfache Suche in Stellar Cyber Starlight ausführen

Bekannte Indexe

Name Index
Assets aella-assets-*
AWS-Ereignisse aella-cloudtrail-*
Linux-Ereignisse aella-audit-*
ML-IDS-/Malware-Erkennungsereignisse aella-maltrace-*
Monitoring aella-ade-*
Scans aella-scan-*
Sicherheitsereignisse aella-ser-*
SNMP aella-perf-*
Syslog aella-syslog-*
Traffic aella-adr-*
Nutzer aella-users-*
Windows-Ereignisse aella-wineventlog-*

Parameter

Anzeigename des Parameters Typ Standardwert Ist Obligatorisch Beschreibung
Index String – Ja Geben Sie an, in welchem Index Sie suchen möchten. Eine Liste der bekannten Indexe finden Sie in der Dokumentation.
Abfrage String – Ja Geben Sie einen Abfragefilter für die Suche an.
Maximale Anzahl zurückzugebender Ergebnisse Ganzzahl 50 Nein Geben Sie an, wie viele Ergebnisse in der Antwort zurückgegeben werden sollen.
Sortierfeld String – Nein Geben Sie das Feld an, das für die Sortierung verwendet werden soll.
Sortierreihenfolge DDL

Absteigend

Mögliche Werte:
Aufsteigend

Absteigend

Nein Geben Sie die Sortierreihenfolge für das Ergebnis an.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
{
                "_index": "aella-ser-1594316167944-",
                "_type": "amsg",
                "_id": "LzfKNHMByqrLS2zLF9bf",
                "_score": null,
                "_source": {
                    "actual": 1,
                    "advanced": 2,
                    "aella_tuples": "172.30.202.208.52.8.234.27.80.67",
                    "anomaly_id": "job024_anomalous_user_agent-2020.07.09",
                    "appid": 67,
                    "appid_family": "Web",
                    "appid_name": "http",
                    "appid_stdport": "yes",
                    "days_silent": 14,
                    "detected_field": "metadata.request.user_agent",
                    "detected_value": "curl/7.47.0",
                    "detector_index": 0,
                    "doc_ids": [],
                    "dscp_name": "Best Effort",
                    "dstip": "52.8.234.27",
                    "dstip_geo": {
                        "city": "San Jose",
                        "countryCode": "US",
                        "countryName": "United States",
                        "latitude": 37.3388,
                        "longitude": -121.8914,
                        "region": "California"
                    },
                    "dstip_geo_point": "37.3388,-121.8914",
                    "dstip_host": "dl.stellarcyber.ai",
                    "dstip_reputation": "Good",
                    "dstip_type": "public",
                    "dstmac": "e8:1c:ba:4c:37:be",
                    "dstport": 80,
                    "duration": 605,
                    "end_reason": 4,
                    "end_time": 1594318194011,
                    "engid": "ad42005056a204db",
                    "engid_gateway": "",
                    "engid_name": "siemplify-sensor",
                    "event_category": "network",
                    "event_name": "user_agent_anomaly",
                    "event_score": 54,
                    "event_source": "rare_ml",
                    "event_status": "New",
                    "event_type": "conn",
                    "fidelity": 99,
                    "flow_score": 100,
                    "inbytes_delta": 2323,
                    "inbytes_total": 2323,
                    "inpkts_delta": 5,
                    "locid": "unassigned location",
                    "metadata": {
                        "request": {
                            "host": "dl.stellarcyber.ai",
                            "index": 1,
                            "method": "GET",
                            "server": "dl.stellarcyber.ai",
                            "uri": "/ubuntu/apt.gpg.key",
                            "user_agent": "curl/7.47.0"
                        },
                        "response": {
                            "code": 200,
                            "file_type": "data",
                            "index": 1,
                            "mime_type": "application/octet-stream",
                            "processing_time": 0,
                            "response_time": 199
                        }
                    },
                    "metadata.request.user_agent": "\"curl/7.47.0\"",
                    "msg_class": "interflow_traffic",
                    "msg_origin": {
                        "source": "network_sensor"
                    },
                    "msgtype": 4,
                    "msgtype_name": "startend",
                    "netid": 0,
                    "netid_name": "vlan0",
                    "obsid": 2887699152,
                    "orig_id": "4TfENHMByqrLS2zLZtWQ",
                    "orig_index": "aella-adr-1594315890054-",
                    "outbytes_delta": 570,
                    "outbytes_total": 570,
                    "outpkts_delta": 7,
                    "port_name": "ethernet0",
                    "processing_time": 0,
                    "proto": 6,
                    "proto_name": "tcp",
                    "response_time": 199,
                    "severity": 30,
                    "src_tuples": "00:50:56:a2:04:db.0.172.30.202.208",
                    "srcip": "172.30.202.208",
                    "srcip_geo": {
                        "city": "Unknown",
                        "countryCode": "UN",
                        "countryName": "Unknown"
                    },
                    "srcip_geo_point": "0.0,0.0",
                    "srcip_host": "172.30.202.208",
                    "srcip_reputation": "Good",
                    "srcip_type": "private",
                    "srcmac": "00:50:56:a2:04:db",
                    "srcport": 42344,
                    "start_time": 1594317594889,
                    "state": "Closed",
                    "tcp_rtt": 203,
                    "tenant_id": "",
                    "tenantid": "",
                    "threat_score": 0,
                    "timestamp": 1594318142374,
                    "tos": 0,
                    "totalbytes": 2893,
                    "totalpackets": 12,
                    "typical": 0,
                    "url": "dl.stellarcyber.ai/ubuntu/apt.gpg.key",
                    "url_reputation": "Good",
                    "vlan": 0,
                    "write_time": 1594318526414
                },
                "sort": [
                    1594318142374
                ]
            }
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ (Entität / Allgemein)
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn Statuscode == 200 (is_success = true)

Geben Sie „Successfully executed search in Stellar Cyber Starlight.“ aus.

Wenn ein anderer Statuscode zurückgegeben wird (is_success=false):

Ausgabe: „Aktion konnte die Suche in Stellar Cyber Starlight nicht ausführen. Gründe: {0}.(Liste der Fehler/Ursachen/Gründe, durch neue Zeile getrennt.)

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Ii Schwerwiegender Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges:

Geben Sie „Fehler beim Ausführen der Aktion ‚Einfache Suche‘“ aus. Reason: {0}''.format(error.Stacktrace)

Allgemein

Beschreibung

Erweiterte Suche in Stellar Cyber Starlight ausführen.

Bekannte Indexe

Name Index
Assets aella-assets-*
AWS-Ereignisse aella-cloudtrail-*
Linux-Ereignisse aella-audit-*
ML-IDS-/Malware-Erkennungsereignisse aella-maltrace-*
Monitoring aella-ade-*
Scans aella-scan-*
Sicherheitsereignisse aella-ser-*
SNMP aella-perf-*
Syslog aella-syslog-*
Traffic aella-adr-*
Nutzer aella-users-*
Windows-Ereignisse aella-wineventlog-*

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Index String – Ja Geben Sie an, in welchem Index Sie suchen möchten. Eine Liste der bekannten Indexe finden Sie in der Dokumentation.
DSL-Abfrage String

{

"size": 1,

"from": 0,

"query": {

"match_all": {}

},

"sort": [

{

"timestamp": {

"order": "asc"

}

}

]

}

Ja Geben Sie das JSON-Objekt der DSL-Abfrage an, die Sie ausführen möchten.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
{
                "_index": "aella-ser-1594316167944-",
                "_type": "amsg",
                "_id": "LzfKNHMByqrLS2zLF9bf",
                "_score": null,
                "_source": {
                    "actual": 1,
                    "advanced": 2,
                    "aella_tuples": "172.30.202.208.52.8.234.27.80.67",
                    "anomaly_id": "job024_anomalous_user_agent-2020.07.09",
                    "appid": 67,
                    "appid_family": "Web",
                    "appid_name": "http",
                    "appid_stdport": "yes",
                    "days_silent": 14,
                    "detected_field": "metadata.request.user_agent",
                    "detected_value": "curl/7.47.0",
                    "detector_index": 0,
                    "doc_ids": [],
                    "dscp_name": "Best Effort",
                    "dstip": "52.8.234.27",
                    "dstip_geo": {
                        "city": "San Jose",
                        "countryCode": "US",
                        "countryName": "United States",
                        "latitude": 37.3388,
                        "longitude": -121.8914,
                        "region": "California"
                    },
                    "dstip_geo_point": "37.3388,-121.8914",
                    "dstip_host": "dl.stellarcyber.ai",
                    "dstip_reputation": "Good",
                    "dstip_type": "public",
                    "dstmac": "e8:1c:ba:4c:37:be",
                    "dstport": 80,
                    "duration": 605,
                    "end_reason": 4,
                    "end_time": 1594318194011,
                    "engid": "ad42005056a204db",
                    "engid_gateway": "",
                    "engid_name": "siemplify-sensor",
                    "event_category": "network",
                    "event_name": "user_agent_anomaly",
                    "event_score": 54,
                    "event_source": "rare_ml",
                    "event_status": "New",
                    "event_type": "conn",
                    "fidelity": 99,
                    "flow_score": 100,
                    "inbytes_delta": 2323,
                    "inbytes_total": 2323,
                    "inpkts_delta": 5,
                    "locid": "unassigned location",
                    "metadata": {
                        "request": {
                            "host": "dl.stellarcyber.ai",
                            "index": 1,
                            "method": "GET",
                            "server": "dl.stellarcyber.ai",
                            "uri": "/ubuntu/apt.gpg.key",
                            "user_agent": "curl/7.47.0"
                        },
                        "response": {
                            "code": 200,
                            "file_type": "data",
                            "index": 1,
                            "mime_type": "application/octet-stream",
                            "processing_time": 0,
                            "response_time": 199
                        }
                    },
                    "metadata.request.user_agent": "\"curl/7.47.0\"",
                    "msg_class": "interflow_traffic",
                    "msg_origin": {
                        "source": "network_sensor"
                    },
                    "msgtype": 4,
                    "msgtype_name": "startend",
                    "netid": 0,
                    "netid_name": "vlan0",
                    "obsid": 2887699152,
                    "orig_id": "4TfENHMByqrLS2zLZtWQ",
                    "orig_index": "aella-adr-1594315890054-",
                    "outbytes_delta": 570,
                    "outbytes_total": 570,
                    "outpkts_delta": 7,
                    "port_name": "ethernet0",
                    "processing_time": 0,
                    "proto": 6,
                    "proto_name": "tcp",
                    "response_time": 199,
                    "severity": 30,
                    "src_tuples": "00:50:56:a2:04:db.0.172.30.202.208",
                    "srcip": "172.30.202.208",
                    "srcip_geo": {
                        "city": "Unknown",
                        "countryCode": "UN",
                        "countryName": "Unknown"
                    },
                    "srcip_geo_point": "0.0,0.0",
                    "srcip_host": "172.30.202.208",
                    "srcip_reputation": "Good",
                    "srcip_type": "private",
                    "srcmac": "00:50:56:a2:04:db",
                    "srcport": 42344,
                    "start_time": 1594317594889,
                    "state": "Closed",
                    "tcp_rtt": 203,
                    "tenant_id": "",
                    "tenantid": "",
                    "threat_score": 0,
                    "timestamp": 1594318142374,
                    "tos": 0,
                    "totalbytes": 2893,
                    "totalpackets": 12,
                    "typical": 0,
                    "url": "dl.stellarcyber.ai/ubuntu/apt.gpg.key",
                    "url_reputation": "Good",
                    "vlan": 0,
                    "write_time": 1594318526414
                },
                "sort": [
                    1594318142374
                ]
            }
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ (Entität / Allgemein)
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn Statuscode == 200 (is_success = true)

Geben Sie „Successfully executed search in Stellar Cyber Starlight.“ aus.

Wenn ein anderer Statuscode zurückgegeben wird (is_success=false):

Ausgabe: „Aktion konnte die Suche in Stellar Cyber Starlight nicht ausführen. Gründe: {0}.(Liste der Fehler/Ursachen/Gründe, durch neue Zeile getrennt.)

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Ii Schwerwiegender Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges:

Geben Sie „Fehler bei der Ausführung der Aktion „Erweiterte Suche“ aus. Reason: {0}''.format(error.Stacktrace)

Allgemein

Sicherheitsereignis aktualisieren

Beschreibung

Aktualisieren Sie das Sicherheitsereignis in Stellar Cyber Starlight.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Index String – Ja Geben Sie den Index des Sicherheitsereignisses an.
ID String – Ja Geben Sie die ID des Sicherheitsereignisses an.
Status DDL

Wählen Sie eine Option aus.

Mögliche Werte:

Wählen Sie eine Option aus.

Neu
In Bearbeitung
Ignoriert
Geschlossen

Nein Geben Sie den neuen Status für das Sicherheitsereignis an.
Kommentar String – Nein Geben Sie einen Kommentar für das Sicherheitsereignis ein.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte die Ausführung eines Playbooks weder fehlschlagen lassen noch stoppen:

Wenn status_code == 200 (is_success = true): „Das Ereignis {event_id} wurde in Stellar Cyber Starlight aktualisiert.“.

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Bei schwerwiegendem Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Sicherheitsereignis aktualisieren‘. Reason: {0}''.format(error.Stacktrace)

Wenn ein anderer Statuscode zurückgegeben wird (is_success=false): Fehler beim Ausführen der Aktion „Sicherheitsereignis aktualisieren“. Grund: {text from response}

Wenn keiner der Parameter angegeben ist:Fehler beim Ausführen der Aktion „Sicherheitsereignis aktualisieren“. Grund: Mindestens eines der Felder „Status“ oder „Kommentar“ muss einen Wert enthalten.

Allgemein

Connectors

Stellar Cyber Starlight – Security Events Connector

Beschreibung

Sicherheitsereignisse aus Stellar Cyber Starlight abrufen.

Stellar Cyber Starlight – Connector für sicherheitsrelevante Ereignisse in Google SecOps konfigurieren

Eine detaillierte Anleitung zum Konfigurieren eines Connectors in Google SecOps finden Sie unter Connector konfigurieren.

Connector-Parameter

Verwenden Sie die folgenden Parameter, um den Connector zu konfigurieren:

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Produktfeldname String Produktname Ja Geben Sie den Namen des Quellfelds ein, um den Namen des Produktfelds abzurufen.
Name des Ereignisfelds String event_data.event_name Ja Geben Sie den Namen des Quellfelds ein, um den Namen des Ereignisfelds abzurufen.
Name des Umgebungsfelds String "" Nein

Beschreibt den Namen des Felds, in dem der Umgebungsname gespeichert ist.

Wenn das Feld „environment“ nicht gefunden wird, ist die Umgebung die Standardumgebung.

Regex-Muster für Umgebung String .* Nein

Ein Regex-Muster, das für den Wert im Feld „Environment Field Name“ ausgeführt werden soll.

Der Standardwert ist .*, um alle Werte zu erfassen und unverändert zurückzugeben.

Wird verwendet, um dem Nutzer die Möglichkeit zu geben, das Feld „Umgebung“ über Regex-Logik zu bearbeiten.

Wenn das Regex-Muster null oder leer ist oder der Umgebungswert null ist, ist das endgültige Umgebungsergebnis die Standardumgebung.

Zeitlimit für Script (Sekunden) Ganzzahl 180 Ja Zeitlimit für den Python-Prozess, der das aktuelle Script ausführt.
API-Stamm String https://{ip}/connect/api/ Ja API-Stamm der Stellar Cyber Starlight-Instanz.
Nutzername String – Ja Nutzername des Stellar Cyber Starlight-Kontos.
API-Schlüssel Passwort – Nein

API-Schlüssel des Stellar Cyber Starlight-Kontos. Dieser Parameter wurde für die Basisauthentifizierung verwendet.

Wenn sowohl API Key als auch API Token angegeben sind, hat API Token Priorität.

API-Token Passwort – Nein

API-Token des Stellar Cyber Starlight-Kontos. Dieser Parameter wird für die JWT-Authentifizierung verwendet.

Wenn sowohl API Key als auch API Token angegeben sind, hat API Token Priorität.

Niedrigster abzurufender Schweregrad Ganzzahl 50 Ja Niedrigster Schweregrad, der zum Abrufen von Ereignissen verwendet wird.
Maximale Anzahl von Stunden rückwärts abrufen Ganzzahl 1 Nein Anzahl der Stunden, für die Ereignisse abgerufen werden sollen.
Maximale Anzahl abzurufender Ereignisse Ganzzahl 50 Nein Wie viele Ereignisse pro Connector-Iteration verarbeitet werden sollen.
Zulassungsliste als Sperrliste verwenden Kästchen Deaktiviert Ja Wenn diese Option aktiviert ist, wird die Zulassungsliste als Sperrliste verwendet.
SSL überprüfen Kästchen Deaktiviert Ja Wenn diese Option aktiviert ist, prüfen Sie, ob das SSL-Zertifikat für die Verbindung zum Stellar Cyber Starlight-Server gültig ist.
Proxyserveradresse String – Nein Die Adresse des zu verwendenden Proxyservers.
Proxy-Nutzername String – Nein Der Proxy-Nutzername für die Authentifizierung.
Proxy-Passwort Passwort – Nein Das Proxy-Passwort für die Authentifizierung.
Padding-Zeitraum Ganzzahl 0 Nein Padding-Zeitraum in Stunden für die Connector-Ausführung.

Connector-Regeln

Proxyunterstützung.

Der Connector unterstützt Proxys.

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