보안 로깅 및 모니터링은 어떻게 이루어지나요?

김상욱·2025년 1월 1일

보안 로깅 및 모니터링은 어떻게 이루어지나요?

보안 로깅(Security Logging) : 애플리케이션에서 발생하는 다양한 이벤트(로그인 시도, 데이터 접근, 오류 등)를 기록하는 과정입니다. 이를 통해 누가, 언제, 어떤 행동을 했는지 추적할 수 있습니다

보안 모니터링(Security Monitoring) : 기록된 로그를 실시간 또는 주기적으로 분석하여 의심스러운 활동이나 보안 위협을 탐지하고 대응하는 과정입니다.

왜 중요한가요?

애플리케이션에서 발생하는 문제를 신속하게 파악하고 해결할 수 있습니다.
잠재적인 보안 위협을 조기에 발견하고 대응하여 시스템을 안전하게 유지할 수 있습니다.
많은 산업에서는 보안 로깅 및 모니터링을 법적으로 요구하고 있습니다.

Java와 Spring에서의 구현 방법

a. 로깅 프레임워크 사용
Java와 Spring에서는 다양한 로깅 프레임워크를 사용할 수 있습니다.

SLF4J (Simple Logging Facade for Java) : 여러 로깅 프레임워크에 대한 추상화 계층을 제공
Logback: SLF4J의 기본 구현체로, 성능이 우수하고 설정이 유연합니다.
Log4j: 오래된 로깅 프레임워크지만 여전히 많이 사용됩니다.

<configuration>
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>logs/app.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>logs/app.%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <root level="INFO">
        <appender-ref ref="FILE" />
    </root>
</configuration>

b. Spring Security와 통합
Spring Security는 인증과 인가를 관리하며, 보안 관련 이벤트를 로깅할 수 있습니다.

import org.springframework.security.authentication.event.AuthenticationSuccessEvent;
import org.springframework.security.authentication.event.AuthenticationFailureBadCredentialsEvent;
import org.springframework.context.event.EventListener;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Component;

@Component
public class SecurityEventListener {

    private static final Logger logger = LoggerFactory.getLogger(SecurityEventListener.class);

    @EventListener
    public void handleAuthenticationSuccess(AuthenticationSuccessEvent event) {
        logger.info("사용자 {}가 성공적으로 로그인했습니다.", event.getAuthentication().getName());
    }

    @EventListener
    public void handleAuthenticationFailure(AuthenticationFailureBadCredentialsEvent event) {
        logger.warn("사용자 {}의 로그인 시도가 실패했습니다.", event.getAuthentication().getName());
    }
}

c. AOP를 이용한 로깅
AOP(Aspect-Oriented Programming)를 사용하면 특정 메서드 호출시 자동으로 로깅을 추가할 수 있습니다.

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Component;

@Aspect
@Component
public class LoggingAspect {
    
    private Logger logger = LoggerFactory.getLogger(this.getClass());
    
    @Before("execution(* com.example.service.*.*(..))")
    public void logBefore(JoinPoint joinPoint) {
        logger.info("메서드 호출: " + joinPoint.getSignature().getName());
    }
}

d. 외부 모니터링 도구와 연동
로그를 중앙에서 관리하고 분석하기 위해 ELK Stack, Prometheus, Grafana 같은 도구를 사용할 수 있습니다.

ELK Stack (Elasticsearch, Logstash, Kibana) : 로그 수집, 저장, 시각화에 유용합니다.
Prometheus & Grafana : 메트릭 수집과 시각화에 강력합니다.

e. 로그 보안 관리
로그는 민감한 정보를 포함할 수 있으므로 안전하게 저장하고 접근을 제어해야 합니다.

암호화 : 로그 파일을 암호화하여 저장.
로그 파일에 대한 접근 권한을 제한
로그 정리 : 일정 기간이 지난 로그는 안전하게 삭제하거나 보관.

좋은 사례

적절한 로그 레벨 사용 : DEBUG, INFO, WARN, ERROR 등 적절한 레벨을 사용하여 로그의 중요도를 구분
민감 정보 제외 : 비밀번호, 개인 정보 등 민감한 데이터는 로그에 기록하지 않습니다.
구조화된 로그 : JSON 형식 등 구조화된 로그를 사용하면 분석이 용이합니다
로그 회전 및 보관 정책 설정 : 로그 파일이 너무 커지지 않도록 회전 설정과 보관 기간을 설정합니다.
실시간 모니터링 설정 : 의심스러운 활동을 실시간으로 탐지할 수 있도록 알림 시스템을 구축.

물론입니다! 취업 준비 중인 신입 Java/Spring 백엔드 개발자로서 보안 로깅 및 모니터링을 실습할 수 있는 몇 가지 프로젝트와 연습 과제를 제안드릴게요. 이러한 실습을 통해 실제 현장에서 요구되는 기술을 익히고 포트폴리오에 추가할 수 있습니다.

1. 기본 로깅 설정 및 활용

목표:

Spring Boot 애플리케이션에 로깅 프레임워크(SLF4J + Logback)를 설정하고 다양한 로그 레벨을 활용해보기.

실습 단계:

Spring Boot 프로젝트 생성:
- Spring Initializr를 사용하여 간단한 Spring Boot 애플리케이션을 생성하세요.
- 필요한 의존성: Spring Web, Spring Security(추후 사용).
로깅 설정:
- src/main/resources 디렉토리에 logback-spring.xml 파일을 생성합니다.
- 이전 답변에서 제공한 예시를 참고하여 기본 로깅 설정을 추가하세요.

로그 사용 예제 작성:

서비스 클래스나 컨트롤러에 Logger를 주입하고 다양한 로그 레벨(DEBUG, INFO, WARN, ERROR)을 사용하여 로그 메시지를 출력해보세요.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class SampleController {

    private static final Logger logger = LoggerFactory.getLogger(SampleController.class);

    @GetMapping("/test")
    public String testLogging() {
        logger.debug("디버그 로그 메시지");
        logger.info("정보 로그 메시지");
        logger.warn("경고 로그 메시지");
        logger.error("에러 로그 메시지");
        return "로그 테스트 완료";
    }
}

로그 파일 확인:
- 애플리케이션을 실행한 후 logs/app.log 파일을 열어 로그 메시지가 제대로 기록되는지 확인하세요.

2. Spring Security 통합 및 보안 이벤트 로깅

목표:

Spring Security를 설정하고 로그인 성공 및 실패 이벤트를 로깅하여 보안 관련 활동을 추적해보기.

실습 단계:

Spring Security 설정:

Spring Security 의존성을 추가하고 기본 보안 설정을 구성하세요.

import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        auth.inMemoryAuthentication()
            .withUser("user").password("{noop}password").roles("USER");
    }

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                .anyRequest().authenticated()
                .and()
            .formLogin()
                .permitAll()
                .and()
            .logout()
                .permitAll();
    }
}

보안 이벤트 리스너 작성:
- 앞서 설명한 SecurityEventListener 클래스를 추가하여 로그인 성공 및 실패 이벤트를 로깅하세요.
테스트:
- 애플리케이션을 실행하고 로그인 시도를 해보세요.
- logs/app.log 파일에서 로그인 성공 및 실패 로그가 기록되는지 확인합니다.

3. AOP를 이용한 메서드 로깅

목표:

AOP(Aspect-Oriented Programming)를 사용하여 특정 패키지의 모든 서비스 메서드 호출 시 로그를 자동으로 기록해보기.

실습 단계:

AOP 의존성 추가:

spring-boot-starter-aop 의존성을 pom.xml에 추가하세요.

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
</dependency>

LoggingAspect 클래스 작성:

앞서 제공한 LoggingAspect 클래스를 생성하고 원하는 패키지에 맞게 포인트컷을 수정하세요.

@Aspect
@Component
public class LoggingAspect {
    
    private Logger logger = LoggerFactory.getLogger(this.getClass());
    
    @Before("execution(* com.example.service.*.*(..))")
    public void logBefore(JoinPoint joinPoint) {
        logger.info("메서드 호출: " + joinPoint.getSignature().getName());
    }
}

서비스 클래스 작성:
- com.example.service 패키지에 간단한 서비스 클래스를 작성하고 메서드를 호출해보세요.
테스트:
- 애플리케이션을 실행하고 서비스 메서드를 호출한 후 로그에서 메서드 호출 로그가 기록되는지 확인합니다.

4. ELK Stack과 연동한 로그 중앙 관리

목표:

ELK Stack(Elasticsearch, Logstash, Kibana)을 사용하여 로그를 중앙에서 수집, 저장, 시각화해보기.

실습 단계:

ELK Stack 설치:
- 로컬 환경에 Docker를 사용하여 ELK Stack을 설치할 수 있습니다.
- ELK Docker 설정 가이드를 참고하세요.

Logstash 설정:

logstash.conf 파일을 생성하여 Logstash가 Spring Boot 애플리케이션의 로그를 수집하도록 설정합니다.

input {
    tcp {
        port => 5044
        codec => json
    }
}

output {
    elasticsearch {
        hosts => ["localhost:9200"]
        index => "spring-logs-%{+YYYY.MM.dd}"
    }
    stdout { codec => rubydebug }
}

Spring Boot에 Logstash Appender 추가:

logback-spring.xml 파일에 Logstash Appender를 추가합니다.

<appender name="LOGSTASH" class="net.logstash.logback.appender.LogstashTcpSocketAppender">
    <destination>localhost:5044</destination>
    <encoder class="net.logstash.logback.encoder.LogstashEncoder" />
</appender>

<root level="INFO">
    <appender-ref ref="FILE" />
    <appender-ref ref="LOGSTASH" />
</root>

Kibana에서 로그 시각화:
- Kibana에 접속하여 Elasticsearch에 저장된 로그를 시각화하고 대시보드를 구성해보세요.
테스트:
- 애플리케이션을 실행하고 로그를 생성한 후 Kibana에서 로그가 제대로 수집되고 시각화되는지 확인합니다.

5. 모니터링 도구(Prometheus & Grafana)와 연동

목표:

Prometheus와 Grafana를 사용하여 애플리케이션의 메트릭을 수집하고 시각화해보기.

실습 단계:

Prometheus와 Grafana 설치:
- Docker를 사용하여 Prometheus와 Grafana를 설치하고 설정하세요.
- Prometheus Docker 설정과 Grafana Docker 설정을 참고하세요.

Spring Boot 애플리케이션에 Micrometer 추가:

spring-boot-starter-actuator와 micrometer-registry-prometheus 의존성을 pom.xml에 추가합니다.

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-registry-prometheus</artifactId>
</dependency>

애플리케이션 설정:
- application.properties 파일에 Prometheus 엔드포인트를 활성화합니다.
```
management.endpoints.web.exposure.include=health,info,prometheus
```

Prometheus 설정:

prometheus.yml 파일을 수정하여 Spring Boot 애플리케이션의 Prometheus 엔드포인트를 스크랩하도록 설정합니다.

scrape_configs:
  - job_name: 'spring-boot-app'
    metrics_path: '/actuator/prometheus'
    static_configs:
      - targets: ['localhost:8080']

Grafana 대시보드 구성:
- Grafana에 접속하여 Prometheus를 데이터 소스로 추가하고, 애플리케이션의 메트릭을 시각화할 대시보드를 생성하세요.
테스트:
- 애플리케이션을 실행하고 Prometheus와 Grafana가 메트릭을 제대로 수집하고 시각화하는지 확인합니다.

6. 로그 보안 강화 실습

목표:

로그에 포함되는 민감한 정보를 보호하고 로그 파일의 접근을 제어해보기.

실습 단계:

민감 정보 필터링:
- 로그에 민감한 정보(예: 비밀번호, 개인 정보)가 포함되지 않도록 필터링하는 방법을 구현하세요.
- 예를 들어, 사용자 등록 시 비밀번호는 로그에 기록하지 않도록 설정합니다.
로그 암호화:
- 로그 파일을 암호화하여 저장하는 방법을 구현해보세요.
- Logback의 Encoder를 커스터마이징하여 로그 메시지를 암호화할 수 있습니다.
접근 제어 설정:
- 로그 파일에 대한 파일 시스템 권한을 설정하여 특정 사용자만 접근할 수 있도록 합니다.
- 예를 들어, Linux 환경에서는 chmod와 chown 명령어를 사용하여 로그 파일의 권한을 설정합니다.

로그 정리 및 보관:

Logback 설정에서 로그 회전(Rolling)과 보관 정책을 설정하여 일정 기간이 지난 로그는 자동으로 삭제하거나 아카이브되도록 합니다.

<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
    <fileNamePattern>logs/app.%d{yyyy-MM-dd}.log.gz</fileNamePattern>
    <maxHistory>30</maxHistory>
    <totalSizeCap>3GB</totalSizeCap>
</rollingPolicy>

7. 실시간 모니터링 및 알림 설정

목표:

의심스러운 활동이 감지되었을 때 실시간으로 알림을 받을 수 있도록 설정해보기.

실습 단계:

Elasticsearch Watcher 또는 Kibana Alerts 사용:
- Elasticsearch Watcher나 Kibana의 Alerting 기능을 사용하여 특정 로그 패턴(예: 다수의 로그인 실패 시도)이 발생하면 알림을 받도록 설정합니다.
Slack 또는 이메일과 연동:
- Alerting 시스템을 Slack이나 이메일과 연동하여 실시간 알림을 받을 수 있도록 설정합니다.
테스트:
- 의도적으로 특정 로그 패턴을 생성하여 알림이 제대로 작동하는지 확인합니다.

8. 포트폴리오 프로젝트 예시

프로젝트: 보안 로그 관리 시스템

기능:

사용자 인증 및 인가 기능 (Spring Security)
로그인 성공 및 실패 이벤트 로깅
서비스 메서드 호출 로깅 (AOP 활용)
ELK Stack을 통한 로그 수집 및 시각화
Prometheus와 Grafana를 이용한 메트릭 모니터링
로그 보안 강화 (민감 정보 필터링, 로그 암호화)
실시간 알림 설정 (Kibana Alerts)

기술 스택:

Backend: Java, Spring Boot, Spring Security
Logging: SLF4J, Logback
Monitoring: ELK Stack (Elasticsearch, Logstash, Kibana), Prometheus, Grafana
DevOps: Docker (ELK, Prometheus, Grafana), Git

구현 단계:

기본 기능 구현: 사용자 인증, 간단한 CRUD API 작성
로깅 설정: SLF4J와 Logback을 사용한 기본 로깅 설정
보안 이벤트 로깅: Spring Security 이벤트 리스너 구현
AOP 로깅: 서비스 메서드 호출 로그 추가
ELK Stack 연동: 로그를 ELK로 전송하고 Kibana에서 시각화
모니터링 설정: Prometheus와 Grafana를 사용하여 애플리케이션 메트릭 모니터링
로그 보안 강화: 민감 정보 필터링, 로그 암호화 및 접근 제어 설정
실시간 알림: 의심스러운 활동 발생 시 Slack이나 이메일로 알림 받기

완성 후 포트폴리오에 포함할 내용:

프로젝트 설명 및 기능 소개
구현한 로깅 및 모니터링 기능의 상세 설명
ELK Stack과의 연동 과정 및 시각화 결과
Grafana 대시보드 스크린샷
GitHub 레포지토리 링크 및 주요 코드 스니펫

9. 추가 학습 자료

Spring Boot 로깅 공식 문서: Spring Boot Logging
Spring Security 공식 문서: Spring Security Reference
ELK Stack 튜토리얼: Getting Started with ELK
Prometheus & Grafana 가이드: Prometheus Documentation, Grafana Documentation

위의 실습 과제를 통해 보안 로깅 및 모니터링에 대한 이해를 심화하고, 실제 프로젝트에 적용할 수 있는 경험을 쌓을 수 있습니다. 이러한 프로젝트는 취업 시 포트폴리오로 활용하기에도 매우 유용하며, 면접에서 실무 능력을 어필하는 데 큰 도움이 될 것입니다. 실습 중 어려운 점이나 추가적인 질문이 있다면 언제든지 문의해주세요!

김상욱

이전 포스트

파일 업로드 시 보안 고려사항은 무엇인가요?

다음 포스트

보안 로깅 및 모니터링은 어떻게 이루어지나요?