Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
iron-proxy — 신뢰할 수 없는 워크로드를 위한 이그레스 방화벽. | Kitploit
도구/GitHubGitHub/paradigmxyz/iron-proxy
Container SecurityWeb Proxies & InterceptionData ExfiltrationWeb SecurityNetwork SecurityCloud SecurityDevSecOpsDatabase Security
GitHubparadigmxyz/iron-proxy

iron-proxy

신뢰할 수 없는 워크로드를 위한 이그레스 방화벽.

저장소 보기
8736616617시간 33분 전Kitploit 검토 완료
공유
웹사이트

iron-proxy

Docs Latest Release Docker Pulls

문제

CI 작업, AI 코딩 에이전트, 샌드박스 컨테이너는 임의의 아웃바운드 요청을 보낼 수 있습니다. 침해된 의존성, 프롬프트 인젝션, 또는 악의적인 빌드 단계는 시크릿을 유출하거나, 외부로 신호를 보내거나, 리버스 셸을 열 수 있습니다. 대부분의 팀은 자신의 워크로드에서 무엇이 나가는지 전혀 볼 수 없으며, 이를 막을 방법은 말할 것도 없습니다.

iron-proxy가 하는 일

iron-proxy는 내장 DNS 서버를 갖춘 MITM 이그레스 프록시로, 신뢰할 수 없는 워크로드와 인터넷 사이에 위치합니다. 네트워크 경계에서 기본 거부(default-deny)를 적용하므로, 워크로드는 명시적으로 허용한 도메인에만 접근할 수 있습니다. 실제 시크릿은 샌드박스에 절대 들어가지 않습니다. 워크로드는 프록시 토큰을 사용하고, iron-proxy가 이그레스 시점에 실제 자격 증명으로 교체하므로, 침해된 워크로드는 프록시 외부에서는 무용지물인 토큰만 유출할 수 있습니다.

단일 바이너리. 단일 YAML 설정.

  • 기본 거부 이그레스. 모든 아웃바운드 요청은 목적지가 허용 목록과 일치하지 않는 한 차단됩니다. 도메인과 CIDR을 나열하면, 그 외의 모든 것은 403을 받습니다.
  • 업스트림 IP 거부 목록. 호스트가 허용되어 있더라도, 확인된 주소가 거부된 CIDR 내부에 있으면 프록시는 연결을 거부합니다. 이는 허용 목록에 있는 호스트명이 IMDS나 루프백을 가리키는 SSRF/DNS 리바인딩 격차를 막습니다. 클라우드 메타데이터 엔드포인트(169.254.169.254, fd00:ec2::254, fd20:ce::254)와 루프백은 기본적으로 거부되며, proxy.upstream_deny_cidrs 또는 IRON_PROXY_UPSTREAM_DENY_CIDRS로 재정의할 수 있습니다.
  • 경계 수준 시크릿 주입. 워크로드는 프록시 토큰을 보내고, iron-proxy는 요청이 나가기 전에 이를 실제 시크릿으로 교체합니다. 샌드박스가 침해되면 공격자는 프록시 외부에서 무용지물인 토큰만 얻게 됩니다.
  • 요청별 감사 추적. 모든 요청은 전체 변환 파이프라인 결과와 함께 구조화된 JSON으로 기록됩니다: 어떤 시크릿이 교체되었는지, 어떤 규칙이 일치했는지, 무엇이 왜 차단되었는지.
  • 스트리밍 인식. WebSocket 업그레이드와 Server-Sent Events는 기본적으로 프록시됩니다. 장기 연결을 유지하는 에이전트 워크로드에 특별한 설정이 필요하지 않습니다.
  • 명시적 프록시 지원. HTTP_PROXY, HTTPS_PROXY, 또는 SOCKS5 설정을 통해 프록시 구성을 기본 지원하는 도구를 위한 선택적 터널 리스너.
  • PostgreSQL MITM 프록시. 클라이언트를 프록시가 관리하는 자격 증명으로 인증하고, 업스트림 세션에 SET ROLE을 주입하며, SQL AST 순회를 통해 클라이언트의 역할 변경 시도(SET ROLE, 모든 set_config 호출, DO 블록, 안전하지 않은 함수 정의, CREATE AGGREGATE처럼 함수를 콜백으로 바인딩하는 정의 등)를 거부하는 선택적 리스너. SQL 및 PL/pgSQL 루틴 본문은 재귀적으로 검사되며, 동적 PL/pgSQL과 지원되지 않는 루틴 언어는 거부됩니다. 심층 방어로, 주입된 역할에서 pg_catalog.set_config에 대한 EXECUTE와 불필요한 TEMPORARY / CREATE 권한을 회수하고(예: PUBLIC에서), 프록시가 세션 설정에 사용하는 로그인 사용자에게만 set_config를 다시 부여하십시오. 프록시는 항상 업스트림 세션에 standard_conforming_strings=on과 client_encoding=UTF8을 고정하고 클라이언트의 변경 시도를 거부하므로, 프록시의 SQL 파서와 서버가 문장 토큰화 방식에 대해 일치합니다. 애플리케이션이 공유 서비스 계정 사용자로 연결할 때 PostgreSQL 행 수준 보안과 결합하여 테넌트별 데이터 격리를 제공합니다. PgBouncer를 사용하는 경우 pool_mode = session으로 실행해야 합니다 — 트랜잭션 또는 문장 풀 모드는 쿼리 사이에 백엔드를 조용히 다시 바인딩하여 정책을 무력화합니다. 자세한 내용은 docs.iron.sh를 참조하십시오.

CI 파이프라인, GitHub Actions, AI 에이전트(Claude Code, Cursor, Codex), 그리고 완전히 신뢰하지 않는 코드를 실행하는 모든 환경을 위해 만들어졌습니다.

차단된 유출 + 시크릿 재작성이 작동하는 모습:

설치

Docker 이미지는 Docker Hub에서 이용할 수 있으며, Linux/macOS(amd64/arm64)용 사전 빌드된 바이너리는 GitHub Releases에서 제공됩니다.

또는 소스에서 빌드할 수 있습니다:

go build -o iron-proxy ./cmd/iron-proxy

빠른 시작

cd examples/docker-compose
docker compose up

iron-proxy와 프록시를 통해 다섯 개의 요청을 보내는 데모 클라이언트를 시작합니다. 로그를 확인하여 허용된 요청, 차단된 요청, 시크릿이 재작성된 요청을 확인하세요:

docker compose logs proxy

모든 요청은 구조화된 JSON 감사 항목을 생성합니다:

{
  "host": "httpbin.org",
  "method": "GET",
  "path": "/headers",
  "action": "allow",
  "status_code": 200,
  "duration_ms": 142,
  "request_transforms": [
    { "name": "allowlist", "action": "continue" },
    {
      "name": "secrets",
      "action": "continue",
      "annotations": { "swapped": [{ "secret": "OPENAI_API_KEY", "locations": ["header:Authorization"] }] }
    }
  ]
}

거부된 요청에는 rejected_by 필드가 포함되며 WARN 수준으로 로그에 기록됩니다. 전체 스키마는 감사 로그 형식을 참조하세요.

프로덕션 사용

1. CA 생성

iron-proxy는 사용자가 제공한 CA로 서명된 리프 인증서를 즉석에서 생성하여 TLS를 종료합니다. 클라이언트 컨테이너는 이 CA를 신뢰해야 합니다.

mkdir -p certs
openssl genrsa -out certs/ca.key 4096
openssl req -x509 -new -nodes \
    -key certs/ca.key \
    -sha256 -days 3650 \
    -subj "/CN=iron-proxy CA" \
    -addext "basicConstraints=critical,CA:TRUE" \
    -addext "keyUsage=critical,keyCertSign" \
    -out certs/ca.crt

2. Docker 네트워크 생성

iron-proxy가 컨테이너들이 DNS를 가리킬 수 있도록 고정 IP를 필요로 합니다:

docker network create --subnet=172.20.0.0/24 iron-proxy

3. iron-proxy 시작

비밀 정보를 담은 env 파일을 생성합니다(버전 관리에서 제외하세요):

echo "OPENAI_API_KEY=sk-real-key" > .env
docker run -d --name iron-proxy \
  --network iron-proxy --ip 172.20.0.2 \
  -v $(pwd)/proxy.yaml:/etc/iron-proxy/proxy.yaml:ro \
  -v $(pwd)/certs/ca.crt:/etc/iron-proxy/ca.crt:ro \
  -v $(pwd)/certs/ca.key:/etc/iron-proxy/ca.key:ro \
  --env-file .env \
  ironsh/iron-proxy:latest -config /etc/iron-proxy/proxy.yaml

4. 프록시를 통해 컨테이너 라우팅

가장 간단한 방법은 DNS 기반 라우팅입니다. 컨테이너의 DNS를 iron-proxy로 지정하면 모든 호스트 이름 조회가 프록시 IP로 확인되어 트래픽이 자동으로 프록시를 통해 라우팅됩니다:

docker run --rm \
  --network iron-proxy \
  --dns 172.20.0.2 \
  -v $(pwd)/certs/ca.crt:/certs/ca.crt:ro \
  curlimages/curl --cacert /certs/ca.crt https://httpbin.org/get

더 강력한 적용을 위해 nftables 규칙을 계층화하여 비프록시 이그레스를 차단하거나, 커널 수준 가로채기를 위해 TPROXY를 사용하세요. 각 접근 방식에 대한 자세한 내용은 프록시로 트래픽 라우팅을 참조하세요.

iron-proxy를 사용하는 이유?

iron-proxySquidmitmproxyEnvoy
기본 거부 이그레스내장복잡한 ACL 구성 필요사용자 정의 스크립팅 필요RBAC/필터 구성 필요
시크릿 주입내장아니요아니요아니요
구조화된 감사 로깅내장, 변환별 추적기본 액세스 로그플러그인 기반구성 가능한 액세스 로그
설정 복잡성단일 바이너리 + YAML방대한 구성 언어Python 스크립팅복잡한 YAML 또는 컨트롤 플레인

iron-proxy는 신뢰할 수 없는 워크로드의 이그레스를 제어하고 감사하는 단 하나의 목적을 위해 설계되었습니다. Squid는 기본 거부를 수행할 수 있지만 상당한 ACL 구성이 필요하며 시크릿 주입이라는 개념이 없습니다. mitmproxy는 훌륭한 디버깅 도구이지만 프로덕션 적용을 위해 설계되지 않았습니다. Envoy는 이 작업의 일부를 수행하도록 구성할 수 있는 범용 프록시이지만, 문제가 요구하는 것보다 훨씬 더 많은 복잡성을 수반합니다.

작동 방식

iron-proxy는 DNS 서버와 HTTP/HTTPS 프록시를 실행합니다. 컨테이너의 DNS를 iron-proxy로 지정하면 모든 호스트 이름 조회가 프록시 IP로 확인되어 트래픽이 자동으로 프록시를 통해 라우팅됩니다. 프록시는 TLS를 종료하고(제공한 CA에서 즉석으로 리프 인증서 생성), 요청을 순서가 지정된 변환 파이프라인을 통해 실행한 후 업스트림으로 전달하며, 응답을 다시 파이프라인을 통해 실행합니다.

Container → DNS lookup → iron-proxy IP → TLS termination → transforms → upstream

변환은 순서대로 실행됩니다. 내장 변환:

변환수행하는 작업
allowlist일치하는 도메인/CIDR에 대한 요청을 허용하고, 그 외의 모든 요청은 거부합니다(403).
secrets프록시 토큰을 찾기 위해 헤더(및 선택적으로 쿼리, 경로 또는 본문)를 스캔하고 환경 변수의 실제 시크릿으로 교체합니다.
body_capture일치하는 호스트의 디코딩된 요청 본문을 request_body 감사 필드로 기록합니다. 관찰 전용이며, 절대 거부하지 않습니다.

구성

iron-proxy는 단일 플래그 -config path/to/config.yaml을 받습니다. 다음은 전체 형태입니다(복사해서 바로 사용할 수 있는 시작점은 iron-proxy.example.yaml을 참조하세요):

도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

아직 인기 데이터가 없습니다.

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →