Armis Geräteprotokolle erfassen

Parserversion: 2.0

Unterstützt in:

In diesem Dokument wird beschrieben, wie Sie Armis Devices-Geräteprotokolle mit Cloud Storage V2 in Google Security Operations aufnehmen.

Armis Centrix ist eine Asset-Intelligence-Plattform für Unternehmen, die Sichtbarkeit und Schutz für verwaltete, nicht verwaltete und IoT-/OT-Geräte bietet. Der Armis Devices-Datenstream erfasst das gesamte Geräteinventar, das in überwachten Netzwerken beobachtet wird, einschließlich Hardwaredetails, Netzwerkattributen, Risikobewertungen und Klassifizierungsmetadaten. Diese Geräteinventarlogs können über die Armis REST API exportiert und in einen Cloud Storage-Bucket geschrieben werden, damit sie von Google SecOps aufgenommen werden können.

Hinweis

Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:

  • Eine Google SecOps-Instanz
  • Ein Google Cloud -Projekt mit aktivierter Cloud Storage API
  • Berechtigungen zum Erstellen und Verwalten von Cloud Storage-Buckets
  • Berechtigungen zum Erstellen von Cloud Run-Diensten, Pub/Sub-Themen und Cloud Scheduler-Jobs
  • Eine Armis Centrix-Instanz mit API-Zugriff
  • Ein geheimer Armis API-Schlüssel mit Berechtigungen zum Lesen von Gerätedaten

Armis API-Secret-Key generieren

  1. Melden Sie sich unter https://<your-instance>.armis.com in der Armis Centrix-Konsole an.
  2. Gehen Sie zu Einstellungen > Asset-Verwaltung und Sicherheit > API-Verwaltung.
  3. Klicken Sie auf Erstellen, um einen neuen geheimen API-Schlüssel zu generieren.
  4. In einem Dialogfeld wird der geheime Schlüssel angezeigt.
  5. Kopieren und speichern Sie den geheimen Schlüssel an einem sicheren Ort.

API-Zugriff prüfen

  • Testen Sie Ihre Anmeldedaten, bevor Sie mit der Integration fortfahren:

    ARMIS_INSTANCE="https://your-instance.armis.com"
    ARMIS_SECRET_KEY="your-secret-key"
    
    # Get access token
    ACCESS_TOKEN=$(curl -s -X POST "${ARMIS_INSTANCE}/api/v1/access_token/" \
        -d "secret_key=${ARMIS_SECRET_KEY}" \
        | python3 -c "import sys,json; print(json.load(sys.stdin)['data']['access_token'])")
    
    echo "Access Token: ${ACCESS_TOKEN}"
    
    # Test device search
    curl -s "${ARMIS_INSTANCE}/api/v1/search/" \
        -H "Authorization: ${ACCESS_TOKEN}" \
        -G \
        --data-urlencode "aql=in:devices timeFrame:\"1 Hours\"" \
        --data-urlencode "length=1" \
        --data-urlencode "fields=id,name,type,category,model,manufacturer,ipAddress,macAddress,operatingSystem,riskLevel,site,firstSeen,lastSeen" \
        | python3 -m json.tool
    

Cloud Storage-Bucket erstellen

  1. Rufen Sie die Google Cloud Console auf.
  2. Wählen Sie Ihr Projekt aus oder erstellen Sie ein neues.
  3. Rufen Sie im Navigationsmenü Cloud Storage > Buckets auf.
  4. Klicken Sie auf Bucket erstellen.
  5. Geben Sie die folgenden Konfigurationsdetails an:

    Einstellung Wert
    Bucket benennen Geben Sie einen global eindeutigen Namen ein (z. B. armis-device-logs).
    Standorttyp Wählen Sie die Option, die am besten zu Ihren Anforderungen passt (Region, Dual-Region, Multi-Region).
    Standort Wählen Sie den Standort aus (z. B. us-central1).
    Speicherklasse Standard (empfohlen für Logs, auf die häufig zugegriffen wird)
    Zugriffssteuerung Einheitlich (empfohlen)
    Schutztools Optional: Objektversionsverwaltung oder Aufbewahrungsrichtlinie aktivieren
  6. Klicken Sie auf Erstellen.

Dienstkonto für die Cloud Run-Funktion erstellen

Die Cloud Run-Funktion benötigt ein Dienstkonto mit Berechtigungen zum Schreiben in den Cloud Storage-Bucket und zum Aufrufen durch Pub/Sub.

Erstellen Sie das Dienstkonto:

  1. Wechseln Sie in der Google Cloud Console zu IAM und Verwaltung > Dienstkonten.
  2. Klicken Sie auf Dienstkonto erstellen.
  3. Geben Sie die folgenden Konfigurationsdetails an:
    • Name des Dienstkontos: Geben Sie armis-devices-collector-sa ein.
    • Beschreibung des Dienstkontos: Geben Sie Service account for Cloud Run function to collect Armis device inventory logs ein.
  4. Klicken Sie auf Erstellen und fortfahren.
  5. Fügen Sie im Abschnitt Diesem Dienstkonto Zugriff auf das Projekt erteilen die folgenden Rollen hinzu:
    1. Klicken Sie auf Rolle auswählen.
    2. Suchen Sie nach Storage Object Admin und wählen Sie die Rolle aus.
    3. Klicken Sie auf + Weitere Rolle hinzufügen.
    4. Suchen Sie nach Cloud Run Invoker und wählen Sie die Rolle aus.
    5. Klicken Sie auf + Weitere Rolle hinzufügen.
    6. Suchen Sie nach Cloud Functions-Aufrufer und wählen Sie die Rolle aus.
  6. Klicken Sie auf Weiter.
  7. Klicken Sie auf Fertig.

Diese Rollen sind erforderlich für:

  • Storage-Objekt-Administrator: Logs in den Cloud Storage-Bucket schreiben und Statusdateien verwalten
  • Cloud Run-Aufrufer: Pub/Sub erlauben, die Funktion aufzurufen
  • Cloud Functions-Invoker: Funktionsaufruf zulassen

IAM-Berechtigungen (Identity and Access Management) für einen Cloud Storage-Bucket gewähren

Gewähren Sie dem Dienstkonto Schreibberechtigungen für den Cloud Storage-Bucket:

  1. Rufen Sie Cloud Storage > Buckets auf.
  2. Klicken Sie auf den Namen Ihres Buckets.
  3. Wechseln Sie zum Tab Berechtigungen.
  4. Klicken Sie auf Zugriff erlauben.
  5. Geben Sie die folgenden Konfigurationsdetails an:
    • Hauptkonten hinzufügen: Geben Sie die E-Mail-Adresse des Dienstkontos ein (z. B. armis-devices-collector-sa@PROJECT_ID.iam.gserviceaccount.com).
    • Rollen zuweisen: Wählen Sie Storage-Objekt-Administrator aus.
  6. Klicken Sie auf Speichern.

Pub/Sub-Thema erstellen

Erstellen Sie ein Pub/Sub-Thema, in dem Cloud Scheduler Nachrichten veröffentlicht und das die Cloud Run-Funktion abonniert.

  1. Rufen Sie in der Google Cloud Console Pub/Sub > Themen auf.
  2. Klicken Sie auf Thema erstellen.
  3. Geben Sie die folgenden Konfigurationsdetails an:
    • Themen-ID: Geben Sie armis-devices-trigger ein.
    • Übernehmen Sie die anderen Einstellungen.
  4. Klicken Sie auf Erstellen.

Cloud Run-Funktion zum Erfassen von Logs erstellen

Die Cloud Run-Funktion wird durch Pub/Sub-Nachrichten von Cloud Scheduler ausgelöst, um Geräteinventardatensätze aus der Armis REST API abzurufen und in Cloud Storage zu schreiben.

  1. Rufen Sie in der Google Cloud Console Cloud Run auf.
  2. Klicken Sie auf Dienst erstellen.
  3. Wählen Sie Funktion aus (Funktion mit einer Direktbearbeitung erstellen).
  4. Geben Sie im Abschnitt Konfigurieren die folgenden Konfigurationsdetails an:

    Einstellung Wert
    Dienstname armis-devices-collector
    Region Wählen Sie die Region aus, die Ihrem Cloud Storage-Bucket entspricht (z. B. us-central1).
    Laufzeit Wählen Sie Python 3.12 oder höher aus.
  5. Im Abschnitt Trigger (optional):

    1. Klicken Sie auf + Trigger hinzufügen.
    2. Wählen Sie Cloud Pub/Sub aus.
    3. Wählen Sie unter Cloud Pub/Sub-Thema auswählen das Thema armis-devices-trigger aus.
    4. Klicken Sie auf Speichern.
  6. Im Abschnitt Authentifizierung:

    1. Wählen Sie Authentifizierung erforderlich aus.
    2. Prüfen Sie Identity and Access Management (IAM).
  7. Scrollen Sie nach unten und maximieren Sie Container, Netzwerk, Sicherheit.

  8. Rufen Sie den Tab Sicherheit auf:

    • Dienstkonto: Wählen Sie das Dienstkonto armis-devices-collector-sa aus.
  9. Rufen Sie den Tab Container auf:

    1. Klicken Sie auf Variablen und Secrets.
    2. Klicken Sie für jede Umgebungsvariable auf + Variable hinzufügen:
    Variablenname Beispielwert Beschreibung
    GCS_BUCKET armis-device-logs Name des Cloud Storage-Buckets
    GCS_PREFIX armis-devices Präfix für Logdateien
    STATE_KEY armis-devices/state.json Pfad der Statusdatei
    ARMIS_INSTANCE_URL https://your-instance.armis.com Armis-Instanz-URL
    ARMIS_SECRET_KEY your-secret-key Geheimer Armis-API-Schlüssel
    PAGE_SIZE 1000 Einträge pro API-Seite
    MAX_RECORDS 50000 Maximale Anzahl von Datensätzen pro Ausführung
    LOOKBACK_HOURS 24 Anfänglicher Rückschauzeitraum
  10. Scrollen Sie im Abschnitt Variablen und Secrets nach unten zu Anfragen:

    • Zeitüberschreitung bei Anfrage: Geben Sie 540 Sekunden (9 Minuten) ein.
  11. Wechseln Sie zum Tab Einstellungen:

    • Im Abschnitt Ressourcen:
      • Arbeitsspeicher: Wählen Sie 512 MiB oder höher aus.
      • CPU: Wählen Sie 1 aus.
  12. Im Abschnitt Versionsskalierung:

    • Mindestanzahl von Instanzen: Geben Sie 0 ein.
    • Maximale Anzahl von Instanzen: Geben Sie 100 ein (oder passen Sie den Wert an die erwartete Last an).
  13. Klicken Sie auf Erstellen.

  14. Warten Sie, bis der Dienst erstellt wurde (1–2 Minuten).

  15. Nachdem der Dienst erstellt wurde, wird der Inline-Code-Editor automatisch geöffnet.

Funktionscode hinzufügen

  1. Geben Sie main in das Feld Einstiegspunkt ein.
  2. Erstellen Sie im Inline-Code-Editor zwei Dateien:

    • Erste Datei – main.py:

      import functions_framework
      from google.cloud import storage
      import json
      import os
      import urllib3
      import urllib.parse
      from datetime import datetime, timezone, timedelta
      import time
      
      # Initialize HTTP client with timeouts
      http = urllib3.PoolManager(
        timeout=urllib3.Timeout(connect=5.0, read=60.0),
        retries=False,
      )
      
      # Initialize Storage client
      storage_client = storage.Client()
      
      # Environment variables
      GCS_BUCKET = os.environ.get('GCS_BUCKET')
      GCS_PREFIX = os.environ.get('GCS_PREFIX', 'armis-devices').strip('/')
      STATE_KEY = os.environ.get('STATE_KEY') or f"{GCS_PREFIX}/state.json"
      ARMIS_INSTANCE_URL = os.environ.get('ARMIS_INSTANCE_URL', '').rstrip('/')
      ARMIS_SECRET_KEY = os.environ.get('ARMIS_SECRET_KEY')
      PAGE_SIZE = int(os.environ.get('PAGE_SIZE', '1000'))
      MAX_RECORDS = int(os.environ.get('MAX_RECORDS', '50000'))
      LOOKBACK_HOURS = int(os.environ.get('LOOKBACK_HOURS', '24'))
      
      DEVICE_FIELDS = [
        'id', 'name', 'type', 'category', 'model', 'manufacturer',
        'ipAddress', 'macAddress', 'operatingSystem', 'operatingSystemVersion',
        'riskLevel', 'site', 'tags', 'firstSeen', 'lastSeen',
        'boundaries', 'customProperties', 'dataSources', 'userIds',
        'visibility', 'ppiSensitive'
      ]
      
      def parse_datetime(value):
        """Parse ISO datetime string to datetime object."""
        if not value:
          return None
        if value.endswith("Z"):
          value = value[:-1] + "+00:00"
        try:
          return datetime.fromisoformat(value)
        except Exception:
          try:
            return datetime.strptime(value, '%Y-%m-%dT%H:%M:%S')
          except Exception:
            return None
      
      def get_access_token():
        """Obtain an access token from the Armis API."""
        url = f"{ARMIS_INSTANCE_URL}/api/v1/access_token/"
        body = urllib.parse.urlencode({'secret_key': ARMIS_SECRET_KEY})
        response = http.request(
          'POST', url,
          body=body,
          headers={'Content-Type': 'application/x-www-form-urlencoded'}
        )
        if response.status != 200:
          raise Exception(
            f"Failed to get access token: HTTP {response.status} - "
            f"{response.data.decode('utf-8')}"
          )
        data = json.loads(response.data.decode('utf-8'))
        return data['data']['access_token']
      
      @functions_framework.cloud_event
      def main(cloud_event):
        """
        Cloud Run function triggered by Pub/Sub to fetch
        Armis Device inventory records and write to GCS.
      
        Args:
          cloud_event: CloudEvent object containing Pub/Sub message
        """
      
        if not all([GCS_BUCKET, ARMIS_INSTANCE_URL, ARMIS_SECRET_KEY]):
          print('Error: Missing required environment variables')
          return
      
        try:
          bucket = storage_client.bucket(GCS_BUCKET)
      
          # Load state
          state = load_state(bucket, STATE_KEY)
      
          # Determine time window
          now = datetime.now(timezone.utc)
          last_time = None
      
          if isinstance(state, dict) and state.get("last_event_time"):
            try:
              last_time = parse_datetime(state["last_event_time"])
              # Overlap by 2 minutes to catch delayed events
              if last_time:
                last_time = last_time - timedelta(minutes=2)
            except Exception as e:
              print(f"Warning: Could not parse last_event_time: {e}")
      
          if last_time is None:
            last_time = now - timedelta(hours=LOOKBACK_HOURS)
      
          print(
            f"Fetching device logs from "
            f"{last_time.isoformat()} to {now.isoformat()}"
          )
      
          # Get access token
          access_token = get_access_token()
          print("Successfully obtained Armis access token.")
      
          # Fetch device records
          records, newest_event_time = fetch_device_logs(
            access_token=access_token,
            start_time=last_time,
            end_time=now,
          )
      
          if not records:
            print("No new device records found.")
            save_state(bucket, STATE_KEY, now.isoformat())
            return
      
          # Write to GCS as NDJSON
          timestamp = now.strftime('%Y%m%d_%H%M%S')
          object_key = f"{GCS_PREFIX}/logs_{timestamp}.ndjson"
          blob = bucket.blob(object_key)
      
          ndjson = '\n'.join(
            [json.dumps(record, ensure_ascii=False) for record in records]
          ) + '\n'
          blob.upload_from_string(
            ndjson, content_type='application/x-ndjson'
          )
      
          print(
            f"Wrote {len(records)} records to "
            f"gs://{GCS_BUCKET}/{object_key}"
          )
      
          # Update state
          if newest_event_time:
            save_state(bucket, STATE_KEY, newest_event_time)
          else:
            save_state(bucket, STATE_KEY, now.isoformat())
      
          print(f"Successfully processed {len(records)} records")
      
        except Exception as e:
          print(f'Error processing device logs: {str(e)}')
          raise
      
      def load_state(bucket, key):
        """Load state from GCS."""
        try:
          blob = bucket.blob(key)
          if blob.exists():
            state_data = blob.download_as_text()
            return json.loads(state_data)
        except Exception as e:
          print(f"Warning: Could not load state: {e}")
        return {}
      
      def save_state(bucket, key, last_event_time_iso):
        """Save the last event timestamp to GCS state file."""
        try:
          state = {'last_event_time': last_event_time_iso}
          blob = bucket.blob(key)
          blob.upload_from_string(
            json.dumps(state, indent=2),
            content_type='application/json'
          )
          print(f"Saved state: last_event_time={last_event_time_iso}")
        except Exception as e:
          print(f"Warning: Could not save state: {e}")
      
      def fetch_device_logs(access_token, start_time, end_time):
        """
        Fetch device inventory logs from Armis REST API with pagination.
      
        Args:
          access_token: Armis API access token
          start_time: Start time for log query
          end_time: End time for log query
      
        Returns:
          Tuple of (records list, newest_event_time ISO string)
        """
        base_url = f"{ARMIS_INSTANCE_URL}/api/v1/search/"
        headers = {'Authorization': access_token}
      
        # Build AQL query with time filter
        start_str = start_time.strftime('%Y-%m-%dT%H:%M:%S')
        aql_query = f'in:devices after:{start_str}'
      
        records = []
        newest_time = None
        page_from = 0
        backoff = 1.0
      
        while True:
          if len(records) >= MAX_RECORDS:
            print(f"Reached max_records limit ({MAX_RECORDS})")
            break
      
          params = {
            'aql': aql_query,
            'from': str(page_from),
            'orderBy': 'lastSeen',
            'length': str(PAGE_SIZE),
            'fields': ','.join(DEVICE_FIELDS),
          }
      
          try:
            response = http.request(
              'GET', base_url,
              fields=params,
              headers=headers
            )
      
            # Handle rate limiting with exponential backoff
            if response.status == 429:
              retry_after = int(
                response.headers.get(
                  'Retry-After', str(int(backoff))
                )
              )
              print(
                f"Rate limited (429). "
                f"Retrying after {retry_after}s..."
              )
              time.sleep(retry_after)
              backoff = min(backoff * 2, 30.0)
              continue
      
            # Handle token expiry
            if response.status == 401:
              print("Access token expired, refreshing...")
              access_token = get_access_token()
              headers = {'Authorization': access_token}
              continue
      
            backoff = 1.0
      
            if response.status != 200:
              print(f"HTTP Error: {response.status}")
              response_text = response.data.decode('utf-8')
              print(f"Response body: {response_text}")
              return records, newest_time
      
            data = json.loads(response.data.decode('utf-8'))
            result = data.get('data', {}).get('results', [])
            total = data.get('data', {}).get('total', 0)
            count = data.get('data', {}).get('count', 0)
            next_from = data.get('data', {}).get('next')
      
            if not result:
              print(f"No more results (empty page)")
              break
      
            print(
              f"Page from={page_from}: Retrieved {count} devices "
              f"(total: {total})"
            )
            records.extend(result)
      
            # Track newest event time using lastSeen
            for device in result:
              try:
                event_time = device.get('lastSeen')
                if event_time:
                  if newest_time is None:
                    newest_time = event_time
                  else:
                    current_dt = parse_datetime(event_time)
                    newest_dt = parse_datetime(newest_time)
                    if (
                      current_dt and newest_dt
                      and current_dt > newest_dt
                    ):
                      newest_time = event_time
              except Exception as e:
                print(
                  f"Warning: Could not parse "
                  f"event time: {e}"
                )
      
            # Check pagination
            if next_from is None or count < PAGE_SIZE:
              print("Reached last page")
              break
      
            page_from = next_from
      
          except Exception as e:
            print(f"Error fetching device logs: {e}")
            return records, newest_time
      
        print(f"Retrieved {len(records)} total device records")
        return records, newest_time
      

    • Zweite Datei – requirements.txt:

      functions-framework==3.*
      google-cloud-storage==2.*
      urllib3>=2.0.0
      
  3. Klicken Sie auf Bereitstellen, um die Funktion zu speichern und bereitzustellen.

  4. Warten Sie, bis die Bereitstellung abgeschlossen ist (2–3 Minuten).

Cloud Scheduler-Job erstellen

Cloud Scheduler veröffentlicht in regelmäßigen Abständen Nachrichten im Pub/Sub-Thema und löst so die Cloud Run-Funktion aus.

  1. Rufen Sie in der Google Cloud Console Cloud Scheduler auf.
  2. Klicken Sie auf Job erstellen.
  3. Geben Sie die folgenden Konfigurationsdetails an:

    Einstellung Wert
    Name armis-devices-collector-daily
    Region Wählen Sie dieselbe Region wie für die Cloud Run-Funktion aus.
    Frequenz 0 2 * * * (täglich um 02:00 Uhr)
    Zeitzone Zeitzone auswählen (UTC empfohlen)
    Zieltyp Pub/Sub
    Thema Wählen Sie das Thema armis-devices-trigger aus.
    Inhalt der Nachricht {} (leeres JSON-Objekt)
  4. Klicken Sie auf Erstellen.

Optionen für die Häufigkeit des Zeitplans

Wählen Sie die Häufigkeit basierend auf der Aktualisierungsrate des Geräteinventars und den Latenzanforderungen aus:

Häufigkeit Cron-Ausdruck Anwendungsfall
Alle 6 Stunden 0 */6 * * * Häufige Inventaraktualisierungen
Täglich 0 2 * * * Standard (empfohlen)
Alle 12 Stunden 0 */12 * * * Umgebungen mit geringer Lautstärke

Integration testen

  1. Suchen Sie in der Cloud Scheduler-Konsole nach Ihrem Job.
  2. Klicken Sie auf Ausführung erzwingen, um den Job manuell auszulösen.
  3. Warte einige Sekunden.
  4. Rufen Sie Cloud Run > Dienste auf.
  5. Klicken Sie auf den Funktionsnamen armis-devices-collector.
  6. Klicken Sie auf den Tab Logs.
  7. Prüfen Sie, ob die Funktion erfolgreich ausgeführt wurde. Achte dabei auf Folgendes:

    Fetching device logs from YYYY-MM-DDTHH:MM:SS+00:00 to YYYY-MM-DDTHH:MM:SS+00:00
    Successfully obtained Armis access token.
    Page from=0: Retrieved X devices (total: Y)
    Wrote X records to gs://armis-device-logs/armis-devices/logs_YYYYMMDD_HHMMSS.ndjson
    Successfully processed X records
    
  8. Rufen Sie Cloud Storage > Buckets auf.

  9. Klicken Sie auf den Namen Ihres Buckets.

  10. Rufen Sie den Präfixordner armis-devices/ auf.

  11. Prüfen Sie, ob eine neue .ndjson-Datei mit dem aktuellen Zeitstempel erstellt wurde.

Wenn Sie Fehler in den Logs sehen:

  • HTTP 400: Prüfen Sie, ob die Syntax der AQL-Abfrage korrekt ist. Achten Sie darauf, dass die URL der Armis-Instanz keinen abschließenden Schrägstrich enthält.
  • HTTP 401: Das Zugriffstoken ist abgelaufen oder ungültig. Die Funktion aktualisiert das Token bei 401-Fehlern automatisch.
  • HTTP 429: Ratenbegrenzung – Die Funktion wird automatisch mit Backoff wiederholt.
  • „Zugriffstoken nicht gefunden“: Prüfen Sie, ob der geheime Armis API-Schlüssel korrekt ist.
  • Fehlende Umgebungsvariablen: Prüfen Sie, ob alle erforderlichen Variablen festgelegt sind.

Feed in Google SecOps konfigurieren, um Armis Devices-Geräteprotokolle aufzunehmen

  1. Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
  2. Klicken Sie auf Neuen Feed hinzufügen.
  3. Klicken Sie auf Einzelnen Feed konfigurieren.
  4. Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B. Armis Devices.
  5. Wählen Sie Google Cloud Storage V2 als Quelltyp aus.
  6. Wählen Sie Armis Devices als Logtyp aus.
  7. Klicken Sie auf Dienstkonto abrufen. Eine eindeutige E-Mail-Adresse für das Dienstkonto wird angezeigt, z. B.:

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com
    
  8. Kopieren Sie diese E-Mail-Adresse, um sie im nächsten Schritt zu verwenden.

  9. Klicken Sie auf Weiter.

  10. Geben Sie Werte für die folgenden Eingabeparameter an:

    • Storage-Bucket-URL: Geben Sie den Cloud Storage-Bucket-URI mit dem Präfixpfad ein:

      gs://armis-device-logs/armis-devices/
      
      • Ersetzen Sie:
        • armis-device-logs: Name Ihres Cloud Storage-Bucket.
        • armis-devices: Optionaler Präfix-/Ordnerpfad, in dem Logs gespeichert werden (leer lassen für Stammverzeichnis).
    • Option zum Löschen der Quelle: Wählen Sie die gewünschte Löschoption aus:

      • Nie: Nach Übertragungen werden keine Dateien gelöscht (für Tests empfohlen).
      • Übertragene Dateien löschen: Dateien werden nach erfolgreicher Übertragung gelöscht.
      • Übertragene Dateien und leere Verzeichnisse löschen: Dateien und leere Verzeichnisse werden nach erfolgreicher Übertragung gelöscht.
    • Maximales Dateialter: Dateien einschließen, die in den letzten Tagen geändert wurden (Standardwert: 180 Tage)

    • Asset-Namespace: Der Asset-Namespace

    • Labels für Datenaufnahme: Das Label, das auf die Ereignisse aus diesem Feed angewendet werden soll.

  11. Klicken Sie auf Weiter.

  12. Prüfen Sie die neue Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.

Dem Google SecOps-Dienstkonto IAM-Berechtigungen gewähren

Das Google SecOps-Dienstkonto benötigt die Rolle Storage-Objekt-Betrachter für Ihren Cloud Storage-Bucket.

  1. Rufen Sie Cloud Storage > Buckets auf.
  2. Klicken Sie auf den Namen Ihres Buckets.
  3. Wechseln Sie zum Tab Berechtigungen.
  4. Klicken Sie auf Zugriff erlauben.
  5. Geben Sie die folgenden Konfigurationsdetails an:
    • Hauptkonten hinzufügen: Fügen Sie die E‑Mail-Adresse des Google SecOps-Dienstkontos ein.
    • Rollen zuweisen: Wählen Sie Storage Object Viewer aus.
  6. Klicken Sie auf Speichern.

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
datasource.firstSeen metadata.event_timestamp Geparst als yyyy-MM-ddTHH:mm:ssZZ
datasource.lastSeen metadata.event_timestamp Geparst als yyyy-MM-ddTHH:mm:ssZZ
firstSeen metadata.event_timestamp Geparst als yyyy-MM-ddTHH:mm:ssZZ
lastSeen metadata.event_timestamp Geparst als yyyy-MM-ddTHH:mm:ssZZ
time metadata.event_timestamp Geparst als yyyy-MM-ddTHH:mm:ss.SSSZZ
id metadata.product_entity_id Direkt zugeordnet
relation relations Umbenannt/zugeordnet
– metadata.entity_type Konstante: ASSET
– metadata.product_name Konstante: ARMIS
– metadata.vendor_name Konstante: ARMIS

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

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