Ofuscar datos del agente de streaming media

La regla de ofuscación le permite enmascarar datos confidenciales antes de que el agente los transmita a New Relic. Cada regla es un patrón de expresiones regulares emparejado con una cadena de reemplazo. El agente aplica las reglas en orden a cada valor de atributo de cadena en cada evento saliente — incluidos los evento de QoE y los evento recuperados de fallos.

iOS

Configuración

Objective-C

NRVAVideoConfiguration *config = [[[[NRVAVideoConfiguration builder]
    withApplicationToken:@"YOUR_NEW_RELIC_TOKEN"]
    withObfuscationRules:@[
        @{ @"regex": @"account-\\d+",  @"replacement": @"ACCOUNT_ID" },
        @{ @"regex": @"token=[^&\"]+", @"replacement": @"token=REDACTED" },
    ]]
    build];
[[[NRVAVideo newBuilder] withConfiguration:config] build];

Swift

let config = NRVAVideoConfiguration.builder()
    .withApplicationToken("YOUR_NEW_RELIC_TOKEN")
    .withObfuscationRules([
        ["regex": "account-\\d+",  "replacement": "ACCOUNT_ID"],
        ["regex": "token=[^&\"]+", "replacement": "token=REDACTED"],
    ])
    .build()
NRVAVideo.newBuilder().with(configuration: config).build()

Cómo funciona

• El agente aplica las reglas por valor de atributo de cadena, no a la carga JSON sin procesar — los atributo numéricos y booleanos no se ven afectados.
• Todas las reglas se ejecutan contra cada evento saliente, incluidos los eventos regulares, en vivo, de QoE y recuperados de fallas.
• Las reglas se ejecutan en el orden en que las declara. Si dos reglas pueden coincidir con el mismo valor, el orden importa.
• El agente nunca ofusca el applicationToken ni los encabezados de autenticación HTTP — la ofuscación solo se aplica a los valores de atributo de evento.

Casos extremos

Roku

Puede configurar el agente con reglas de ofuscación basadas en expresiones regulares para enmascarar datos confidenciales antes de que el agente envíe eventos a New Relic. Use esta característica cuando campos como contentSrc, contentTitle, origUrl o atributos personalizados puedan contener inadvertidamente ID de usuario, tokens u otra información de identificación personal (PII).

El agente aplica reglas a cada atributo de cadena en cada evento saliente — incluyendo video, anuncios (RAF e IMA), QOE, sistema y eventos personalizados — antes de que el evento ingrese al búfer interno.

Configuración

Llame a nrSetObfuscationRules después de crear el agente. Cada regla es una matriz asociativa con una cadena regex y una cadena replacement:

m.nr = NewRelic("ACCOUNT_ID", "API_KEY", "APP_NAME", "APP_TOKEN")
nrSetObfuscationRules(m.nr, [
    { regex: "account-[0-9]+",  replacement: "ACCOUNT_ID" },
    { regex: "token=[^&]+",     replacement: "token=REDACTED" },
    { regex: "/users/[^/]+",    replacement: "/users/USER_ID" }
])

Para eliminar todas las reglas en tiempo de ejecución, llame a nrSetObfuscationRules con una matriz vacía:

nrSetObfuscationRules(m.nr, [])

Ordenamiento de reglas

El agente aplica las reglas en el orden en que aparecen en la matriz. La salida de una regla se convierte en la entrada de la siguiente. El orden importa cuando los patrones podrían superponerse:

nrSetObfuscationRules(m.nr, [
    ' Applied first — masks the specific token format
    { regex: "auth-token-[a-z0-9]+", replacement: "AUTH_TOKEN" },
    ' Applied second — masks any remaining bare token references
    { regex: "token=[^&]+",          replacement: "token=REDACTED" }
])

Comportamiento y casos extremos