---
sidebar_label: "개요"
title: "보안 개요 - CyberGo DD | 로그 보안"
description: "CyberGo DD 로그 라이브러리 보안 기능의 포괄적인 개요입니다. 민감 데이터 자동 감지와 마스킹 필터 메커니즘, 파일 경로 보안 검증과 보호 전략, 비동기 감사 이벤트 기록과 시퀀스 추적 능력, HMAC 무결성 서명 변조 방지 기술, 규정 준수 구성 모범 사례 가이드를 다루어 데이터 필터부터 감사 추적까지 로그 시스템 운영 보안을 전면 보장합니다."
sidebar_position: 1
---

# 보안 개요

DD 로그 라이브러리는 다층 보안 보호 메커니즘을 내장하여 데이터 필터부터 감사 추적까지 로그 보안을 전면 보장합니다.

## 보안 계층

| 계층 | 메커니즘 | 설명 |
|------|------|------|
| 데이터 계층 | 민감 데이터 필터 | 비밀번호, 키 등 자동 마스킹 |
| 경로 계층 | 경로 보안 검증 | 경로 순회, 심볼릭 링크 공격 방지 |
| 패턴 계층 | ReDoS 보호 | 위험한 정규식 패턴 감지 |
| 감사 계층 | 감사 로그 | 핵심 보안 이벤트 기록 (마스킹, 속도 제한, 위반 등) |
| 무결성 계층 | HMAC 서명 | 로그 변조 불가 보장 |

## 민감 데이터 필터

DD 는 민감 데이터 자동 감지와 마스킹을 내장합니다.

```go
logger, _ := dd.New(dd.Config{
    Security: dd.DefaultSecurityConfig(),
})

// password 필드 자동 마스킹
logger.InfoWith("로그인",
    dd.String("username", "admin"),
    dd.String("password", "s3cr3t"),  // 출력: [REDACTED]
)
```

지원하는 커스텀 패턴:

```go
filter, _ := dd.NewCustomSensitiveDataFilter(
    `(?i)password\s*[:=]\s*\S+`,
    `(?i)api[_-]?key\s*[:=]\s*\S+`,
    `\b\d{16,19}\b`,  // 신용카드 번호
)
```

자세한 내용은 [보안 필터 API](../api-reference/security-audit/security)를 참조하세요.

## 경로 보안

FileWriter 는 다층 경로 보안 검증을 내장합니다.

| 보호 | 설명 |
|------|------|
| 경로 순회 | `../` 등 경로 순회 거부 |
| Null 바이트 | null 바이트 주입 거부 |
| Overlong 인코딩 | UTF-8 overlong 인코딩 감지 |
| 심볼릭 링크 | 심볼릭 링크 금지 구성 가능 |
| 하드링크 | 하드링크 금지 구성 가능 |
| 경로 길이 | 경로 최대 길이 제한 |

```go
// 경로 순회 공격 자동 거부
fw, err := dd.NewFileWriter("../../../etc/passwd", dd.DefaultFileWriterConfig())
// err.Error(): "path traversal detected"
```

## 규정 준수 구성

DD 는 산업 규정 준수 사전 설정을 제공합니다.

| 사전 설정 | 규정标准 | 적용 산업 |
|------|----------|----------|
| `HealthcareConfig()` | HIPAA | 의료 |
| `FinancialConfig()` | PCI-DSS | 금융 |
| `GovernmentConfig()` | 정부 표준 | 공공 부문 |

```go
// HIPAA 규정 준수
logger, _ := dd.New(dd.Config{
    Security: dd.HealthcareConfig(),
})
```

## 감사 로그

모든 보안 이벤트는 감사 로그로 추적할 수 있습니다.

```go
audit, _ := dd.NewAuditLogger(dd.DefaultAuditConfig())
defer audit.Close()

audit.LogSecurityViolation("sql_injection", "SQL 인젝션", map[string]any{
    "input": "' OR 1=1 --",
})
```

자세한 내용은 [감사 로그 API](../api-reference/security-audit/audit)를 참조하세요.

## 로그 무결성

HMAC 서명으로 로그가 변조되지 않도록 보장합니다.

```go
cfg, _ := dd.DefaultIntegrityConfigSafe()
signer, _ := dd.NewIntegritySigner(cfg)
signature := signer.Sign(logMessage)
// 검증 시: signer.Verify(signedEntry)
```

자세한 내용은 [무결성 서명 API](../api-reference/security-audit/integrity)를 참조하세요.

## 다음 단계

- [프로덕션 체크리스트](./production-checklist) -- 출시 전 보안 검사
- [보안 필터 API](../api-reference/security-audit/security) -- SensitiveDataFilter 상세
- [감사 로그 API](../api-reference/security-audit/audit) -- AuditLogger 상세