Ofuscar dados do agente de streaming de mídia

As regras de ofuscação permitem mascarar dados confidenciais antes que o agente os transmita para a New Relic. Cada regra é um padrão de regex emparelhado com uma string de substituição. O agente aplica as regras em ordem a cada valor de atributo de string em cada evento de saída — incluindo eventos de QoE e eventos recuperados de falhas.

iOS

Configuração

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()

Como funciona

• O agente aplica as regras por valor de atributo de string, não à carga JSON bruta — atributos numéricos e booleanos não são afetados.
• Todas as regras são executadas em cada evento de saída, incluindo eventos regulares, ao vivo, de QoE e recuperados de falhas.
• As regras são executadas na ordem em que você as declara. Se duas regras puderem corresponder ao mesmo valor, a ordem é importante.
• O agente nunca ofusca o applicationToken ou os cabeçalhos de autenticação HTTP — a ofuscação se aplica apenas aos valores de atributo de evento.

Casos extremos

Roku

Você pode configurar o agente com regras de ofuscação baseadas em regex para mascarar dados confidenciais antes que o agente envie eventos para a New Relic. Use este recurso quando campos como contentSrc, contentTitle, origUrl ou atributos personalizados puderem conter inadvertidamente IDs de usuário, tokens ou outras PII.

O agente aplica as regras a cada atributo de string em cada evento de saída — incluindo vídeo, anúncio (RAF e IMA), QOE, sistema e eventos personalizados — antes que o evento entre no buffer interno.

Configuração

Chame nrSetObfuscationRules depois de criar o agente. Cada regra é uma matriz associativa com uma string regex e uma string 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 remover todas as regras em tempo de execução, chame nrSetObfuscationRules com uma matriz vazia:

nrSetObfuscationRules(m.nr, [])

Ordenação de regras

O agente aplica as regras na ordem em que aparecem na matriz. A saída de uma regra se torna a entrada para a próxima. A ordem é importante quando os padrões podem se sobrepor:

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" }
])

Comportamento e casos extremos