브라우저 데이터 난독화

데이터가 수집되기 전에 민감한 데이터를 마스크하도록 뉴렐릭 플랫폼에서 직접 수집 난독화 룰을 생성할 수 있습니다. 이러한 룰은 모든 브라우저 이벤트에 적용됩니다. 뉴렐릭 플랫폼 또는 NerdGraph를 통해 설정된 룰은 APM이 주입된 애플리케이션, 복사/붙여넣기 설치 및 NPM 설치에 적용됩니다. 하지만 복사/붙여넣기 및 NPM 설치 는 init 설정에 obfuscate 속성을 추가하여 뉴렐릭 플랫폼에서 설정한 룰을 수동으로 재정의할 수 있습니다.

난독화 룰을 추가하려면:

1. one.newrelic.com > All capabilities > Browser > (select an app) > Settings > Application settings 으)로 이동합니다.
2. Ingest obfuscation rules 아래에서 Add a rule 클릭합니다.
3. Original value 필드에 마스크하려는 민감한 데이터와 일치하는 정규식 패턴을 입력합니다.
4. Replace with 필드에 중립 또는 대체 값을 입력합니다.
5. Choose where to store 드롭다운 메뉴에서 난독화 룰을 적용할 이벤트 속성 유형을 선택합니다.
6. 만들려면 Add rule 을(를) 클릭합니다. 수집 전 모든 브라우저 이벤트에서 일치하는 데이터에 난독화 룰이 적용됩니다.

전송하는 모든 페이로드에서 데이터를 선택적으로 난독화하도록 브라우저 에이전트를 구성할 수 있습니다. 이는 애플리케이션이 탐색 경로, 오류 메시지 등과 같이 에이전트가 캡처하는 위치에서 민감한 데이터를 사용하는 경우에 유용합니다.

브라우저 에이전트 버전 1216 이상에서는 나가는 수집 페이로드에 난독화 규칙을 적용할 수 있습니다.

이러한 룰을 설정하려면 다음 브라우저 에이전트 속성을 구성합니다:

• init.obfuscate 속성에는 전송하기 전에 각 수확을 수정하는 데 사용되는 선택기 및 교체 배열이 포함되어 있습니다.

  • JavaScript 설정 섹션을 수동으로 편집하고 난독화 조건을 포함하도록 obfuscate 어레이를 설정해야 합니다.

  권장 사항

  이 속성을 구성할 때 다음을 권장합니다.

• 난독화가 필요한 항목만 난독화하려면 의도적인 정규식 패턴을 사용하세요.

  • 과도한 난독화는 데이터를 그룹화할 때 세분성이 떨어지고 에이전트가 캡처한 내용을 소화하는 능력이 저하되는 등의 부작용을 초래할 수 있습니다.

• 민감한 데이터를 어떤 데이터가 수정되었는지 나타내는 중립적이고 일반적인 용어로 바꾸세요.

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

  복사/붙여넣기 설치

  복사/붙여넣기 설치 방법을 사용하는 경우 에이전트 로더 전에 브라우저 JavaScript 구성에 다음 구성을 추가하세요.

  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>...
      ]
  }

  카피

  NPM 설치

  NPM 브라우저 설치 방법을 사용하는 경우, 브라우저 에이전트를 초기화할 때 다음 설정을 추가합니다:

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

  카피

  예: 특정 이벤트 유형으로 난독화 범위 지정

  기본적으로 난독화 룰은 브라우저 에이전트가 캡처한 모든 이벤트 유형에 적용됩니다. 하지만 eventFilter 어레이 속성을 사용하여 특정 이벤트 유형으로 룰의 범위를 지정할 수 있습니다.

  이는 다른 이벤트에 영향을 주지 않고 요청/응답 본문의 민감한 데이터를 난독화하려는 경우, AJAX 페이로드를 캡처할 때 특히 유용합니다.

  팁

  eventFilter 속성을 생략하면 룰이 모든 이벤트 유형에 적용되어 기존 설정과의 호환성을 유지합니다.

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

  카피

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

  카피

NerdGraph를 통해

프로그래밍 방식으로 난독화 룰을 NerdGraph API를 사용하여 쿼리하고 업데이트 할 수 있습니다.

두 개의 정규식 패턴이 일반적인 신용카드 형식을 감지하고 마스크합니다:

패턴 1 (더 간단한 형식):

{
  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']
}

패턴 2 (포괄적, 더 많은 카드 유형 포함):

{
  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']
}

두 패턴 모두 감지된 신용카드 번호를 XXXX-XXXX-XXXX-XXXX(으)로 대체합니다.

다음 정규식 패턴은 XXX-XX-XXXX을(를) 사용하여 일반적인 사회 보장 번호를 감지하고 마스크합니다:

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

권장되는 접근 방식은 다음과 같이 setUserId()에 대해 민감하지 않은 식별자를 사용하는 것입니다:

• 해시 또는 암호화된 사용자 ID

• 내부 계정 번호

• UUID 또는 생성된 식별자

  // 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'

  카피

이메일 주소를 사용자 ID로 사용해야 하는 경우, 이메일 패턴을 전역적으로 일치시키는 대신 특정 JSON 경로 또는 속성 이름을 타겟으로 하는 난독화 룰을 생성합니다:

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

이 접근 방식은 오탐을 피하면서 모든 민감한 데이터를 포착할 수 있도록 신중한 테스트가 필요합니다.