API 보안 테스트는 다소 불편한 질문에서 시작됩니다. 현재 애플리케이션이 노출하는 엔드포인트는 몇 개입니까? OpenAPI 사양에 명시된 엔드포인트가 아니라, 코드가 실제로 제공하는 엔드포인트를 말하는 것입니다.
대부분의 팀에게 있어 이 두 숫자는 일치하지 않습니다. 사양서는 몇 달 전에 작성되었지만 코드는 계속 변경되었고, 그 과정에서 내부 경로, 내보내기 엔드포인트, 그리고 아무도 문서화하지 않은 이전 버전들이 생겨났습니다. 이것들은 섀도우 API이며, 아무도 존재를 모르는 것은 테스트할 수 없습니다.
TL; DR
API 보안 테스트는 두 단계로 진행됩니다. 코드 기반 검증과 런타임 시 검증이 그것입니다.
보유하고 있는지조차 모르는 API는 보호할 수 없습니다. API 보안 테스트는 신뢰할 수 있는 인벤토리에서 시작하며, 가장 신뢰할 수 있는 소스는 사양서가 아니라 코드 자체입니다.
- 재고 변동: 코드와 사양을 비교해 보면 존재하지만 문서화되지 않은 엔드포인트(섀도우 API)와 문서화되었지만 더 이상 사용되지 않는 작업(고아 API)이 드러납니다. OWASP API9:2023.
- 핸들러의 결함: API 결함 중 상당수는 인젝션 버그가 아닙니다. 소유권 확인 누락(BOLA), 역할 확인이 없는 관리자 경로, 또는 필요 이상으로 많은 필드를 반환하는 응답과 같은 문제입니다. 이러한 결함은 핸들러 코드를 읽어보면 가장 잘 파악할 수 있습니다.
- 실행 증명: 런타임 테스트는 코드가 제시하는 내용을 확인시켜 줍니다. 즉, 어떤 엔드포인트가 인증 없이 응답하는지, 게이트웨이가 이미 어떤 부분을 보완하는지, 그리고 배포된 애플리케이션에서 어떤 취약점이 있는지 등을 파악할 수 있습니다.
- 문제당 하나의 결과만 제시하십시오. 두 계층을 합치면 문제당 하나의 결과만 제공되며, 해당 문제가 드러내는 데이터(개인 정보, 결제 정보, 건강 정보, 자격 증명)에 따라 순위가 매겨집니다.
첫 번째 단계: 코드에서 API 인벤토리를 구축하고, 이를 OpenAPI 사양과 비교한 다음, 문서화된 부분뿐만 아니라 전체 카탈로그를 대상으로 런타임 테스트를 실행하세요.
일반적인 API 보안 테스트가 부족한 이유는 무엇일까요?
대부분의 팀은 세 가지 요소로 API를 보호합니다. 엣지에서 인증을 시행하는 게이트웨이, 사양을 검사하는 스캐너, 그리고 1년에 한두 번 실시하는 수동 침투 테스트입니다. 이 세 가지 모두 도움이 되지만, 공통적인 사각지대가 있습니다.
이 모든 것은 어떤 엔드포인트가 존재하는지 누군가가 알고 있다는 전제하에 이루어집니다. 스캐너는 명세에 있는 것만 테스트합니다. 침투 테스트는 주어진 범위 내에서만 수행됩니다. 게이트웨이는 엣지에서 인증을 강제하지만, 핸들러가 주문 4512가 요청한 사용자의 것인지 확인하지 않는다는 사실은 알 수 없습니다.
그래서 OWASP API 보안 상위 10개 부적절한 재고 관리에 대한 전체 카테고리를 마련했습니다.API9:2023그리고 가장 큰 위험 요소가 서명이나 주입 패턴이 없는 논리적 결함인 객체 수준 권한 부여 오류(API1)인 이유를 설명합니다.
1단계: 코드로 구축된 API 인벤토리
신뢰할 수 있는 API 보안 테스트는 변하지 않는 유일한 원천인 코드로부터 구축된 인벤토리에서 시작됩니다. Xygeni API 보안 이 도구는 의존성 매니페스트를 검사하고, 사용 중인 웹 프레임워크를 감지하며, 여러 파일에 걸쳐 선언된 경로를 포함하여 모든 엔드포인트를 추출합니다.
이 프로그램은 Spring Boot, ASP.NET Core, Django, FastAPI, Express, Laravel 등 주요 서버 측 언어의 인기 있는 웹 프레임워크를 읽어들입니다. 오픈 API 3.x 그리고 Swagger 2.x 사양을 사용합니다. 결과적으로 서비스, 모듈 및 엔드포인트의 카탈로그가 생성되며, 여기에는 해당 메서드, 매개변수, 요청 본문 및 응답 형식이 포함됩니다.
코드와 사양서를 나란히 놓고 보면 차이점이 확연히 드러납니다.
- 섀도우 API: 코드가 제공하는 엔드포인트이지만 사양서에는 문서화되어 있지 않습니다.
- 고아 API: 더 이상 처리되는 핸들러가 없는 특정 작업입니다.
탐지 기능을 활성화할 준비가 되지 않았다면, 검색 모드가 자체적으로 카탈로그와 부족한 부분을 구축합니다. 이는 개발팀과 대화를 시작하면서 처음부터 불필요한 정보를 추가하지 않고도 문제를 해결할 수 있는 좋은 방법입니다.
핸들러를 읽으면서 어떤 오류를 발견할 수 있나요?
많은 API 결함은 인젝션 버그가 아니라 누락된 검사 때문입니다. Xygeni는 라우트, 핸들러 및 스펙을 함께 읽기 때문에 패턴 기반 스캐너로는 발견할 수 없는 결함을 표현할 수 있습니다. 모든 발견 사항은 OWASP API 보안 Top 10(2023) 범주 및 CWE에 매핑됩니다.
코드 읽기를 통해 발견할 수 있는 API 결함
각 결함은 해당 범주에 매핑됩니다. OWASP API 보안 상위 10개따라서 조사 결과는 감사자와 침투 테스트 담당자가 사용하는 언어와 동일한 언어로 전달됩니다.
| 결점 | 코드에서 무엇을 찾는가 | OWASP 카테고리 |
|---|---|---|
| 손상된 개체 수준 권한 부여볼라 / 이도르 | 요청에서 ID를 사용하여 객체를 로드할 때 해당 객체가 사용자에게 속하는지 여부를 확인하지 않는 엔드포인트 | API1 |
| 과도한 데이터 노출 | 필요 이상으로 많은 필드를 반환하는 응답 | API3 |
| 기능 수준 권한 부여 오류 | 역할 확인 없이 관리자 경로 접근 | API5 |
| 인증되지 않은 엔드포인트 및 대량 할당 | 경로를 열고, 허용해서는 안 되는 필드를 허용하는 요청 본문을 보냅니다. | API2 및 API3 |
| 섀도우 및 오펀 API | 코드와 사양서의 차이점 | API9 |
BOLA의 경우, 언어별 분석은 소유권 확인, 저장소 범위 지정 및 ID 바인딩을 검사합니다. 또한 프레임워크 구성에 중앙 집중식으로 선언된 권한 부여 규칙을 해결하며, 사용자 지정 소유권 확인 함수 이름을 추가하여 불필요한 정보를 더욱 줄일 수 있습니다. GraphQL API는 별도의 특정 검사를 수행합니다.
우선순위를 바꾸는 핵심 요소는 모든 필드에 개인 정보, 결제 정보, 건강 정보, 자격 증명 또는 암호화 데이터라는 태그가 지정된다는 점입니다. 인증되지 않은 엔드포인트에서 개인 데이터가 반환될 경우, 사소한 문제들 뒤에 묻히지 않고 중요한 문제로 분류됩니다.
2단계: 런타임 테스트
코드는 발생할 수 있는 일을 알려주고, 런타임 테스트는 실제로 발생하는 일을 알려줍니다. 완벽한 API 보안 테스트에는 이 두 가지 관점이 모두 필요하며, Xygeni는 동일한 엔드포인트 인벤토리를 통해 세 가지 수준에서 이 두 가지를 연결합니다.
- API 보안 실시간 점검. 이 기능은 인증 결과를 확인하거나 반박하기 위해 후보 엔드포인트별로 비파괴적인 요청을 한 번씩 보냅니다. 환경에서 401 또는 403 오류가 발생하면 해당 결과는 반박된 것으로 표시됩니다. 이는 게이트웨이가 이미 해당 문제를 해결했음을 나타냅니다.
- 자이제니 다스트. 이 기능은 서명된 Docker 이미지를 사용하여 웹 앱과 API를 실행하는 것을 테스트하며, 이 이미지는 사용자의 CI 러너 또는 내부 네트워크에서 실행됩니다. 프로덕션 환경에서는 공격 페이로드를 전송하지 않는 수동 강도 테스트를 사용합니다. 능동적인 테스트를 위해서는 테스트 계정이 있는 스테이징 환경을 사용하는 것이 좋습니다.
- AI 침투 테스트. AI 에이전트는 승인된 대상에 대해 피해를 주지 않는 공격을 계획하고 실행하여 어떤 발견 사항이 악용 가능한지 입증하고, 이를 OWASP API 보안 Top 10에 매핑합니다.
하나의 문제, 하나의 발견
인벤토리와 런타임 테스트를 결합하는 것의 가치는 단순히 알림 수를 늘리는 데 있는 것이 아닙니다. 오히려 알림 수를 줄이고 정확도를 높이는 데 있습니다. AI SAST 핸들러에서 발견된 사항, 실행 중인 엔드포인트에 대한 DAST 결과 및 API 결함은 서로 연관되어 있습니다. ASPM 위험도 그래프(민감도 태그 포함).
코드 기반 API 인벤토리와 런타임 테스트 기반 인벤토리
어느 한쪽이 다른 쪽을 대체하는 것은 아닙니다. 완벽한 API 보안 테스트는 동일한 엔드포인트 인벤토리를 통해 연결된 두 계층 모두를 사용합니다.
| 외형 치수 | 코드에서 API 인벤토리를 관리합니다. | 런타임 테스트 |
|---|---|---|
| 실행될 때 | 배포 전, 모든 pull request | 배포된 애플리케이션(스테이징 환경 또는 프로덕션 환경의 패시브 애플리케이션)에 대해 |
| 가장 잘 보는 것 | 섀도우 API, BOLA, 역할 확인 누락, 데이터 노출 | 실제로 답변이 되는 것은 무엇일까요? 환경 구성, 취약점 |
| 다른 층에 무엇을 제공하는가 | 테스트할 엔드포인트 전체 목록 | 코드의 내용에 대한 확인 또는 반박 |
핸들러의 결함과 해당 핸들러에 도달하는 노출된 엔드포인트는 하나의 문제이며, 그 책임은 하나뿐입니다. 이미 다른 DAST 도구를 실행 중인 경우, Xygeni는 해당 도구를 교체할 필요 없이 결과를 동일한 위험 보기로 가져옵니다.
두 레이어가 함께 작동하는 모습을 보고 싶으신가요? 저희 세션을 시청하세요 코드에서 런타임까지: 그 이유는 무엇일까요? SAST + DAST는 모두 최신 애플리케이션 보안에 필수적입니다.코드 분석 결과와 런타임 테스트 결과가 서로를 어떻게 확인하는지 살펴보겠습니다.
API 보안 테스트를 개발 라이프사이클에 통합하는 방법
중규모 팀에 가장 효과적인 패턴은 간단합니다.
- 매번 pull request: CI 환경에서 변경된 코드에 대한 API 보안을 강화하고, 증분 DAST 스캔을 수행합니다.
- 전 commit: 등 pre-commit 준비된 파일에 대한 게이트.
- 매일 밤 또는 병합 시: 전체 DAST 스캔.
- 주요 릴리스 이전: AI 침투 테스트를 스테이징 환경에 적용하여 백로그를 검증하고 각 수정 사항이 취약점을 해결했는지 확인합니다.
API 보안 스캐너는 에어갭 환경을 포함한 모든 곳에서 실행되며 Xygeni SaaS 또는 귀사의 시스템에 보고합니다. on-premise 플랫폼입니다. 결과는 JSON 형식으로 출력됩니다. 사리프 2.1.0CSV 및 Markdown용 pull request 댓글이 있습니다.
API 보안 테스트 및 규정 준수
은행, 보험 또는 공공 부문 팀의 경우 API 보안 테스트는 증거 자료로도 활용됩니다. 모든 발견 사항에는 규정 준수 태그가 부착됩니다. GDPR 제32조, PCI DSS 4.0 (요건 3.4, 6.4.3, 7.1, 7.2 및 8) 및 NIST SP 800-53 (AC-3, AC-6, IA-2, IA-5)는 플랫폼과 JSON 및 SARIF 출력에서 확인할 수 있습니다.
귀하의 조직이 다음 범주에 속하는 경우 도라 or 국정원2런타임 테스트는 규제 기관에서 여전히 요구하는 수동 침투 테스트 사이에 지속적인 증거를 제공합니다.
문서에 작성한 API가 아니라 실제로 사용하는 API를 테스트하세요.
API 보안 테스트는 단순히 사양서만 읽는 방식으로는 실제로 실행하는 API가 아닌, 있다고 생각하는 API만 테스트하는 것과 같습니다. 코드 기반으로 취약점 목록을 구축하고, 런타임 테스트로 이를 확인한 후, 엔드포인트가 노출하는 데이터 양을 기준으로 각 취약점의 순위를 매기세요.
내 코드가 노출하는 모든 엔드포인트를 확인하고 싶으신가요? 엔지니어와 상담 세션을 예약하여 저장소의 API 인벤토리를 구축하고 결과를 검토해 보세요. 또는 지금 바로 코드 및 종속성 스캔을 무료로 시작해 보세요!
자주 묻는 질문
이미 API 게이트웨이가 있는 경우에도 API 보안 테스트가 필요한가요?
네. 게이트웨이는 엣지에서 인증을 시행하지만, 핸들러 내부에서 소유권 확인이 누락되었거나 응답에 필드가 너무 많은 경우는 감지할 수 없습니다. Xygeni의 실시간 검사 기능은 게이트웨이가 이미 이러한 문제를 해결한 부분을 '반박됨'으로 표시해 줍니다.
숨겨진 API 또는 문서화되지 않은 API는 어떻게 찾을 수 있나요?
코드에서 제공하는 기능과 사양 문서에서 설명하는 기능을 비교하세요. Xygeni API Security는 이 작업을 자동으로 수행합니다. 소스 코드에서 엔드포인트를 검색하고, OpenAPI 또는 Swagger 사양에 누락된 엔드포인트를 섀도우 API로 표시하며, 핸들러가 없는 사양 작업은 고아(orphan)로 표시합니다.
실제 운영 환경에서 런타임 테스트를 실행하는 것이 안전한가요?
Xygeni DAST의 수동적 강도 테스트는 공격 페이로드를 전송하지 않고, 요청 속도를 제한할 수 있으며, X-Xygeni-DAST 헤더로 트래픽을 식별하기 때문에 안전합니다. 능동적 테스트 및 AI 침투 테스트의 경우, 테스트 계정을 사용하는 스테이징 환경을 권장합니다.







