Ofuscar datos del navegador

Puede crear reglas de ofuscación de ingesta directamente desde la plataforma de New Relic para enmascarar datos confidenciales antes de que se recopilen. Estas reglas se aplican a todos los eventos del browser. Las reglas configuradas a través de la plataforma de New Relic o NerdGraph se aplican a las aplicaciones inyectadas por APM, las instalaciones de copiar y pegar y las instalaciones de NPM. Sin embargo, las instalaciones de copiar y pegar y de NPM pueden anular manualmente las reglas configuradas en la plataforma de New Relic agregando la propiedad obfuscate a su configuración de init.

Para agregar una regla de ofuscación:

1. Vaya a one.newrelic.com > All capabilities > Browser > (select an app) > Settings > Application settings.
2. En Ingest obfuscation rules, haga clic en Add a rule.
3. En el campo Original value, ingrese un patrón regex para que coincida con los datos confidenciales que desea enmascarar.
4. En el campo Replace with, ingrese un valor neutral o de reemplazo.
5. Desde el desplegable Choose where to store, seleccione los tipos de atributos de evento a los que desea aplicar la regla de ofuscación.
6. Haga clic en Add rule para crear. La regla de ofuscación se aplica a los datos coincidentes en todos los eventos del navegador antes de la ingesta.

Puede configurar el agente del browser para ofuscar datos de forma selectiva en cada carga que envía. Esto es útil si su aplicación utiliza datos confidenciales en lugares que captura el agente, como rutas de navegación, mensajes de error y más.

A partir de la versión 1216 y superior del agente del navegador, la regla de ofuscación se puede aplicar a la carga de cosecha saliente.

Para establecer estas reglas, configure la siguiente propiedad del agente del browser:

• La propiedad init.obfuscate contiene una matriz de selectores y reemplazos que se utilizarán para modificar cada cosecha antes de enviarla.

  • Deberá editar manualmente su sección de configuración de JavaScript y establecer la matriz obfuscate para que contenga sus condiciones de ofuscación.

  Recomendaciones

  Al configurar esta propiedad, recomendamos lo siguiente:

• Utilice patrones de expresiones regulares intencionales para ofuscar solo lo que necesita ofuscación.

  • La ofuscación excesiva puede tener efectos secundarios, como una menor granularidad al agrupar datos y una menor capacidad para procesar lo que capturó el agente.

• Reemplace sus datos confidenciales con términos neutrales y genéricos que también indiquen qué datos se han redactado.

  • Ejemplo: /account-id/g --> ACCOUNT_ID

  Copiar/pegar instalación

  Si está utilizando el método de instalación de copiar y pegar, agregue la siguiente configuración a las configuraciones de JavaScript de su browser antes del cargador del agente:

  window.NREUM.init = {
      ...<other init properties>...,
      obfuscate: [
        {
          regex: <RegExp | string>,
          replacement: <string>,
          eventFilter: [<string>]  // Optional: specific event types to apply this rule to
        },
        ...<other obfuscation rules>...
      ]
  }

  Copia

  Instalación de NPM

  Si utiliza el método de instalación del browser de NPM, agregue la siguiente configuración al inicializar el agente del browser:

  new BrowserAgent({ 
    init: {
      ...<other init properties>...,
      obfuscate: [
        {
          regex: <RegExp | string>,
          replacement: <string>,
          eventFilter: [<string>]  // Optional: specific event types to apply this rule to
        },
        ...<other obfuscation rules>...
      ]
    }
  })

  Copia

  Ejemplos: limitar la ofuscación a tipos de eventos específicos

  De forma predeterminada, las reglas de ofuscación se aplican a todos los tipos de eventos capturados por el agente del browser. Sin embargo, puede limitar las reglas a tipos de eventos específicos utilizando la propiedad de matriz eventFilter.

  Esto es particularmente útil al capturar cargas AJAX, donde es posible que desee ofuscar datos confidenciales en los cuerpos de solicitud/respuesta sin afectar otros eventos.

  Sugerencia

  Si omite la propiedad eventFilter, la regla se aplica a todos los tipos de eventos, manteniendo la compatibilidad con la configuración existente.

  window.NREUM.init = {
      ...<other init properties>...,
      obfuscate: [
        {
          regex: /user-id/g,
          replacement: 'USER_ID',
          eventFilter: ['AjaxRequest']  // Optional: only apply to specific event types
        },
      ]
  }

  Copia

  new BrowserAgent({ 
    init: {
      ...<other init properties>...,
      obfuscate: [
        {
          regex: /account-id/g,
          replacement: 'ACCOUNT_ID',
          eventFilter: ['AjaxRequest', 'JavaScriptError']  // Optional: apply to multiple event types
        },
      ]
    }
  })

  Copia

A través de NerdGraph

Puede utilizar la API de NerdGraph para consultar y actualizar reglas de ofuscación programáticamente.

Dos patrones regex detectan y enmascaran formatos comunes de tarjetas de crédito:

Patrón 1 (formato más simple):

{
  regex: /\b(?:4[0-9]{12}(?:[0-9]{3})?|5[1-5][0-9]{14}|3[47][0-9]{13}|6011[0-9]{12})\b/g,
  replacement: 'XXXX-XXXX-XXXX-XXXX',
  eventFilter: ['AjaxRequest']
}

Patrón 2 (exhaustivo, que cubre más tipos de tarjetas):

{
  regex: /(?:4\d{12}(?:\d{3}){0,2}|5[1-5]\d{14}|2(?!20)[2-7]\d{14}|220[0-4]\d{12}|3[47]\d{13}|3(?:0[0-5]|[68]\d)\d{11}|6(?:011|5\d{2}|4[4-9]\d)\d{12}|62\d{14,17}|35(?:2[89]|[3-8]\d)\d{12,15}|(?:5018|5020|5038|6304|6759|676[1-3])\d{8,15}|(?:60|65|81|82)\d{14})/g,
  replacement: 'XXXX-XXXX-XXXX-XXXX',
  eventFilter: ['AjaxRequest']
}

Ambos patrones reemplazan los números de tarjetas de crédito detectados con XXXX-XXXX-XXXX-XXXX.

El siguiente patrón de expresión regular detecta y enmascara los números de Seguro Social comunes con XXX-XX-XXXX:

{
  regex: /\b\d{3}-?\d{2}-?\d{4}\b/g,
  replacement: 'XXX-XX-XXXX',
  eventFilter: ['AjaxRequest']
}

El enfoque recomendado es utilizar un identificador no confidencial para setUserId(), como:

• Un ID de usuario con hash o encriptado

• Un número de cuenta interno

• Un UUID o identificador generado

  // Good: Use a non-sensitive ID
  newrelic.setUserId('user-12345')
  
  // Or use a hash of the email
  newrelic.setUserId(hashEmail('user@example.com')) // e.g., 'a1b2c3d4'

  Copia

Si debe usar direcciones de correo electrónico como ID de usuario, cree reglas de ofuscación que tengan como objetivo rutas JSON o nombres de atributos específicos, en lugar de coincidir con patrones de correo electrónico globalmente:

{
  // More specific: only match emails in known sensitive fields
  regex: /("customerEmail"\s*:\s*")[^"]+(@[^"]+")/g,
  replacement: '$1EMAIL_REDACTED$2',
  eventFilter: ['AjaxRequest']
}

Este enfoque requiere pruebas cuidadosas para asegurar que está capturando todos los datos confidenciales mientras evita falsos positivos.