Les règles d’obfuscation vous permettent de masquer les données sensibles avant que l’agent ne les transmette à New Relic. Chaque règle est un modèle regex associé à une chaîne de remplacement. L’agent applique les règles dans l’ordre à chaque valeur d’attribut de chaîne dans chaque événement sortant — y compris les événements QoE et les événements récupérés après un plantage.
Vous pouvez configurer l’agent avec des règles d’obfuscation basées sur des expressions régulières pour masquer les données sensibles avant que l’agent n’envoie des événements à New Relic. Utilisez cette fonctionnalité lorsque des champs tels que contentSrc, contentTitle, origUrl ou des attributs personnalisés peuvent contenir par inadvertance des identifiants d’utilisateur, des jetons ou d’autres informations personnelles.
L'agent applique des règles à chaque attribut de chaîne dans chaque événement sortant — y compris les événements vidéo, publicitaires (RAF et IMA), QOE, système et les événements personnalisés — avant que l'événement n'entre dans le tampon interne.
Configuration
Appelez nrSetObfuscationRules après avoir créé l’agent. Chaque règle est un éventail associatif avec une chaîne regex et une chaîne 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" }])Pour supprimer toutes les règles à l’exécution, appelez nrSetObfuscationRules avec un éventail vide :
nrSetObfuscationRules(m.nr, [])Ordre des règles
L'agent applique les règles dans l'ordre où elles apparaissent dans l'éventail. La sortie d'une règle devient l'entrée de la suivante. L'ordre est important lorsque les modèles peuvent se chevaucher :
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" }])Comportement et cas limites
| Cas | Comportement |
|---|---|
| Aucune règle configurée | L’agent transmet toutes les valeurs d’attribut sans modification et sans impact sur les performances. |
Chaîne replacement vide | L’agent supprime le contenu correspondant de la valeur. |
| Motif regex invalide | L’agent ignore la règle et écrit un avertissement dans le log. |
| Valeurs d’attribut non-chaîne | L’agent les transmet sans modification. Seules les valeurs de chaîne sont traitées. |
| Remplacement de toutes les règles | Appelez à nouveau nrSetObfuscationRules avec le nouvel éventail. L’agent ignore toutes les règles précédentes. |
Important
Roku utilise roRegex pour la correspondance de motifs. Roku ne prend pas en charge les assertions complexes de type lookahead/lookbehind. Les motifs qui sont valides dans les regex JavaScript ou Java peuvent nécessiter d’être simplifiés pour Roku.