Recopila registros de Amazon CloudFront

Versión del analizador: 10.0

Compatible con:

En este documento, se describe cómo puedes recopilar registros de Amazon CloudFront configurando un feed de Google Security Operations.

Para obtener más información, consulta Descripción general de la transferencia de datos a Google Security Operations.

Una etiqueta de transferencia identifica el analizador que normaliza los datos de registro sin procesar en formato UDM estructurado. La información de este documento se aplica al analizador con la etiqueta de transferencia AWS_CLOUDFRONT.

Antes de comenzar

Asegúrate de que se haya creado el bucket de Amazon S3. Para obtener más información, consulta Crea tu primer bucket de S3.

Configura Amazon CloudFront

  1. Accede a la consola de administración de AWS.
  2. Accede a la consola de Amazon S3 y crea el bucket de Amazon S3.
  3. Haz clic en Activado para habilitar el registro.
  4. En el campo Bucket para registros, especifica el nombre del bucket de Amazon S3.
  5. En el campo Prefijo de registro, especifica un prefijo opcional.
  6. Después de que los archivos de registro se almacenen en el bucket de Amazon S3, crea una cola de SQS y adjúntala al bucket de Amazon S3.

Identifica los extremos para la conectividad

Verifica las políticas de usuario de IAM y de claves de KMS requeridas para S3, SQS y KMS.

Según el servicio y la región, identifica los extremos de conectividad consultando la siguiente documentación de AWS:

Cómo configurar feeds

Existen dos puntos de entrada diferentes para configurar feeds en la plataforma de Google SecOps:

  • Configuración > Administración de datos > Feeds > Agregar feed nuevo (en la plataforma solo de SIEM, Configuración > Feeds > Agregar feed nuevo)
  • Centro de contenido > Paquetes de contenido > Comenzar

Cómo configurar el feed de AWS CloudFront

  1. Haz clic en el paquete Amazon Cloud Platform.
  2. Busca el tipo de registro AWS CloudFront.
  3. Especifica los valores en los siguientes campos.

    • Tipo de fuente: Amazon SQS V2
    • Nombre de la cola: Es el nombre de la cola de SQS de la que se leerá.
    • URI de S3: Es el URI del bucket.
      • s3://your-log-bucket-name/
        • Reemplaza your-log-bucket-name por el nombre real de tu bucket de S3.
    • Opciones de eliminación de la fuente: Selecciona la opción de eliminación según tus preferencias de transferencia.

    • 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 a la cola de SQS: Es una clave de acceso a la cuenta que consiste en una cadena alfanumérica de 20 caracteres.

    • Clave de acceso secreta de la cola de SQS: Es una clave de acceso a la cuenta que consiste en una cadena alfanumérica de 40 caracteres.

    Opciones avanzadas

    • Nombre del feed: Es un valor prepropagado que identifica el feed.
    • Espacio de nombres del recurso: Es el espacio de nombres asociado con el feed.
    • Etiquetas de transferencia: Son las etiquetas que se aplican a todos los eventos de este feed.
  4. Haz clic en Crear feed.

Para obtener más información sobre cómo configurar varios feeds para diferentes tipos de registros dentro de esta familia de productos, consulta Configura feeds por producto.

Referencia de asignación de campos

Este analizador extrae campos de los registros de AWS CloudFront en formato SYSLOG o JSON, y los normaliza en el UDM. Usa patrones de grok para analizar cadenas de mensajes, controla varias transformaciones de datos (p.ej., conversiones de tipos, cambios de nombre) y enriquece los datos con contexto adicional, como el análisis de usuario-agente y la identificación de protocolos de aplicación.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
c-ip principal.ip Asignación directa. También se asigna a principal.asset.ip.
c-port principal.port Asignación directa.
cs(Cookie) additional.fields[].key: "cookie"
additional.fields[].value.string_value: Se asigna directamente.
Se asigna de forma condicional si cs(Cookie) está presente y agent no contiene "://".
cs(Host) principal.hostname Asignación directa. También se asigna a principal.asset.hostname. Se usa para construir el target.url si no hay otros campos de URL disponibles.
cs(Referer) network.http.referral_url Asignación directa.
cs(User-Agent) network.http.user_agent Asignación directa. También se asigna a network.http.parsed_user_agent y se analiza en sus componentes si no contiene "://".
cs-bytes network.sent_bytes Asignación directa. Se convirtió en un número entero sin firma.
cs-method network.http.method Asignación directa.
cs-protocol network.application_protocol Se asigna después de convertir a mayúsculas. Si el valor no se reconoce como un protocolo de aplicación estándar y cs-protocol-version contiene "HTTP", network.application_protocol se establece en "HTTP".
dport target.port Asignación directa. Se convirtió en un número entero.
edge_location principal.location.name Asignación directa.
fle-encrypted-fields additional.fields[].key: "fle-encrypted-fields"
additional.fields[].value.string_value: Se asigna directamente.
Se asigna de forma condicional si está presente.
fle-status additional.fields[].key: "fle-status"
additional.fields[].value.string_value: Se asigna directamente.
Se asigna de forma condicional si está presente.
host principal.hostname, principal.asset.hostname Asignación directa.
id principal.asset_id Se asigna directamente con el prefijo "id: ".
ip target.ip, target.asset.ip Asignación directa.
log_id metadata.product_log_id Asignación directa.
resource additional.fields[].key: "resource"
additional.fields[].value.string_value: Se asigna directamente.
Se asigna de forma condicional si está presente.
result_type additional.fields[].key: "result_type"
additional.fields[].value.string_value: Se asigna directamente.
Se asigna de forma condicional si está presente.
sc-bytes network.received_bytes Asignación directa. Se convirtió en un número entero sin firma.
sc-content-len additional.fields[].key: "sc-content-len"
additional.fields[].value.string_value: Se asigna directamente.
Se asigna de forma condicional si está presente.
sc-content-type additional.fields[].key: "sc-content-type"
additional.fields[].value.string_value: Se asigna directamente.
Se asigna de forma condicional si está presente.
sc-status network.http.response_code Asignación directa. Se convirtió en un número entero.
ssl-cipher network.tls.cipher Asignación directa.
ssl-protocol network.tls.version Asignación directa.
timestamp metadata.event_timestamp Se analiza y asigna si está disponible. Se admiten diferentes formatos.
ts metadata.event_timestamp Se analiza y asigna si está disponible. Se espera el formato ISO8601.
url target.url Asignación directa.
url_back_to_product metadata.url_back_to_product Asignación directa.
x-edge-detailed-result-type additional.fields[].key: "x-edge-detailed-result-type"
additional.fields[].value.string_value: Se asigna directamente.
Se asigna de forma condicional si está presente.
x-edge-location additional.fields[].key: "x-edge-location"
additional.fields[].value.string_value: Se asigna directamente.
Se asigna de forma condicional si está presente.
x-edge-request-id additional.fields[].key: "x-edge-request-id"
additional.fields[].value.string_value: Se asigna directamente.
Se asigna de forma condicional si está presente.
x-edge-response-result-type additional.fields[].key: "x-edge-response-result-type"
additional.fields[].value.string_value: Se asigna directamente.
Se asigna de forma condicional si está presente.
x-edge-result-type additional.fields[].key: "x-edge-result-type"
additional.fields[].value.string_value: Se asigna directamente.
Se asigna de forma condicional si está presente.
x-forwarded-for target.ip, target.asset.ip Asignación directa. Si hay varias IPs (separadas por comas), se dividen y se combinan en los campos de UDM correspondientes.
x-host-header target.hostname, target.asset.hostname Asignación directa. Se establece en "NETWORK_HTTP" si están presentes ip o x-forwarded-for y http_verb. De lo contrario, se establece en "GENERIC_EVENT". Está codificado como "AWS_CLOUDFRONT". Se codifica como "AWS CloudFront". Está codificado como "AMAZON". Es la hora de transferencia de la entrada de registro a Google Security Operations.
cs_cookie event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
time-taken event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
time-to-first-byte event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
cribl_pipe event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
cs-referer event.idm.read_only_udm.network.http.referer Asignado desde el registro de cambios
cs-uri-query event.idm.read_only_udm.network.http.url_details.query Asignado desde el registro de cambios
cs-user-agent event.idm.read_only_udm.network.http.user_agent Asignado desde el registro de cambios
cs-uri-stem event.idm.read_only_udm.target.url Asignado desde el registro de cambios
x-forwarded-for security_result.detection_fields Asignado desde el registro de cambios
avgrequestTime event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
htmlType event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
responseTime event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
securityKey event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
bytes event.idm.read_only_udm.network.sent_bytes Asignado desde el registro de cambios
srcport event.idm.read_only_udm.src.port Asignado desde el registro de cambios
encryptionType event.idm.read_only_udm.security_result.about.resource.name Asignado desde el registro de cambios
hostname event.idm.read_only_udm.principal.hostname Asignado desde el registro de cambios
scrip event.idm.read_only_udm.src.ip Asignado desde el registro de cambios
targetip event.idm.read_only_udm.target.ip Asignado desde el registro de cambios
targetip event.idm.read_only_udm.target.asset.ip Asignado desde el registro de cambios
tlsvVersion event.idm.read_only_udm.network.tls.version Asignado desde el registro de cambios
CloudFront-Is-Desktop-Viewer event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
CloudFront-Is-Mobile-Viewer event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
CloudFront-Is-SmartTV-Viewer event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
CloudFront-Is-Tablet-Viewer event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
vDetails event.idm.read_only_udm.network.http.user_agent Asignado desde el registro de cambios
x-envoy-expected-rq-timeout-ms event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
x-envoy-external-address event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
x-envoy-original-authority event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
x-f5-cdn-tls-ja3 event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
x-f5-cdn-tls-ja4 event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
x-forwarded-proto event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
xc-trusted-source event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
ipType event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
method event.idm.read_only_udm.network.http.method Asignado desde el registro de cambios
x-request-id event.idm.read_only_udm.metadata.product_log_id Asignado desde el registro de cambios
version event.idm.read_only_udm.metadata.product_log_id Asignado desde el registro de cambios
requestCode event.idm.read_only_udm.network.http.response_code Asignado desde el registro de cambios
ipAddress event.idm.read_only_udm.principal.ip Asignado desde el registro de cambios
uri_query event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
Bucket target.resource.name Asignado desde el registro de cambios
accountID principal.user.userid Asignado desde el registro de cambios
file target.file.full_path Asignado desde el registro de cambios
region principal.location.country_or_region Asignado desde el registro de cambios
msg metadata.description Asignado desde el registro de cambios
service", "aggregation", "func", "requestID", "lpcltype", "lpclagg", "level" and "LoggingEnabled additional.fields Asignado 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.