Recopila registros de auditoría de Slack

Compatible con:

En este documento, se explica cómo transferir registros de auditoría de Slack a Google Security Operations con funciones de Google Cloud Run o Amazon S3 con AWS Lambda.

Los registros de auditoría de Slack proporcionan un registro detallado de los eventos relacionados con la seguridad en toda tu organización de Slack Enterprise Grid. La API de Registros de auditoría te permite supervisar las acciones de los usuarios, como los accesos, las descargas de archivos, las instalaciones de apps y los cambios administrativos, con fines de supervisión de seguridad y cumplimiento.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Una instancia de Google SecOps
  • Un plan de Slack Enterprise Grid con acceso de propietario de la organización

  • Acceso con privilegios a cualquiera de las siguientes opciones:

    • Google Cloud (para la opción 1: Cloud Run Functions y Cloud Scheduler) o
    • AWS (para la opción 2: S3, IAM, Lambda y EventBridge)

Recopila las credenciales de Slack

Crea la app de Slack

La API de registros de auditoría de Slack requiere un token de OAuth de usuario con el permiso auditlogs:read. Este token se debe obtener instalando una app a nivel de la organización de Enterprise Grid, no a nivel del espacio de trabajo.

  1. Accede a Slack como propietario de tu organización de Enterprise Grid.
  2. Ve a la página de apps de la API de Slack.
  3. Haz clic en Crear app nueva.
  4. Selecciona Desde cero.
  5. Proporciona los siguientes detalles de configuración:
    • Nombre de la app: Ingresa un nombre descriptivo (por ejemplo, Google SecOps Audit Integration).
    • Pick a workspace to develop your app in: Selecciona tu espacio de trabajo de desarrollo de Slack (cualquier espacio de trabajo de la organización).
  6. Haz clic en Crear app.

Configura los permisos de OAuth

  1. En la página de configuración de la app, selecciona OAuth & Permissions en el panel de navegación de la izquierda.
  2. Navega a la sección Scopes.
  3. En User Token Scopes (NO en Bot Token Scopes), haz clic en Add an OAuth Scope.
  4. Agrega el siguiente permiso:
    • auditlogs:read: Este permiso habilita el acceso a la API de registros de auditoría para la organización de Enterprise Grid.
  5. En Bot Token Scopes, haz clic en Add an OAuth Scope.
  6. Agrega el siguiente permiso:
    • users:read: Está presente para que la app se pueda instalar a nivel de la organización.

Instala la app en la organización de Enterprise

La API de Audit Logs lee los eventos de toda la organización de Enterprise, por lo que la app debe instalarse a nivel de la organización, en lugar de en un solo espacio de trabajo. Slack documenta dos maneras de hacerlo. Ambos producen el mismo token de OAuth de usuario a nivel de la organización. Usa uno de ellos.

Opción A: Instala la app desde su configuración (app a nivel de la organización)

Esta es la ruta de acceso de la página Developing apps for Enterprise orgs de Slack. No necesita una URL de redireccionamiento, distribución pública ni servicio web.

  1. En la página de configuración de tu app, selecciona Apps a nivel de la organización en el panel de navegación de la izquierda.
  2. Haz clic en Habilitar.
  3. En el mensaje de confirmación, haz clic en Sí, habilitar.

  4. Accede como el propietario de la organización de Enterprise.

  5. Selecciona OAuth y permisos en el panel de navegación de la izquierda.

  6. Haz clic en Install to Organization.

  7. Revisa los permisos solicitados en la pantalla de confirmación y haz clic en Permitir.

Opción B: Distribución pública y URL para compartir

Esta es la ruta de acceso de la página de la API de registros de auditoría de Slack. Activar la distribución pública no incluye la app en el Marketplace de Slack, solo permite la instalación fuera del espacio de trabajo de desarrollo.

  1. En la página de configuración de la app, selecciona OAuth & Permissions en el panel de navegación de la izquierda.
  2. En la sección URLs de redireccionamiento, haz clic en Agregar nueva URL de redireccionamiento, ingresa una URL, haz clic en Agregar y, luego, en Guardar URLs.

  3. Selecciona Administrar distribución en el panel de navegación de la izquierda.

  4. En Comparte tu app con otros espacios de trabajo, confirma que las cuatro secciones de la lista de tareas muestren una marca de verificación verde. Si una sección muestra una X roja, expándela y completa la acción requerida.

  5. Selecciona la casilla de verificación Revisé y quité toda la información hard-coded.

  6. Haz clic en Activar distribución pública.

  7. Accede como propietario de la organización de Enterprise.

  8. En Comparte tu app con tu espacio de trabajo, copia la URL para compartir y ábrela en tu navegador.

  9. En la pantalla de instalación, abre el menú desplegable de la esquina superior derecha y selecciona la organización empresarial, no un espacio de trabajo individual.

  10. Revisa los permisos solicitados y haz clic en Permitir.

Recupera credenciales

  1. Una vez que se complete la instalación, volverás a la página OAuth & Permissions.
  2. En la sección Tokens de OAuth, busca el Token de OAuth del usuario.
  3. El token comienza con xoxp-.
  4. Haz clic en Copiar y guarda este token de forma segura.

    Importante: Este es tu SLACK_ADMIN_TOKEN para la función de Cloud Run o Lambda. Guárdalo de forma segura. Proporciona acceso de lectura a todos los registros de auditoría de tu organización de Enterprise Grid.

  5. Anota el ID de organización:

    1. Abre Slack en un navegador web con la URL de tu organización (por ejemplo, acmeinc.enterprise.slack.com).
    2. Después de que se cargue la página, lee la URL. Tiene el formato https://app.slack.com/client/EXXXXXXX/CXXXXXXX.
    3. Copia la cadena que comienza con E. Ese es el ID de tu organización.

Verifica los permisos

Para verificar que tu app tenga los permisos necesarios, sigue estos pasos:

  1. Ve a la página de apps de la API de Slack.
  2. Selecciona tu app.
  3. Selecciona OAuth y permisos en el panel de navegación de la izquierda.
  4. En Tokens de OAuth, verifica que se muestre un token de OAuth de usuario (comienza con xoxp-).
  5. En Permisos, verifica que auditlogs:read aparezca en Permisos de tokens de usuario.

Prueba el acceso a la API

  • Prueba tu token antes de continuar con la integración:

    SLACK_TOKEN="xoxp-your-token-here"
    
    curl -H "Authorization: Bearer $SLACK_TOKEN" \
      "https://api.slack.com/audit/v1/logs?limit=1"
    

Una respuesta correcta contiene un array entries con eventos de registro de auditoría. Si recibes un error invalid_auth o missing_scope, verifica tu token y los permisos.

Opción 1: Configura la exportación de registros de auditoría de Slack con Google Cloud Run Functions

Esta opción usa Google Cloud Run Functions y Cloud Scheduler para recopilar los registros de auditoría de Slack y transferirlos directamente a Google SecOps con las secuencias de comandos de transferencia de Google SecOps.

Antes de comenzar (opción 1)

Asegúrate de cumplir con los siguientes requisitos previos adicionales:

  • Un proyecto de Google Cloud con las siguientes APIs habilitadas:
    • API de Cloud Run Admin
    • API de Eventarc
    • API de Pub/Sub
    • API de Cloud Scheduler
    • API de Secret Manager
  • Permisos para crear funciones de Cloud Run, temas de Pub/Sub, activadores de Eventarc, trabajos de Cloud Scheduler y secretos en Secret Manager
  • Un archivo JSON de cuenta de servicio de Google SecOps.

Obtén la cuenta de servicio de Google SecOps

  1. Accede a la consola de Google SecOps.
  2. Ve a Configuración > Administración de datos > Agentes de recopilación. Si estás en una plataforma solo de SIEM, ve a Configuración > Agentes de recopilación.
  3. Haz clic en Descargar para descargar el archivo de autenticación de transferencia.
  4. Guarda el archivo JSON de forma segura. Subirás este archivo como un secreto en Google Secret Manager.

Prepara el código de la función

Descarga los archivos de implementación del repositorio de GitHub de secuencias de comandos de transferencia de Google SecOps:

  1. Desde la carpeta slack, descarga lo siguiente:
    • .env.yml
    • main.py
    • requirements.txt
  2. Desde la raíz del repositorio, descarga todo el directorio common con todos sus archivos.

    Tu directorio de implementación debe tener la siguiente estructura:

        ```
        deployment_directory/
        ├── common/
        │   ├── __init__.py
        │   ├── auth.py
        │   ├── env_constants.py
        │   ├── ingest.py
        │   ├── status.py
        │   └── utils.py
        ├── .env.yml
        ├── main.py
        └── requirements.txt
        ```
    

Configura secretos en Google Secret Manager

Almacenar credenciales sensibles en Secret Manager para que la función de Cloud Run acceda a ellas de forma segura

Crea un Secret para la cuenta de servicio de Google SecOps

  1. En la consola deGoogle Cloud , ve a Seguridad > Secret Manager.
  2. Haz clic en Crear secreto.
  3. Proporciona los siguientes detalles de configuración:
    • Nombre: Ingresa chronicle-service-account.
    • Valor del secreto: Pega todo el contenido del archivo JSON de la cuenta de servicio de Google SecOps.
  4. Haz clic en Crear secreto.
  5. Copia el nombre del recurso del Secret. El formato es el siguiente:

    projects/PROJECT_ID/secrets/chronicle-service-account/versions/latest
    

Crea un Secret para el token de Slack

  1. En la página de Secret Manager, haz clic en Crear Secret.
  2. Proporciona los siguientes detalles de configuración:
    • Nombre: Ingresa slack-admin-token.
    • Valor del Secret: Pega el token de OAuth del usuario de Slack (comienza con xoxp-).
  3. Haz clic en Crear secreto.
  4. Copia el nombre del recurso del Secret. El formato es el siguiente:

    projects/PROJECT_ID/secrets/slack-admin-token/versions/latest
    

Configure las variables de entorno

  1. Abre el archivo .env.yml en tu directorio de implementación y configura las variables de entorno:

    CHRONICLE_CUSTOMER_ID: "<your-chronicle-customer-id>"
    CHRONICLE_REGION: "us"
    CHRONICLE_SERVICE_ACCOUNT: "projects/<PROJECT_ID>/secrets/chronicle-service-account/versions/latest"
    CHRONICLE_NAMESPACE: ""
    POLL_INTERVAL: "5"
    SLACK_ADMIN_TOKEN: "projects/<PROJECT_ID>/secrets/slack-admin-token/versions/latest"
    
    • Reemplaza lo siguiente:

      • <your-chronicle-customer-id>: Es el ID de cliente de Google SecOps.
      • <PROJECT_ID>: Es el ID del proyecto de Google Cloud .
      • CHRONICLE_REGION: Se establece en tu región de Google SecOps. Valores válidos: us, asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2, southamerica-east1.
      • POLL_INTERVAL: Es el intervalo de frecuencia (en minutos) en el que se ejecuta la función. Esta duración debe ser la misma que el intervalo del trabajo de Cloud Scheduler.
  2. Guarda el archivo .env.yml.

Crea un tema de Pub/Sub

Cloud Scheduler activa la función de Cloud Run a través de un tema de Pub/Sub.

  1. En Google Cloud Console, ve a Pub/Sub > Temas.
  2. Haz clic en Crear un tema.
  3. En el campo ID del tema, ingresa slack-audit-trigger.
  4. Haz clic en Crear.

Implementa la función de Cloud Run

  1. Abre una terminal o Cloud Shell en la consola de Google Cloud . Navega al directorio de implementación y ejecuta el siguiente comando:

    gcloud run deploy slack-audit-to-chronicle \
      --source . \
      --function main \
      --base-image google-22/python312 \
      --region <REGION> \
      --service-account <SERVICE_ACCOUNT_EMAIL> \
      --env-vars-file .env.yml \
      --memory 512Mi \
      --timeout 540 \
      --max-instances 1 \
      --no-allow-unauthenticated
    
    • Reemplaza <REGION> por la región (por ejemplo, us-central1) y <SERVICE_ACCOUNT_EMAIL> por la dirección de correo electrónico de la cuenta de servicio que deseas que use tu función de Cloud Run.
  2. Crea el activador de Pub/Sub para la función de la siguiente manera:

    gcloud eventarc triggers create slack-audit-trigger \
      --location <REGION> \
      --destination-run-service slack-audit-to-chronicle \
      --destination-run-region <REGION> \
      --event-filters "type=google.cloud.pubsub.topic.v1.messagePublished" \
      --transport-topic projects/<PROJECT_ID>/topics/slack-audit-trigger \
      --service-account <SERVICE_ACCOUNT_EMAIL>
    
    • Reemplaza <PROJECT_ID> por el ID del proyecto de Google Cloud .
  3. Espera a que se complete la implementación.

Configura Cloud Scheduler

  1. En la consola de GCP, ve a Cloud Scheduler > Crear trabajo.
  2. Proporciona los siguientes detalles de configuración:

    Parámetro de configuración Valor
    Nombre slack-audit-scheduler
    Región Selecciona la misma región en la que implementaste la función de Cloud Run.
    Frecuencia */5 * * * * (cada 5 minutos, que coincide con el valor POLL_INTERVAL)
    Zona horaria Selecciona la zona horaria (se recomienda UTC)
  3. Haz clic en Continuar.

  4. En la sección Configura la ejecución, haz lo siguiente:

    • Tipo de destino: Selecciona Pub/Sub.
    • Tema: Selecciona slack-audit-trigger.
    • Cuerpo del mensaje: Ingresa run.
  5. Haz clic en Crear.

Opciones de frecuencia de programación

Elige la frecuencia según el volumen de registros y los requisitos de latencia:

Frecuencia Expresión cron Caso de uso
Cada 5 minutos */5 * * * * Estándar (recomendado)
Cada 15 minutos */15 * * * * Volumen medio
Cada 1 hora 0 * * * * Volumen bajo

Prueba la integración (opción 1)

  1. En la consola de Cloud Scheduler, busca tu trabajo (slack-audit-scheduler).
  2. Haz clic en Forzar ejecución para activar el trabajo de forma manual.
  3. Espera unos segundos.
  4. Ve a Cloud Run.
  5. Haz clic en el nombre del servicio (slack-audit-to-chronicle).
  6. Haz clic en la pestaña Registros.
  7. Verifica que la función se haya ejecutado correctamente. Busca lo siguiente:

    Retrieving the Slack Audit logs since: YYYY-MM-DDTHH:MM:SSZ
    Processing logs...
    Retrieved X audit logs from the API call
    Logs processed successfully.
    

Opción 2: Configura la exportación de registros de auditoría de Slack con AWS S3

Esta opción usa AWS Lambda para recopilar registros de auditoría de Slack y almacenarlos en Amazon S3. Luego, configura un feed de Google SecOps para transferir los registros.

Antes de comenzar (opción 2)

Asegúrate de cumplir con los siguientes requisitos previos adicionales:

  • Una cuenta de AWS con permisos para crear buckets de S3, usuarios, roles y políticas de IAM, funciones de Lambda y reglas de EventBridge.

Crea un bucket de Amazon S3

  1. Crea un bucket de Amazon S3 siguiendo la guía del usuario Crea un bucket.
  2. Guarda el Nombre y la Región del bucket para consultarlos en el futuro (por ejemplo, slack-audit-logs).

Configura la política y los roles de IAM para las cargas de S3

  1. En la consola de AWS, ve a la pestaña IAM > Políticas > Crear política > JSON.
  2. Copia y pega la siguiente política. Reemplaza slack-audit-logs si usaste un nombre de bucket diferente:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Sid": "AllowPutObjects",
          "Effect": "Allow",
          "Action": "s3:PutObject",
          "Resource": "arn:aws:s3:::slack-audit-logs/*"
        },
        {
          "Sid": "AllowGetStateObject",
          "Effect": "Allow",
          "Action": "s3:GetObject",
          "Resource": "arn:aws:s3:::slack-audit-logs/slack-audit-state.json"
        }
      ]
    }
    
  3. Haz clic en Siguiente.

  4. Ingresa el nombre de la política SlackAuditS3Policy.

  5. Haz clic en Crear política.

  6. Ve a IAM > Roles > Create role > AWS service > Lambda.

  7. Adjunta la política SlackAuditS3Policy recién creada.

  8. Asigna el nombre SlackAuditToS3Role al rol y haz clic en Crear rol.

Crea la función de Lambda

  1. En la consola de AWS, ve a Lambda > Functions > Create function.
  2. Haz clic en Crear desde cero.
  3. Proporciona los siguientes detalles de configuración:

    Parámetro de configuración Valor
    Nombre slack_audit_to_s3
    Tiempo de ejecución Python 3.13
    Arquitectura x86_64
    Rol de ejecución SlackAuditToS3Role
  4. Haz clic en Crear función.

  5. Después de crear la función, abre la pestaña Código, borra el stub y pega el siguiente código (slack_audit_to_s3.py).

    #!/usr/bin/env python3
    # Lambda: Pull Slack Audit Logs (Enterprise Grid) to S3 (JSONL format)
    import os, json, time, urllib.parse
    from urllib.request import Request, urlopen
    from urllib.error import HTTPError, URLError
    import boto3
    
    BASE_URL = "https://api.slack.com/audit/v1/logs"
    TOKEN = os.environ["SLACK_AUDIT_TOKEN"]
    BUCKET = os.environ["S3_BUCKET"]
    PREFIX = os.environ.get("S3_PREFIX", "slack/audit/")
    STATE_KEY = os.environ.get("STATE_KEY", "slack-audit-state.json")
    LIMIT = int(os.environ.get("LIMIT", "200"))
    MAX_PAGES = int(os.environ.get("MAX_PAGES", "20"))
    LOOKBACK_SEC = int(os.environ.get("LOOKBACK_SECONDS", "3600"))
    HTTP_TIMEOUT = int(os.environ.get("HTTP_TIMEOUT", "60"))
    HTTP_RETRIES = int(os.environ.get("HTTP_RETRIES", "3"))
    RETRY_AFTER_DEFAULT = int(os.environ.get("RETRY_AFTER_DEFAULT", "2"))
    # Optional server-side filters (comma-separated 'action' values)
    ACTIONS = os.environ.get("ACTIONS", "").strip()
    
    s3 = boto3.client("s3")
    
    def _get_state() -> dict:
        try:
            obj = s3.get_object(Bucket=BUCKET, Key=STATE_KEY)
            st = json.loads(obj["Body"].read() or b"{}")
            return {"cursor": st.get("cursor")}
        except Exception:
            return {"cursor": None}
    
    def _put_state(state: dict) -> None:
        body = json.dumps(state, separators=(",", ":")).encode("utf-8")
        s3.put_object(
            Bucket=BUCKET, Key=STATE_KEY, Body=body, ContentType="application/json"
        )
    
    def _http_get(params: dict) -> dict:
        qs = urllib.parse.urlencode(params, doseq=True)
        url = f"{BASE_URL}?{qs}" if qs else BASE_URL
        req = Request(url, method="GET")
        req.add_header("Authorization", f"Bearer {TOKEN}")
        req.add_header("Accept", "application/json")
        attempt = 0
        while True:
            try:
                with urlopen(req, timeout=HTTP_TIMEOUT) as r:
                    return json.loads(r.read().decode("utf-8"))
            except HTTPError as e:
                # Respect Retry-After on 429/5xx
                if e.code in (429, 500, 502, 503, 504) and attempt < HTTP_RETRIES:
                    retry_after = 0
                    try:
                        retry_after = int(
                            e.headers.get("Retry-After", RETRY_AFTER_DEFAULT)
                        )
                    except Exception:
                        retry_after = RETRY_AFTER_DEFAULT
                    time.sleep(max(1, retry_after))
                    attempt += 1
                    continue
                raise
            except URLError:
                if attempt < HTTP_RETRIES:
                    time.sleep(RETRY_AFTER_DEFAULT)
                    attempt += 1
                    continue
                raise
    
    def _write_page(data: dict, page_idx: int) -> str:
        """Extract entries from Slack API response and write as JSONL."""
        entries = data.get("entries") or []
        if not entries:
            return None
        lines = [json.dumps(entry, separators=(",", ":")) for entry in entries]
        body = "\n".join(lines).encode("utf-8")
        ts = time.strftime("%Y/%m/%d/%H%M%S", time.gmtime())
        key = f"{PREFIX}{ts}-slack-audit-p{page_idx:05d}.json"
        s3.put_object(
            Bucket=BUCKET, Key=key, Body=body, ContentType="application/json"
        )
        return key
    
    def lambda_handler(event=None, context=None):
        state = _get_state()
        cursor = state.get("cursor")
        params = {"limit": LIMIT}
        if ACTIONS:
            params["action"] = [a.strip() for a in ACTIONS.split(",") if a.strip()]
        if cursor:
            params["cursor"] = cursor
        else:
            # First run (or reset): fetch a recent window by time
            params["oldest"] = int(time.time()) - LOOKBACK_SEC
        pages = 0
        total = 0
        last_cursor = None
        while pages < MAX_PAGES:
            data = _http_get(params)
            _write_page(data, pages)
            entries = data.get("entries") or []
            total += len(entries)
            # Cursor for next page
            meta = data.get("response_metadata") or {}
            next_cursor = meta.get("next_cursor") or data.get("next_cursor")
            if next_cursor:
                params = {"limit": LIMIT, "cursor": next_cursor}
                if ACTIONS:
                    params["action"] = [
                        a.strip() for a in ACTIONS.split(",") if a.strip()
                    ]
                last_cursor = next_cursor
                pages += 1
                continue
            break
        if last_cursor:
            _put_state({"cursor": last_cursor})
        return {
            "ok": True,
            "pages": pages + (1 if total or last_cursor else 0),
            "entries": total,
            "cursor": last_cursor,
        }
    
    if __name__ == "__main__":
        print(lambda_handler())
    

Configura las variables de entorno de Lambda

  1. Ve a Configuración > Variables de entorno > Editar > Agregar variable de entorno.
  2. Ingresa las siguientes variables de entorno y reemplaza los valores por los tuyos:

    Clave Valor de ejemplo
    SLACK_AUDIT_TOKEN xoxp-... (token de usuario a nivel de la organización con auditlogs:read)
    S3_BUCKET slack-audit-logs
    S3_PREFIX slack/audit/
    STATE_KEY slack-audit-state.json
    LIMIT 200
    MAX_PAGES 20
    LOOKBACK_SECONDS 3600
    HTTP_TIMEOUT 60
    HTTP_RETRIES 3
    RETRY_AFTER_DEFAULT 2
    ACTIONS (opcional, filtro de acciones separado por comas)
  3. Haz clic en Guardar.

  4. Selecciona la pestaña Configuración. En el panel Configuración general, haz clic en Editar.

  5. Cambia el Tiempo de espera a 5 minutes (300 segundos) y haz clic en Guardar.

Crea un programa de EventBridge

  1. Ve a Amazon EventBridge > Scheduler > Create schedule.
  2. Proporciona los siguientes detalles de configuración:
    • Nombre: Ingresa slack-audit-1h.
    • Programa recurrente: Selecciona Programa basado en la tarifa.
    • Expresión de frecuencia: Ingresa 1 hours.
    • Período flexible: Selecciona Desactivado.
  3. Haz clic en Siguiente.
  4. Selecciona el objetivo:
    • API de destino: Selecciona AWS Lambda Invoke.
    • Función de Lambda: Selecciona slack_audit_to_s3.
  5. Haz clic en Siguiente.
  6. Haz clic en Siguiente (omite la configuración opcional).
  7. Revisa y haz clic en Crear programa.

Crea un usuario de IAM de solo lectura para Google SecOps (opcional)

  1. Ve a AWS Console > IAM > Users > Create user.
  2. Proporciona los siguientes detalles de configuración:
    • Nombre de usuario: Ingresa secops-reader.
    • Tipo de acceso: Selecciona Acceso programático.
  3. Haz clic en Siguiente.
  4. Selecciona Adjuntar políticas directamente.
  5. Haz clic en Crear política. En la pestaña JSON, pega lo siguiente:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": ["s3:GetObject"],
          "Resource": "arn:aws:s3:::slack-audit-logs/*"
        },
        {
          "Effect": "Allow",
          "Action": ["s3:ListBucket"],
          "Resource": "arn:aws:s3:::slack-audit-logs"
        }
      ]
    }
    
  6. Haz clic en Siguiente.

  7. Ingresa el nombre de la política secops-reader-policy.

  8. Haz clic en Crear política.

  9. Regresa a la página de creación de usuarios, actualiza la lista de políticas y selecciona secops-reader-policy.

  10. Haz clic en Siguiente.

  11. Haz clic en Create user.

  12. Selecciona el usuario creado secops-reader.

  13. Ve a Security credentials > Access keys > Create access key.

  14. Selecciona Servicio de terceros.

  15. Haz clic en Siguiente.

  16. Haz clic en Crear clave de acceso.

  17. Haz clic en Descargar archivo .csv para guardar las credenciales.

Configura un feed en Google SecOps para transferir registros de auditoría de Slack

  1. Ve a Configuración > Administración de datos > Feeds. Si estás en una plataforma solo de SIEM, ve a Configuración > 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, Slack Audit Logs).
  5. Selecciona Amazon S3 V2 como el Tipo de fuente.
  6. Selecciona Slack Audit como el Tipo de registro.
  7. Haz clic en Siguiente.
  8. Especifica valores para los siguientes parámetros de entrada:

    • URI de S3: Ingresa el URI del bucket de S3 con la ruta de acceso del prefijo:

      ```
      s3://slack-audit-logs/slack/audit/
      ```
      
      Replace `slack-audit-logs` with your actual S3 bucket name.
      
    • Opción de eliminación del código fuente: Selecciona la opción de eliminación según tu preferencia.

    • Antigüedad máxima del archivo: Incluye los archivos modificados en la última cantidad de días. El valor predeterminado es 180 días.

    • ID de clave de acceso: Es la clave de acceso del usuario con acceso al bucket de S3 (del usuario de Identity and Access Management (IAM) de secops-reader).

    • Clave de acceso secreta: Es la clave secreta del usuario con acceso al bucket de S3 (del usuario de IAM secops-reader).

    • 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.

  9. Haz clic en Siguiente.

  10. Revisa la configuración de tu feed de noticias nuevo en la pantalla Finalizar y, luego, haz clic en Enviar.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
action metadata.product_event_type Se asigna directamente desde el campo action
actor.type principal.labels Asignado directamente con la clave actor.type
actor.user.email principal.user.email_addresses Asignada directamente
actor.user.id principal.user.product_object_id Asignada directamente
actor.user.id principal.user.userid Asignada directamente
actor.user.name principal.user.user_display_name Asignada directamente
actor.user.team principal.user.group_identifiers Asignada directamente
context.ip_address principal.ip Asignada directamente
context.location.domain about.resource.attribute.labels Asignado directamente con la clave context.location.domain
context.location.id about.resource.id Asignada directamente
context.location.name about.resource.name Asignada directamente
context.location.name about.resource.attribute.labels Asignado directamente con la clave context.location.name
context.location.type about.resource.resource_subtype Asignada directamente
context.session_id network.session_id Asignada directamente
context.ua network.http.user_agent Asignada directamente
context.ua network.http.parsed_user_agent Es el usuario-agente analizado que se deriva del campo context.ua.
country principal.location.country_or_region Asignada directamente
date_create metadata.event_timestamp.seconds Marca de tiempo de época convertida en objeto de marca de tiempo
details.inviter.email target.user.email_addresses Asignada directamente
details.inviter.id target.user.product_object_id Asignada directamente
details.inviter.name target.user.user_display_name Asignada directamente
details.inviter.team target.user.group_identifiers Asignada directamente
details.reason security_result.description Asignación directa; si es un array, se concatena con comas
details.type about.resource.attribute.labels Asignado directamente con la clave details.type
details.type security_result.summary Asignada directamente
entity.app.id target.resource.id Asignada directamente
entity.app.name target.resource.name Asignada directamente
entity.channel.id target.resource.id Asignada directamente
entity.channel.name target.resource.name Asignada directamente
entity.channel.privacy target.resource.attribute.labels Asignado directamente con la clave entity.channel.privacy
entity.file.filetype target.resource.attribute.labels Asignado directamente con la clave entity.file.filetype
entity.file.id target.resource.id Asignada directamente
entity.file.name target.resource.name Asignada directamente
entity.file.title target.resource.attribute.labels Asignado directamente con la clave entity.file.title
entity.huddle.date_end about.resource.attribute.labels Asignado directamente con la clave entity.huddle.date_end
entity.huddle.date_start about.resource.attribute.labels Asignado directamente con la clave entity.huddle.date_start
entity.huddle.id about.resource.attribute.labels Asignado directamente con la clave entity.huddle.id
entity.huddle.participants.0 about.resource.attribute.labels Asignado directamente con la clave entity.huddle.participants.0
entity.huddle.participants.1 about.resource.attribute.labels Asignado directamente con la clave entity.huddle.participants.1
entity.type target.resource.resource_subtype Asignada directamente
entity.user.email target.user.email_addresses Asignada directamente
entity.user.id target.user.product_object_id Asignada directamente
entity.user.name target.user.user_display_name Asignada directamente
entity.user.team target.user.group_identifiers Asignada directamente
entity.workflow.id target.resource.id Asignada directamente
entity.workflow.name target.resource.name Asignada directamente
id metadata.product_log_id Asignada directamente
ip principal.ip Asignada directamente
user_agent network.http.user_agent Asignada directamente
user_id principal.user.product_object_id Asignada directamente
username principal.user.product_object_id Asignada directamente
metadata.event_type El valor predeterminado es USER_COMMUNICATION; se establece en USER_CREATION si la acción es user_created, USER_LOGIN si la acción es user_login o user_login_failed, USER_LOGOUT si la acción es user_logout, USER_RESOURCE_ACCESS si la acción coincide con file_, USER_RESOURCE_UPDATE_PERMISSIONS si la acción coincide con app_, private_, public_ o auth_policy_, USER_CHANGE_PERMISSIONS si la acción coincide con pref, legal_hold_, workflow_, channel_, user_deactivated, user_reactivated, role_change_ o user_channel_
metadata.log_type Codificado como SLACK_AUDIT
metadata.product_name Se establece en Enterprise Grid si existe date_create; de lo contrario, se establece en Audit Logs si existe user_id
metadata.vendor_name Codificado como Slack
extensions.auth.mechanism Codificado como REMOTE
extensions.auth.type Se establece en SSO si la acción contiene user_login o user_logout; de lo contrario, se establece en MACHINE.
security_result.action El valor predeterminado es ALLOW; se establece en BLOCK si la acción es user_login_failed
target.application Se establece en Slack si existe date_create; de lo contrario, se establece en SLACK si existe user_id

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.