민감 데이터 필터링

DD 는 민감 데이터 자동 필터링을 내장하여 로그 쓰기 전에 비밀번호, API Key, 신용카드 번호 등 민감 정보를 [REDACTED]로 교체해 민감 데이터가 로그로 유출되는 것을 방지합니다.

빠른 활성화

logger, err := dd.New(dd.Config{
    Security: dd.DefaultSecurityConfig(),
})
if err != nil {
    log.Fatal(err)
}
defer logger.Close()

// password 필드 자동 마스킹
logger.InfoWith("사용자 로그인",
    dd.String("username", "alice"),
    dd.String("password", "s3cr3t123"),    // 출력: password=[REDACTED]
)

내장 필터 패턴

DefaultSecurityConfig()는 기본 필터를 활성화하여 다음 민감 정보를 다룹니다.

카테고리	매칭 대상
비밀번호	password, passwd, pwd 등 필드
API Key	api_key, apikey, access_token 등
신용카드	Visa, MasterCard 등 카드 번호 형식
SSN	미국 사회보장번호 형식
전화번호	글로벌 전화번호 형식 (국제 형식 포함)

DefaultSecureConfig()는 완전 패턴 집합을 사용합니다 (기본 패턴 모두 포함, 아래 일반 카테고리 추가).

카테고리	매칭 대상
이메일	이메일 주소 형식
IP 주소	IPv4/IPv6 주소
JWT Token	eyJ로 시작하는 JWT 형식
연결 문자열	데이터베이스 연결 문자열 내 비밀번호

정보 패턴 범위

위 표는 일반적인 카테고리 예시일 뿐입니다. DefaultSecurityConfig()는 실제로 약 36 개의 패턴을 내장하고 있으며, 산업 사전 설정 (예: HealthcareConfig()) 은 71 개에 달하고 AWS 키, Stripe/GitHub/Slack 토큰, IBAN, 다국 세금 번호, Log4Shell 등도 다룹니다. 완전한 패턴 집합은 소스 코드 internal/patterns.go를 참조하세요.

커스텀 필터 패턴

커스텀 패턴 추가

filter := dd.NewEmptySensitiveDataFilter()

// 커스텀 정규식 패턴 추가 (내장 ReDoS 보호)
_ = filter.AddPattern(`(?i)credit_card\s*[:=]\s*\d+`)
_ = filter.AddPattern(`(?i)phone\s*[:=]\s*\d{11}`)

logger, err := dd.New(dd.Config{
    Security: &dd.SecurityConfig{
        SensitiveFilter: filter,
    },
})
if err != nil {
    log.Fatal(err)
}
defer logger.Close()

빈 필터에서 커스텀 필터 생성

filter, err := dd.NewCustomSensitiveDataFilter(
    `(?i)secret_key\s*[:=]\s*\S+`,
    `(?i)private_token\s*[:=]\s*\S+`,
)
if err != nil {
    log.Fatal(err) // 정규식 보안 검증 실패
}

경고 ReDoS 보호

NewCustomSensitiveDataFilter는 ReDoS 검증을 내장합니다. 정규식에 치명적 백트래킹 위험이 있으면 오류를 반환합니다. 비탐욕 매칭과 앵커 모드를 사용해 이 문제를 피하세요.

보안 레벨

DD 는 다섯 가지 보안 레벨을 제공하며, 각 레벨에는 대응하는 사전 설정 구성이 있습니다.

// 레벨별 구성 가져오기
cfg := dd.SecurityConfigForLevel(dd.SecurityLevelStandard)

레벨	설명	적용 시나리오
SecurityLevelDevelopment	가장 느슨함	로컬 개발
SecurityLevelBasic	기본 필터	테스트 환경
SecurityLevelStandard	표준 필터	일반 프로덕션 환경
SecurityLevelStrict	엄격한 필터	고보안 요구
SecurityLevelParanoid	가장 엄격함	금융/의료 등 민감 산업

산업 규정 준수 사전 설정

DD 는 세 가지 산업 규정 준수 구성을 제공합니다.

HIPAA(의료 산업)

cfg := dd.HealthcareConfig()

추가 필터: ICD-10 코드, 병력 번호 (MRN), 건강 보험 청구 번호 (HICN), 환자 식별 번호.

PCI-DSS(금융 결제)

cfg := dd.FinancialConfig()

추가 필터: SWIFT 코드, IBAN 계정 번호, CVV/CVC, 은행 라우팅 번호.

정부 표준

cfg := dd.GovernmentConfig()

추가 필터: 여권 번호, 운전면허 번호, 세금 ID, SSN 변형.

전체 예

// 의료 시스템: HIPAA 규정 준수 구성 사용
logger, err := dd.New(dd.Config{
    Format:   dd.FormatJSON,
    Security: dd.HealthcareConfig(),
    Targets: []dd.OutputTarget{
        dd.FileOutput("logs/hipaa-audit.json"),
    },
})
if err != nil {
    log.Fatal(err)
}
defer logger.Close()

// 민감 정보 포함 로그 메시지 자동 마스킹
logger.Info("환자 기록 mrn=MRN123456 diagnosis=J18.9 업데이트됨")
// 메시지의 MRN 과 ICD-10 코드 매칭 패턴이 마스킹됨

// 구조화 필드는 키 이름 민감도에 따라 필터링
logger.InfoWith("사용자 로그인",
    dd.String("password", "s3cr3t123"),    // → [REDACTED](키 이름 민감)
    dd.String("department", "내과"),        // 정상 출력
)

필터 통계

필터의 실행 상태를 모니터링합니다.

filter := dd.NewSensitiveDataFilter()
stats := filter.GetFilterStats()
fmt.Printf("활성 goroutines: %d\n", stats.ActiveGoroutines)
fmt.Printf("필터 패턴 수: %d\n", stats.PatternCount)
fmt.Printf("총 마스킹 횟수: %d\n", stats.TotalRedactions)
fmt.Printf("타임아웃 횟수: %d\n", stats.TotalTimeouts)

필터 비활성화

// Development 보안 레벨 사용 (민감 데이터 필터 없음)
logger, err := dd.New(dd.Config{
    Security: dd.SecurityConfigForLevel(dd.SecurityLevelDevelopment),
})
if err != nil {
    log.Fatal(err)
}

// 또는 수동으로 빈 SensitiveFilter 설정
logger, err = dd.New(dd.Config{
    Security: &dd.SecurityConfig{
        SensitiveFilter: nil,
    },
})
if err != nil {
    log.Fatal(err)
}
defer logger.Close()

경고 기본적으로 필터 활성화

DefaultConfig()는 기본적으로 기본 민감 데이터 필터 (DefaultSecurityConfig()) 가 활성화됩니다. Security 필드를 설정하지 않아도 기본 보안 구성이 사용됩니다. 필터를 비활성화하려면 SensitiveFilter를 명시적으로 nil로 설정해야 합니다.

다음 단계

• 감사 로그 -- 보안 이벤트 감사
• 산업 규정 준수 구성 -- HIPAA/PCI-DSS 상세
• API 레퍼런스 - Security -- 보안 API 의 완전한 문서
• 프로덕션 체크리스트 -- 출시 전 검사