Recopila registros de IOC personalizados de Mandiant Threat Intelligence

Compatible con:

En este documento, se explica cómo transferir datos de IOC personalizados de Mandiant Threat Intelligence a Google Security Operations con Google Cloud Storage V2.

Mandiant Threat Intelligence proporciona indicadores de compromiso (IOC) enriquecidos en contexto, incluidas direcciones IP, dominios, URLs, hashes de archivos y direcciones de correo electrónico. La plataforma proporciona inteligencia contra amenazas basada en investigaciones de respuesta ante incidentes de primera línea, lo que permite a los equipos de seguridad identificar y priorizar las amenazas dirigidas a su organización.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Una instancia de Google SecOps
  • Un proyecto de GCP con la API de Cloud Storage habilitada
  • Permisos para crear y administrar buckets de GCS
  • Permisos para administrar políticas de IAM en buckets de GCS
  • Permisos para crear servicios de Cloud Run, temas de Pub/Sub y trabajos de Cloud Scheduler
  • Suscripción activa a Mandiant Advantage Threat Intelligence
  • Acceso con privilegios al portal de Mandiant Advantage

Crea un bucket de Google Cloud Storage

  1. Ve a Google Cloud Console.
  2. Selecciona tu proyecto o crea uno nuevo.
  3. En el menú de navegación, ve a Cloud Storage > Buckets.
  4. Haz clic en Crear bucket.

  5. Proporciona los siguientes detalles de configuración:

    Parámetro de configuración Valor
    Asigna un nombre a tu bucket Ingresa un nombre global único (por ejemplo, mandiant-ioc-logs).
    Tipo de ubicación Elige según tus necesidades (región, birregional, multirregional)
    Ubicación Selecciona la ubicación (por ejemplo, us-central1).
    Clase de almacenamiento Estándar (recomendado para los registros a los que se accede con frecuencia)
    Control de acceso Uniforme (recomendado)
    Herramientas de protección Opcional: Habilita el control de versiones de objetos o la política de retención

  6. Haz clic en Crear.

Recopila credenciales de Mandiant Advantage

Obtén la URL del sitio de Mandiant

  1. Accede a tu instancia de Mandiant Advantage.
  2. Anota la URL de tu sitio en la barra de direcciones del navegador.
    • La URL es https://advantage.mandiant.com.

Crea credenciales de API

  1. Inicia sesión en Mandiant Advantage.
  2. Ve a Configuración.
  3. Desplázate hacia abajo hasta API Access and Keys o selecciónalo en el menú de navegación.
  4. Haz clic en Get Key ID and Secret.
  5. Copia y guarda las credenciales de la API de forma segura:
    • ID de clave: Copia este valor (también conocido como ID de clave de API o clave pública).
    • Key Secret: Copia este valor (también conocido como secreto de API o clave privada).

Verifica los permisos

Para verificar que la cuenta tenga los permisos necesarios, haz lo siguiente:

  1. Inicia sesión en Mandiant Advantage.
  2. Ve a Configuración.
  3. Revisa tus permisos de usuario en Información del usuario.
  4. Verifica que tienes acceso al módulo Threat Intelligence.
  5. Si no puedes ver los datos de Threat Intelligence, comunícate con tu administrador de Mandiant para que te otorgue los permisos correspondientes.

Prueba el acceso a la API

  • Prueba tus credenciales antes de continuar con la integración:

    # Replace with your actual credentials
API_KEY_ID="your-key-id"
API_SECRET="your-key-secret"
API_BASE="https://api.intelligence.mandiant.com"

# Get OAuth token
TOKEN=$(curl -s -X POST "${API_BASE}/token" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -d "grant_type=client_credentials" \
    -u "${API_KEY_ID}:${API_SECRET}" | jq -r '.access_token')

# Test API access
curl -v -H "Authorization: Bearer ${TOKEN}" \
    "${API_BASE}/v4/indicator?limit=1"

Si la prueba se realiza correctamente, deberías recibir una respuesta JSON con datos del indicador. Si recibes un error, haz lo siguiente:

  • HTTP 401: Verifica que el ID y el secreto de la clave de API sean correctos
  • HTTP 403: Verifica que la cuenta tenga permisos de Threat Intelligence
  • HTTP 404: Verifica que la URL base de la API sea correcta

Crea una cuenta de servicio para la función de Cloud Run

La función de Cloud Run necesita una cuenta de servicio con permisos para escribir en el bucket de GCS y ser invocada por Pub/Sub.

Crear cuenta de servicio

  1. En Google Cloud Console, ve a IAM y administración > Cuentas de servicio.
  2. Haz clic en Crear cuenta de servicio.
  3. Proporciona los siguientes detalles de configuración:
    • Nombre de la cuenta de servicio: Ingresa mandiant-ioc-collector-sa (por ejemplo, mandiant-ioc-collector-sa).
    • Descripción de la cuenta de servicio: Ingresa Service account for Cloud Run function to collect Mandiant IOC logs.
  4. Haz clic en Crear y continuar.
  5. En la sección Otorga a esta cuenta de servicio acceso al proyecto, agrega los siguientes roles:
    1. Haz clic en Selecciona un rol.
    2. Busca y selecciona Administrador de objetos de Storage.
    3. Haz clic en + Agregar otro rol.
    4. Busca y selecciona Invocador de Cloud Run.
    5. Haz clic en + Agregar otro rol.
    6. Busca y selecciona Invocador de Cloud Functions.
  6. Haz clic en Continuar.
  7. Haz clic en Listo.

Estos roles son necesarios para lo siguiente: - Administrador de objetos de Storage: Escribe registros en el bucket de GCS y administra archivos de estado - Invocador de Cloud Run: Permite que Pub/Sub invoque la función - Invocador de Cloud Functions: Permite la invocación de funciones

Otorga permisos de IAM en el bucket de GCS

Otorga permisos de escritura a la cuenta de servicio en el bucket de GCS:

  1. Ve a Cloud Storage > Buckets.
  2. Haz clic en el nombre de tu bucket (por ejemplo, mandiant-ioc-logs).
  3. Ve a la pestaña Permisos.
  4. Haz clic en Otorgar acceso.
  5. Proporciona los siguientes detalles de configuración:
    • Agregar entidades: Ingresa el correo electrónico de la cuenta de servicio (por ejemplo, mandiant-ioc-collector-sa@PROJECT_ID.iam.gserviceaccount.com).
    • Asignar roles: Selecciona Administrador de objetos de almacenamiento.
  6. Haz clic en Guardar.

Crea un tema de Pub/Sub

Crea un tema de Pub/Sub en el que Cloud Scheduler publicará y al que se suscribirá la función de Cloud Run.

  1. En Google Cloud Console, ve a Pub/Sub > Temas.
  2. Haz clic en Crear tema.
  3. Proporciona los siguientes detalles de configuración:
    • ID del tema: Ingresa mandiant-ioc-trigger (por ejemplo, mandiant-ioc-trigger).
    • Deja el resto de la configuración con sus valores predeterminados.
  4. Haz clic en Crear.

Crea una función de Cloud Run para recopilar registros

La función de Cloud Run se activará con mensajes de Pub/Sub de Cloud Scheduler para recuperar datos de IOC de la API de Mandiant Threat Intelligence y escribirlos en GCS.

  1. En Google Cloud Console, ve a Cloud Run.
  2. Haz clic en Crear servicio.
  3. Selecciona Función (usa un editor intercalado para crear una función).

  4. En la sección Configurar, proporciona los siguientes detalles de configuración:

    Parámetro de configuración Valor
    Nombre del servicio mandiant-ioc-collector (por ejemplo, mandiant-ioc-collector)
    Región Selecciona la región que coincida con tu bucket de GCS (por ejemplo, us-central1).
    Tiempo de ejecución Selecciona Python 3.12 o una versión posterior.

  5. En la sección Activador (opcional), haz lo siguiente:

    1. Haz clic en + Agregar activador.
    2. Selecciona Cloud Pub/Sub.
    3. En Selecciona un tema de Cloud Pub/Sub, elige el tema de Pub/Sub (por ejemplo, mandiant-ioc-trigger).
    4. Haz clic en Guardar.

  6. En la sección Autenticación, haz lo siguiente:

    1. Selecciona Necesita autenticación.
    2. Verifica Identity and Access Management (IAM).
  1. Desplázate hacia abajo y expande Contenedores, redes y seguridad.
  2. Ve a la pestaña Seguridad:
    • Cuenta de servicio: Selecciona la cuenta de servicio (por ejemplo, mandiant-ioc-collector-sa).

  3. Ve a la pestaña Contenedores:

    1. Haz clic en Variables y secretos.
    2. Haz clic en + Agregar variable para cada variable de entorno:
    Nombre de la variable Valor de ejemplo Descripción
    GCS_BUCKET mandiant-ioc-logs Nombre del bucket de GCS
    GCS_PREFIX mandiant-ioc Prefijo para los archivos de registro
    STATE_KEY mandiant-ioc/state.json Ruta de acceso al archivo de estado
    API_BASE https://api.intelligence.mandiant.com URL base de la API
    API_KEY_ID your-key-id ID de la clave de API de Mandiant
    API_SECRET your-key-secret Secreto de la API de Mandiant
    MAX_RECORDS 1000 Cantidad máxima de registros por ejecución
    PAGE_SIZE 100 Registros por página
    LOOKBACK_HOURS 24 Período de visualización inicial

  4. En la sección Variables y Secrets, desplázate hacia abajo hasta Solicitudes:

    • Tiempo de espera de la solicitud: Ingresa 600 segundos (10 minutos).

  5. Ve a la pestaña Configuración:

    • En la sección Recursos, haz lo siguiente:
      • Memoria: Selecciona 512 MiB o más.
      • CPU: Selecciona 1.

  6. En la sección Escalamiento de revisión, haz lo siguiente:

    • Cantidad mínima de instancias: Ingresa 0.
    • Cantidad máxima de instancias: Ingresa 100 (o ajusta según la carga esperada).

  7. Haz clic en Crear.

  8. Espera a que se cree el servicio (de 1 a 2 minutos).

  9. Después de crear el servicio, se abrirá automáticamente el editor de código intercalado.

Agregar el código de función

  1. Ingresa main en el campo Punto de entrada.

  2. En el editor de código intercalado, crea dos archivos:

    • main.py:

      import functions_framework
from google.cloud import storage
import json
import os
import urllib3
from datetime import datetime, timezone, timedelta
import time
import base64

# Initialize HTTP client with timeouts
http = urllib3.PoolManager(
    timeout=urllib3.Timeout(connect=5.0, read=30.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', 'mandiant-ioc')
STATE_KEY = os.environ.get('STATE_KEY', 'mandiant-ioc/state.json')
API_BASE = os.environ.get('API_BASE', 'https://api.intelligence.mandiant.com')
API_KEY_ID = os.environ.get('API_KEY_ID')
API_SECRET = os.environ.get('API_SECRET')
MAX_RECORDS = int(os.environ.get('MAX_RECORDS', '1000'))
PAGE_SIZE = int(os.environ.get('PAGE_SIZE', '100'))
LOOKBACK_HOURS = int(os.environ.get('LOOKBACK_HOURS', '24'))

def to_unix_seconds(dt: datetime) -> int:
    """Convert datetime to Unix epoch seconds."""
    if dt.tzinfo is None:
        dt = dt.replace(tzinfo=timezone.utc)
    dt = dt.astimezone(timezone.utc)
    return int(dt.timestamp())

def parse_datetime(value: str) -> datetime:
    """Parse ISO datetime string to datetime object."""
    if value.endswith("Z"):
        value = value[:-1] + "+00:00"
    return datetime.fromisoformat(value)

@functions_framework.cloud_event
def main(cloud_event):
    """
    Cloud Run function triggered by Pub/Sub to fetch Mandiant IOC data and write to GCS.

    Args:
        cloud_event: CloudEvent object containing Pub/Sub message
    """

    if not all([GCS_BUCKET, API_BASE, API_KEY_ID, API_SECRET]):
        print('Error: Missing required environment variables')
        return

    try:
        # Get GCS bucket
        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 any delayed events
                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 IOCs from {last_time.isoformat()} to {now.isoformat()}")

        # Convert to Unix timestamps
        start_epoch = to_unix_seconds(last_time)
        end_epoch = to_unix_seconds(now)

        # Fetch IOCs
        records, newest_event_time = fetch_iocs(
            api_base=API_BASE,
            api_key_id=API_KEY_ID,
            api_secret=API_SECRET,
            start_epoch=start_epoch,
            end_epoch=end_epoch,
            page_size=PAGE_SIZE,
            max_records=MAX_RECORDS,
        )

        if not records:
            print("No new IOC 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}/iocs_{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 gs://{GCS_BUCKET}/{object_key}")

        # Update state with newest event time
        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 IOCs: {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: str):
    """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 get_oauth_token(api_base: str, api_key_id: str, api_secret: str) -> str:
    """Get OAuth 2.0 access token from Mandiant API."""
    token_url = f"{api_base}/token"

    # Create Basic Auth header
    auth_string = f"{api_key_id}:{api_secret}"
    auth_bytes = auth_string.encode('utf-8')
    auth_b64 = base64.b64encode(auth_bytes).decode('utf-8')

    headers = {
        'Authorization': f'Basic {auth_b64}',
        'Content-Type': 'application/x-www-form-urlencoded',
        'Accept': 'application/json'
    }

    body = 'grant_type=client_credentials'

    try:
        response = http.request('POST', token_url, body=body, headers=headers)

        if response.status != 200:
            print(f"Token request failed: {response.status}")
            print(f"Response: {response.data.decode('utf-8')}")
            raise Exception(f"Failed to get OAuth token: HTTP {response.status}")

        token_data = json.loads(response.data.decode('utf-8'))
        return token_data['access_token']

    except Exception as e:
        print(f"Error getting OAuth token: {e}")
        raise

def fetch_iocs(api_base: str, api_key_id: str, api_secret: str, start_epoch: int, end_epoch: int, page_size: int, max_records: int):
    """
    Fetch IOCs from Mandiant Threat Intelligence API with pagination and rate limiting.

    Args:
        api_base: API base URL
        api_key_id: Mandiant API Key ID
        api_secret: Mandiant API Secret
        start_epoch: Start time in Unix epoch seconds
        end_epoch: End time in Unix epoch seconds
        page_size: Number of records per page
        max_records: Maximum total records to fetch

    Returns:
        Tuple of (records list, newest_event_time ISO string)
    """
    # Get OAuth token
    access_token = get_oauth_token(api_base, api_key_id, api_secret)

    endpoint = f"{api_base}/v4/indicator"

    headers = {
        'Authorization': f'Bearer {access_token}',
        'Accept': 'application/json',
        'Content-Type': 'application/json',
        'User-Agent': 'GoogleSecOps-MandiantCollector/1.0'
    }

    records = []
    newest_time = None
    page_num = 0
    backoff = 1.0
    next_url = None

    while True:
        page_num += 1

        if len(records) >= max_records:
            print(f"Reached max_records limit ({max_records})")
            break

        # Build request URL
        if next_url:
            # Use next URL from pagination
            url = next_url
        else:
            # First request with time filtering
            params = []
            params.append(f"start_epoch={start_epoch}")
            params.append(f"end_epoch={end_epoch}")
            params.append(f"limit={min(page_size, max_records - len(records))}")
            url = f"{endpoint}?{'&'.join(params)}"

        try:
            response = http.request('GET', url, 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). Retrying after {retry_after}s...")
                time.sleep(retry_after)
                backoff = min(backoff * 2, 30.0)
                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 [], None

            data = json.loads(response.data.decode('utf-8'))

            # Extract results
            page_results = data.get('indicators', [])

            if not page_results:
                print(f"No more results (empty page)")
                break

            print(f"Page {page_num}: Retrieved {len(page_results)} IOCs")
            records.extend(page_results)

            # Track newest event time
            for ioc in page_results:
                try:
                    # Extract last_updated timestamp
                    event_time = ioc.get('last_updated')
                    if event_time:
                        if newest_time is None or parse_datetime(event_time) > parse_datetime(newest_time):
                            newest_time = event_time
                except Exception as e:
                    print(f"Warning: Could not parse event time: {e}")

            # Check for next page
            next_url = data.get('next')
            if not next_url:
                print("No more pages (no next URL)")
                break

        except Exception as e:
            print(f"Error fetching IOCs: {e}")
            return [], None

    print(f"Retrieved {len(records)} total records from {page_num} pages")
    return records, newest_time

    • requirements.txt:

      functions-framework==3.*
google-cloud-storage==2.*
urllib3>=2.0.0

  3. Haz clic en Implementar para guardar y, luego, implementar la función.

  4. Espera a que se complete la implementación (de 2 a 3 minutos).

Crea un trabajo de Cloud Scheduler

Cloud Scheduler publicará mensajes en el tema de Pub/Sub a intervalos regulares, lo que activará la función de Cloud Run.

  1. En Google Cloud Console, ve a Cloud Scheduler.
  2. Haz clic en Crear trabajo.

  3. Proporciona los siguientes detalles de configuración:

    Parámetro de configuración Valor
    Nombre mandiant-ioc-collector-hourly (por ejemplo, mandiant-ioc-collector-hourly)
    Región Selecciona la misma región que la función de Cloud Run
    Frecuencia 0 * * * * (cada hora, en punto)
    Zona horaria Selecciona la zona horaria (se recomienda UTC)
    Tipo de objetivo Pub/Sub
    Tema Selecciona el tema de Pub/Sub (por ejemplo, mandiant-ioc-trigger).
    Cuerpo del mensaje {} (objeto JSON vacío)

  4. Haz clic en Crear.

Opciones de frecuencia de programación

  • Elige la frecuencia según el volumen de actualizaciones de los IOC y los requisitos de latencia:

    Frecuencia Expresión cron Caso de uso
    Cada 5 minutos */5 * * * * Alto volumen y baja latencia
    Cada 15 minutos */15 * * * * Volumen medio
    Cada 1 hora 0 * * * * Estándar (recomendado)
    Cada 6 horas 0 */6 * * * Procesamiento por lotes y volumen bajo
    Diario 0 0 * * * Recopilación de datos históricos

Prueba la integración

  1. En la consola de Cloud Scheduler, busca tu trabajo (por ejemplo, mandiant-ioc-collector-hourly).
  2. Haz clic en Ejecutar forzosamente para activar el trabajo de forma manual.
  3. Espera unos segundos.
  4. Ve a Cloud Run > Servicios.
  5. Haz clic en el nombre de tu función (por ejemplo, mandiant-ioc-collector).
  6. Haz clic en la pestaña Registros.

  7. Verifica que la función se haya ejecutado correctamente. Busca lo siguiente:

    Fetching IOCs from YYYY-MM-DDTHH:MM:SS+00:00 to YYYY-MM-DDTHH:MM:SS+00:00
Page 1: Retrieved X IOCs
Wrote X records to gs://bucket-name/mandiant-ioc/iocs_YYYYMMDD_HHMMSS.ndjson
Successfully processed X records

  8. Ve a Cloud Storage > Buckets.

  9. Haz clic en el nombre de tu bucket (por ejemplo, mandiant-ioc-logs).

  10. Navega a la carpeta de prefijo (por ejemplo, mandiant-ioc/).

  11. Verifica que se haya creado un archivo .ndjson nuevo con la marca de tiempo actual.

Si ves errores en los registros, haz lo siguiente:

  • HTTP 401: Verifica el ID y el secreto de la clave de API en las variables de entorno
  • HTTP 403: Verifica que la cuenta tenga permisos de Threat Intelligence
  • HTTP 429: Limitación de frecuencia. La función volverá a intentarlo automáticamente con una espera exponencial.
  • Faltan variables de entorno: Verifica que estén configuradas todas las variables requeridas.
  • Falló la solicitud de token: Verifica que las credenciales de la API sean correctas y no hayan vencido.

Recupera la cuenta de servicio de Google SecOps

Google SecOps usa una cuenta de servicio única para leer datos de tu bucket de GCS. Debes otorgar acceso a tu bucket a esta cuenta de servicio.

Obtén el correo electrónico de la cuenta de servicio

  1. Ve a Configuración de SIEM > Feeds.
  2. Haz clic en Agregar feed nuevo.
  3. Haz clic en Configura un feed único.
  4. En el campo Nombre del feed, ingresa un nombre para el feed (por ejemplo, Mandiant Custom IOC).
  5. Selecciona Google Cloud Storage V2 como el Tipo de fuente.
  6. Selecciona Mandiant Custom IOC como el Tipo de registro.

  7. Haz clic en Obtener cuenta de servicio. Se mostrará un correo electrónico único de la cuenta de servicio, por ejemplo:

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com

  8. Copia esta dirección de correo electrónico para usarla en el siguiente paso.

  9. Haz clic en Siguiente.

  10. Especifica valores para los siguientes parámetros de entrada:

    • URL del bucket de almacenamiento: Ingresa el URI del bucket de GCS con la ruta de acceso del prefijo:

      gs://mandiant-ioc-logs/mandiant-ioc/
      • Reemplaza:
        • mandiant-ioc-logs: Es el nombre de tu bucket de GCS.
        • mandiant-ioc: Es la ruta de acceso al prefijo o la carpeta en la que se almacenan los registros de IOC.

    • Opción de eliminación del código fuente: Selecciona la opción de eliminación según tu preferencia:

      • Nunca: Nunca borra ningún archivo después de las transferencias (se recomienda para las pruebas).
      • Borrar archivos transferidos: Borra los archivos después de que se transfirieron correctamente.

      • Borrar los archivos transferidos y los directorios vacíos: Borra los archivos y los directorios vacíos después de que se transfirieron correctamente.

    • Antigüedad máxima del archivo: Incluye los archivos modificados en la cantidad de días más reciente (el valor predeterminado es de 180 días).

    • Espacio de nombres del recurso: Es el espacio de nombres del recurso.

    • Etiquetas de transferencia: Es la etiqueta que se aplicará a los eventos de este feed.

  11. Haz clic en Siguiente.

  12. Revisa la nueva configuración del feed en la pantalla Finalizar y, luego, haz clic en Enviar.

Otorga permisos de IAM a la cuenta de servicio de Google SecOps

La cuenta de servicio de Google SecOps necesita el rol de visualizador de objetos de Storage en tu bucket de GCS.

  1. Ve a Cloud Storage > Buckets.
  2. Haz clic en el nombre de tu bucket (por ejemplo, mandiant-ioc-logs).
  3. Ve a la pestaña Permisos.
  4. Haz clic en Otorgar acceso.
  5. Proporciona los siguientes detalles de configuración:
    • Agregar entidades: Pega el correo electrónico de la cuenta de servicio de Google SecOps.
    • Asignar roles: Selecciona Visualizador de objetos de Storage.
  6. Haz clic en Guardar.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
associated_hashes.value entity.file.md5 Valor de associated_hashes.value si hash.type == "md5"; de lo contrario, valor si type == "md5"
valor entity.file.md5
associated_hashes.value entity.file.sha1 Valor de associated_hashes.value si hash.type == "sha1", de lo contrario, de value si type == "sha1"
valor entity.file.sha1
associated_hashes.value entity.file.sha256 Valor de associated_hashes.value si hash.type == "sha256"; de lo contrario, valor si type == "sha256"
valor entity.file.sha256
valor entity.hostname El valor se copia directamente si type == "fqdn".
valor entity.ip El valor se copia directamente si type == "ipv4".
threat_rating.threat_score entity.labels Objetos de etiqueta combinados con la clave "threat_score" y el valor de threat_rating.threat_score, la clave "mscore" y el valor de mscore, la clave "is_exclusive" y el valor de is_exclusive, la clave "is_publishable" y el valor de ispublishable, y, para cada campo de MISP, la clave "misp" y el valor de misp.
mscore entity.labels
is_exclusive entity.labels
is_publishable entity.labels
misp.akamai entity.labels
misp.alexa entity.labels
misp.alexa_1M entity.labels
misp.amazon-aws entity.labels
misp.apple entity.labels
misp.automated-malware-analysis entity.labels
misp.bank-website entity.labels
misp.captive-portals entity.labels
misp.censys-scanning entity.labels
misp.cisco_1M entity.labels
misp.cisco_top1000 entity.labels
misp.cisco_top10k entity.labels
misp.cisco_top20k entity.labels
misp.cisco_top5k entity.labels
misp.cloudflare entity.labels
misp.common-contact-emails entity.labels
misp.common-ioc-false-positive entity.labels
misp.covid entity.labels
misp.covid-19-cyber-threat-coalition-whitelist entity.labels
misp.covid-19-krassi-whitelist entity.labels
misp.crl-hostname entity.labels
misp.crl-ip entity.labels
misp.dax30 entity.labels
misp.digitalside entity.labels
misp.disposable-email entity.labels
misp.dynamic-dns entity.labels
misp.eicar.com entity.labels
misp.empty-hashes entity.labels
misp.fastly entity.labels
misp.findip-host entity.labels
misp.google entity.labels
misp.google-chrome-crux-1million entity.labels
misp.google-gcp entity.labels
misp.google-gmail-sending-ips entity.labels
misp.googlebot entity.labels
misp.ipv6-linklocal entity.labels
misp.majestic_million entity.labels
misp.majestic_million_1M entity.labels
misp.microsoft entity.labels
misp.microsoft-attack-simulator entity.labels
misp.microsoft-azure entity.labels
misp.microsoft-azure-appid entity.labels
misp.microsoft-azure-china entity.labels
misp.microsoft-azure-germany entity.labels
misp.microsoft-azure-us-gov entity.labels
misp.microsoft-office365 entity.labels
misp.microsoft-office365-cn entity.labels
misp.microsoft-office365-ip entity.labels
misp.microsoft-win10-connection-endpoints entity.labels
misp.moz-top500 entity.labels
misp.mozilla-CA entity.labels
misp.mozilla-IntermediateCA entity.labels
misp.multicast entity.labels
misp.nioc-filehash entity.labels
misp.openai-gptbot entity.labels
misp.ovh-cluster entity.labels
misp.parking-domain entity.labels
misp.parking-domain-ns entity.labels
misp.phone_numbers entity.labels
misp.public-dns-hostname entity.labels
misp.public-dns-v4 entity.labels
misp.public-dns-v6 entity.labels
misp.public-ipfs-gateways entity.labels
misp.rfc1918 entity.labels
misp.rfc3849 entity.labels
misp.rfc5735 entity.labels
misp.rfc6598 entity.labels
misp.rfc6761 entity.labels
misp.second-level-tlds entity.labels
misp.security-provider-blogpost entity.labels
misp.sinkholes entity.labels
misp.smtp-receiving-ips entity.labels
misp.smtp-sending-ips entity.labels
misp.stackpath entity.labels
misp.tenable-cloud-ipv4 entity.labels
misp.tenable-cloud-ipv6 entity.labels
misp.ti-falsepositives entity.labels
misp.tlds entity.labels
misp.tranco entity.labels
misp.tranco10k entity.labels
misp.umbrella-blockpage-hostname entity.labels
misp.umbrella-blockpage-v4 entity.labels
misp.umbrella-blockpage-v6 entity.labels
misp.university_domains entity.labels
misp.url-shortener entity.labels
misp.vpn-ipv4 entity.labels
misp.vpn-ipv6 entity.labels
misp.whats-my-ip entity.labels
misp.wikimedia entity.labels
misp.zscaler entity.labels
valor entity.url El valor se copia directamente si type == "url".
last_seen event.ioc.active_timerange.end Fecha analizada a partir de last_seen con ISO8601
first_seen event.ioc.active_timerange.start Fecha analizada a partir de first_seen con ISO8601
sources.0.category event.ioc.categorization Se unió desde el array sources.0.category con un separador de comas.
threat_rating.threat_score event.ioc.confidence_score Valor copiado directamente
valor event.ioc.domain_and_ports.domain El valor se copia directamente si type == "fqdn".
event.ioc.feed_name event.ioc.feed_name Se establece en "Mandiant".
valor event.ioc.ip_and_ports.ip_address Se convierte en ipaddress si type == "ipv4"
tipo metadata.entity_type Se establece en FILE si associated_hashes.type está en md5 sha1 sha256; de lo contrario, se establece en DOMAIN_NAME si type == "fqdn", IP_ADDRESS si type == "ipv4", URL si type == "url", FILE si type está en md5 sha1 sha256 o UNKNOWN_ENTITYTYPE en cualquier otro caso.
associated_hashes.type metadata.entity_type
custom_ioc_expire_date metadata.interval.end_time Fecha analizada a partir de custom_ioc_expire_date con ISO8601 si el tipo está en la URL de IPv4 del FQDN
first_seen metadata.interval.start_time Fecha analizada a partir de first_seen con ISO8601 o UNIX
id metadata.product_entity_id Valor copiado directamente
threat_det metadata.threat Se combinó desde threat_det
attributed_associations threat_det.associations Objetos threat_association combinados de attributed_associations y associations, con campos establecidos a partir de association.id, name, type, region_code.country_or_region, associated_actors, alias, role, first_reference_time, last_reference_time, industries_affected
asociaciones threat_det.associations
Campañas threat_det.campaigns Es el nombre de la campaña combinado del array de campañas.
categoría threat_det.category_details Se fusionó del array de categorías
threat_rating.confidence_level threat_det.confidence Se establece en LOW_CONFIDENCE si la coincidencia es baja, en MEDIUM_CONFIDENCE si es media, en HIGH_CONFIDENCE si es alta y, de lo contrario, en UNKNOWN_CONFIDENCE.
threat_rating.confidence_score threat_det.confidence_details Valor de threat_rating.confidence_score convertido en cadena o de mscore si threat_rating.confidence_score está vacío
mscore threat_det.confidence_details
first_seen threat_det.first_discovered_time Fecha de first_seen si no está vacío; de lo contrario, de firstSeen, con ISO8601 o UNIX
firstSeen threat_det.first_discovered_time
first_seen threat_det.last_updated_time Fecha analizada a partir de first_seen con ISO8601 o UNIX
threat_rating.threat_score threat_det.risk_score Se convierte en un número de punto flotante a partir de threat_rating.threat_score si no está vacío; de lo contrario, se convierte a partir de mscore.
mscore threat_det.risk_score
threat_rating.severity_level threat_det.severity Se establece en LOW si es baja, en MEDIUM si es media, en HIGH si es alta y en UNKNOWN_SEVERITY si no se conoce.
threat_det.threat_feed_name threat_det.threat_feed_name Se establece en "Mandiant".
valor threat_det.url_back_to_product Se establece en "https://advantage.mandiant.com/search?query=%{value}" si se escribe en fqdn ipv4 url md5
verdict_simple.timestamp threat_det.verdict_info Se fusionó de verdict_info_simple después de establecer verdict_time a partir de la marca de tiempo, verdict_response a partir del veredicto si es malicioso y verdict_type a partir de verdict_source.
verdict_simple.verdict threat_det.verdict_info
verdict_simple.verdict_source threat_det.verdict_info
metadata.product_name metadata.product_name Se debe establecer en "MANDIANT_CUSTOM_IOC".
metadata.vendor_name metadata.vendor_name Se debe establecer en "MANDIANT_CUSTOM_IOC".
threat.threat_feed_name Mandiant Se asignó desde el registro de cambios
threat_rating.threat_score entity.entity.labels Se asignó desde el registro de cambios
threat_rating.severity_level threat.severity Se asignó desde el registro de cambios
threat_rating.confidence_level threat.confidence Se asignó desde el registro de cambios
verdict_simple.timestamp verdict_info.verdict_time Se asignó desde el registro de cambios
category threat.category_details Se asignó desde el registro de cambios
threat_rating.confidence_score threat.confidence_details Se asignó desde el registro de cambios
threat_rating.threat_score threat.risk_score Se asignó desde el registro de cambios

Registro de cambios

Consulta el registro de cambios de este analizador

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.