감사 로그

감사 로그는 비즈니스 로그와 독립적으로 보안 관련 이벤트 (예: 민감 데이터 마스킹, ReDoS 공격 시도 등) 를 전담하여 기록하며, 규정 준수 감사와 보안 분석에 적합합니다.

개요

text

비즈니스 로그 (Logger)          감사 로그 (AuditLogger)
    │                           │
    ├─ Info/Debug/Warn...       ├─ SensitiveDataRedacted
    ├─ 구조화 필드              ├─ RateLimitExceeded
    └─ 파일/콘솔 출력           ├─ ReDoSAttempt
                                ├─ SecurityViolation
                                └─ IntegrityViolation

감사 로그는 버퍼 채널을 통해 비동기로 기록되어 비즈니스 흐름을 차단하지 않습니다.

AuditLogger 생성

기본 사용

auditLogger, err := dd.NewAuditLogger(dd.DefaultAuditConfig())
if err != nil {
    log.Fatal(err)
}
defer auditLogger.Close()

// AuditLogger 는 독립 생성 (본 예) 또는 Config.Audit 로 Logger 와 자동 통합 가능
// 여기서는 독립 사용법 시연: 별도 logger 를 만들고 Config.Audit 미설정
logger, err := dd.New(dd.Config{
    Security: dd.DefaultSecurityConfig(),
    Targets:  []dd.OutputTarget{dd.ConsoleOutput()},
})
if err != nil {
    log.Fatal(err)
}
defer logger.Close()

커스텀 구성

auditLogger, err := dd.NewAuditLogger(dd.AuditConfig{
    Enabled:          true,
    Output:           os.Stderr,               // 출력 대상 (*os.File)
    BufferSize:       2000,                    // 버퍼 채널 크기
    IncludeTimestamp: true,                    // 타임스탬프 포함
    JSONFormat:       true,                    // JSON 형식
    MinimumSeverity:  dd.AuditSeverityWarning, // 최소 심각도 레벨
})
if err != nil {
    log.Fatal(err)
}
defer auditLogger.Close()

감사 이벤트 타입

AuditLogger 는 11 가지 보안 이벤트를 기록합니다.

이벤트 타입	설명	기본 심각도 레벨
`AuditEventSensitiveDataRedacted`	민감 데이터 마스킹됨	Info
`AuditEventRateLimitExceeded`	속도 제한 트리거	Warning
`AuditEventReDoSAttempt`	ReDoS 공격 시도	Critical
`AuditEventSecurityViolation`	보안 위반	Error
`AuditEventIntegrityViolation`	로그 무결성 훼손	Critical
`AuditEventInputSanitized`	입력 정제됨	호출자 지정
`AuditEventPathTraversalAttempt`	경로 순회 시도	Critical
`AuditEventLog4ShellAttempt`	Log4Shell 공격 시도	호출자 지정
`AuditEventNullByteInjection`	null 바이트 주입 시도	호출자 지정
`AuditEventOverlongEncoding`	Overlong 인코딩 공격	호출자 지정
`AuditEventHomographAttack`	동형자 공격	호출자 지정

HMAC 서명과 통합

감사 로그와 무결성 서명을 결합하면 로그 변조를 방지할 수 있습니다.

// 서명자 생성
integrityCfg, err := dd.DefaultIntegrityConfigSafe()
if err != nil {
    log.Fatal(err)
}
signer, err := dd.NewIntegritySigner(integrityCfg)
if err != nil {
    log.Fatal(err)
}

// 서명이 포함된 감사 Logger 생성
auditLogger, err := dd.NewAuditLogger(dd.AuditConfig{
    Enabled:          true,
    Output:           auditFile,
    JSONFormat:       true,
    BufferSize:       1000,
    MinimumSeverity:  dd.AuditSeverityInfo,
    IntegritySigner:  signer, // HMAC 서명
})

감사 통계

stats := auditLogger.Stats()
fmt.Printf("총 이벤트 수: %d\n", stats.TotalEvents)
fmt.Printf("버려진 이벤트: %d\n", stats.Dropped)
fmt.Printf("버퍼 사용률: %.1f%%\n",
    float64(stats.BufferUsage)/float64(stats.BufferSize)*100)

// 타입별 통계
for eventType, count := range stats.ByType {
    fmt.Printf("  %s: %d\n", eventType, count)
}

팁 모니터링 권장

Dropped 카운트를 정기적으로 확인하세요. 버려진 이벤트 수가 증가하면 버퍼가 부족하다는 뜻이므로 BufferSize를 늘리거나 소비 속도를 높여야 합니다.

로그 검증

감사 로그 항목의 무결성을 검증합니다.

// 단일 감사 로그 검증
result := dd.VerifyAuditEvent(logLine, signer)
if result.Valid {
    fmt.Printf("검증됨: %s\n", result.RawEvent)
    if result.Event != nil {
        fmt.Printf("  타입: %s, 메시지: %s\n", result.Event.Type, result.Event.Message)
    }
} else {
    fmt.Printf("검증 실패: %s\n", result.Error)
}

심각도 레벨 필터

감사 이벤트는 심각도 레벨로 필터링되며, MinimumSeverity보다 낮은 이벤트는 무시됩니다.

// Warning 이상만 기록
auditLogger, err := dd.NewAuditLogger(dd.AuditConfig{
    MinimumSeverity: dd.AuditSeverityWarning,
})
if err != nil {
    log.Fatal(err)
}
defer auditLogger.Close()

레벨	수치	적용 시나리오
`AuditSeverityInfo`	0	모든 이벤트 기록 (개발/디버그)
`AuditSeverityWarning`	1	프로덕션 환경 권장
`AuditSeverityError`	2	고보안 요구
`AuditSeverityCritical`	3	심각한 이벤트만 기록

전체 예

package main

import (
    "log"
    "os"

    "github.com/cybergodev/dd"
)

func main() {
    // 감사 파일 생성
    auditFile, err := os.Create("logs/audit.json")
    if err != nil {
        log.Fatal(err)
    }
    defer auditFile.Close()

    // 서명자 생성
    integrityCfg, err := dd.DefaultIntegrityConfigSafe()
    if err != nil {
        log.Fatal(err)
    }
    signer, err := dd.NewIntegritySigner(integrityCfg)
    if err != nil {
        log.Fatal(err)
    }

    // 감사 Logger 생성
    auditLogger, err := dd.NewAuditLogger(dd.AuditConfig{
        Enabled:          true,
        Output:           auditFile,
        JSONFormat:       true,
        BufferSize:       1000,
        MinimumSeverity:  dd.AuditSeverityInfo,
        IntegritySigner:  signer,
    })
    if err != nil {
        log.Fatal(err)
    }
    defer auditLogger.Close()

    // 비즈니스 Logger 생성 (보안 필터 포함)
    logger, err := dd.New(dd.Config{
        Format:   dd.FormatJSON,
        Security: dd.DefaultSecureConfig(),
        Targets:  []dd.OutputTarget{dd.ConsoleOutput()},
    })
    if err != nil {
        log.Fatal(err)
    }
    defer logger.Close()

    // 정상 비즈니스 로그 (민감 데이터 자동 마스킹)
    logger.InfoWith("사용자 작업",
        dd.String("username", "alice"),
        dd.String("password", "secret123"), // → [REDACTED]
    )

    // 참고: 본 예에서는 Logger 에 Config.Audit 를 설정하지 않았으므로, 마스킹 등 보안 이벤트가 자동으로 감사에 들어가지 않습니다.
    // 비즈니스 logger 의 보안 이벤트를 AuditLogger 로 자동 전달하려면 해당 logger 의
    // Config.Audit 에서 구성해야 합니다 (활성화하면 마스킹, 속도 제한 등 이벤트가 자동으로 감사 스트림에 들어감).
}

정보 자동 통합 vs 독립 사용

AuditLogger 는 독립 생성(dd.NewAuditLogger, 본 절 예시의 사용법) 도 가능하고, Config.Audit로 Logger 와 자동 통합도 가능합니다. 후자는 Config.Audit(타입 AuditConfig) 의 Enabled 필드가 true 일 때 민감 데이터 마스킹 이벤트, 속도 제한 이벤트 등을 AuditLogger 로 자동 전달하며, 수동으로 훅을 연결할 필요가 없습니다.

다음 단계

HMAC 서명 실전 -- 무결성 서명 상세
산업 규정 준수 구성 -- HIPAA/PCI-DSS 감사 요구
API 레퍼런스 - Audit -- AuditLogger 완전한 API
API 레퍼런스 - Integrity -- IntegritySigner API

감사 로그 ​

개요 ​

AuditLogger 생성 ​

기본 사용 ​

커스텀 구성 ​

감사 이벤트 타입 ​

HMAC 서명과 통합 ​

감사 통계 ​

로그 검증 ​

심각도 레벨 필터 ​

전체 예 ​

다음 단계 ​