IntelliJ IDEA에서 HTTP Toolkit 프록시 설정하기

Spring Boot 애플리케이션을 개발할 때 외부 API 요청을 모니터링하고 디버깅하기 위해 HTTP Toolkit을 사용하는 경우가 많습니다. 이 글에서는 IntelliJ IDEA에서 HTTP Toolkit으로 프록시 설정하는 방법을 단계별로 설명하겠습니다.

1. HTTP Toolkit 설정

먼저 HTTP Toolkit을 실행하고 프록시 서버를 시작합니다.

1. HTTP Toolkit 실행

2. "Intercept HTTP" 클릭

3. 프록시 포트 확인 (기본값: 8000번 포트)

2. IntelliJ IDEA에서 사용하는 JDK 확인

프록시 설정 전에 IntelliJ에서 사용하는 JDK 버전을 확인해야 합니다. 이는 후에 HTTPS 인증서 문제를 해결할 때 중요합니다.

프로젝트 JDK 확인

1. File → Project Structure (또는 Cmd + ;)

2. Project Settings → Project

3. Project SDK 확인

   • 예: corretto-17.0.15, openjdk-11, Oracle OpenJDK 21 등

IntelliJ에서 JDK 경로 확인

터미널을 사용하지 않고 IntelliJ에서 직접 JDK 경로를 확인할 수 있습니다.

1. File → Project Structure (또는 Cmd + ;)

2. Platform Settings → SDKs 선택

3. 사용 중인 JDK 선택 (예: corretto-17)

4. JDK home path 확인

   • 예: ~/Library/Java/JavaVirtualMachines/corretto-17.0.15/Contents/Home

이 경로가 나중에 인증서를 추가할 때 필요한 Java 설치 경로입니다.

3. IntelliJ IDEA 프록시 설정

방법 1: Run Configuration에서 JVM 옵션 설정 (권장)

가장 간단하고 효과적인 방법입니다.

1. Run → Edit Configurations

2. 해당 Spring Boot 애플리케이션 선택

3. VM options 필드에 다음 옵션 추가:

-Dhttp.proxyHost=127.0.0.1
-Dhttp.proxyPort=8000
-Dhttps.proxyHost=127.0.0.1
-Dhttps.proxyPort=8000

방법 2: Environment Variables 설정

같은 Run Configuration에서 Environment variables에 추가:

HTTP_PROXY=http://127.0.0.1:8000
HTTPS_PROXY=http://127.0.0.1:8000

방법 3: IDE 전체 프록시 설정

IDE 전체에 프록시를 적용하려면:

1. File → Settings (또는 Cmd + ,)

2. Appearance & Behavior → System Settings → HTTP Proxy

3. Manual proxy configuration 선택

4. HTTP와 HTTPS 프록시 설정:

   • Host: 127.0.0.1

   • Port: 8000

5. Check connection 버튼으로 연결 테스트

4. HTTPS 인증서 문제 해결

HTTP 요청은 바로 캡처되지만, HTTPS 요청 시 다음과 같은 SSL 에러가 발생할 수 있습니다:

javax.net.ssl.SSLHandshakeException: PKIX path building failed: 
sun.security.provider.certpath.SunCertPathBuilderException: 
unable to find valid certification path to requested target

이 문제를 해결하기 위해 HTTP Toolkit의 CA 인증서를 Java keystore에 추가해야 합니다.

HTTP Toolkit CA 인증서 위치 확인

# macOS
ls -la ~/Library/Preferences/httptoolkit/ca.pem

# Windows
dir %APPDATA%\httptoolkit\ca.pem

# Linux
ls -la ~/.config/httptoolkit/ca.pem

Java keystore에 인증서 추가

앞서 확인한 JDK 경로를 사용하여 인증서를 추가합니다:

# 일반적인 macOS OpenJDK 경로
sudo keytool -import -alias httptoolkit \
  -keystore /Library/Java/JavaVirtualMachines/openjdk-11.jdk/Contents/Home/lib/security/cacerts \
  -file ~/Library/Preferences/httptoolkit/ca.pem \
  -storepass changeit -noprompt

# Amazon Corretto 17 예시
sudo keytool -import -alias httptoolkit \
  -keystore ~/Library/Java/JavaVirtualMachines/corretto-17.0.15/Contents/Home/lib/security/cacerts \
  -file ~/Library/Preferences/httptoolkit/ca.pem \
  -storepass changeit -noprompt

인증서 추가 확인

keytool -list -keystore /path/to/java/lib/security/cacerts \
  -storepass changeit | grep httptoolkit

성공 시 출력:

httptoolkit, 2025. 7. 8., trustedCertEntry,

5. 설정 확인 및 테스트

1. 애플리케이션 완전 종료

2. IntelliJ 재시작 (선택사항)

3. HTTP Toolkit 실행 및 프록시 시작

4. Spring Boot 애플리케이션 실행

5. API 요청 실행 후 HTTP Toolkit에서 캡처 확인

6. 문제 해결 팁

프록시가 작동하지 않는 경우

1. HTTP Toolkit 프록시 포트 확인 (기본값: 8000)

2. 방화벽 설정 확인

3. IntelliJ 재시작

4. JVM 옵션 오타 확인

인증서 관련 오류

1. 올바른 JDK 경로 사용 확인

2. keytool 명령어 실행 권한 확인

3. 이미 추가된 인증서 확인

# 기존 인증서 삭제 후 재추가
sudo keytool -delete -alias httptoolkit \
  -keystore /path/to/java/lib/security/cacerts \
  -storepass changeit

# 재추가
sudo keytool -import -alias httptoolkit \
  -keystore /path/to/java/lib/security/cacerts \
  -file ~/Library/Preferences/httptoolkit/ca.pem \
  -storepass changeit -noprompt

마무리

IntelliJ IDEA에서 HTTP Toolkit 프록시 설정은 API 디버깅과 모니터링에 매우 유용합니다. 특히 외부 API 연동 시 요청/응답 데이터를 실시간으로 확인할 수 있어 개발 효율성이 크게 향상됩니다.

권장 설정 순서:

1. JDK 버전 확인

2. Run Configuration에서 JVM 옵션 설정

3. HTTPS 인증서 추가 (필요시)

4. 애플리케이션 재시작 후 테스트

이 방법을 통해 모든 HTTP/HTTPS 요청을 HTTP Toolkit에서 캡처하고 분석할 수 있습니다.