KISA 제보 3건(KVE-2026-2010/2011/2018)과 그 동일 계열 형제 결함을 전수 조치하고, 그 과정에서 드러난 두 결함군을 함께 닫는다. - 검증 시점과 연결 시점이 host 를 다르게 읽던 SSRF 통로를 정규화 SSoT 한 곳으로 모았다 - 세션을 여는 지점(2FA 완료·토큰 재발급)이 잠금 검사를 거치지 않아 계정 잠금이 우회됐다 - 인증도 서명도 없는 브라우저 리턴 콜백이 주문 상태를 바꾸던 통로를 4 PG 전부에서 닫고, 소유권을 대조하는 close-report 를 토스에도 신설했다. 그 결과 정리 주체를 잃는 결제창 미완료 주문은 만료 자동취소가 거둔다 - 저장소 A(_local)에만 쓰는 경로가 B 의 값을 조용히 덮던 회귀를 정본 writer 로 닫았다 (engine-v1.63.5). 한 방향만 보던 정적 검사에 반대 방향 축과 양방향 계약 테스트를 더했다 - 레이아웃 JSON 의 같은 객체 중복 키가 앞선 선언을 오류 없이 삼키던 결함군을 닫았다
103 lines
6.0 KiB
YAML
103 lines
6.0 KiB
YAML
# audit:allow test-scenario-coverage reason: 호스트 형태 축은 데이터 프로바이더 행으로 전개되어 메서드 단위 @scenario 마킹으로 표현할 수 없다. 조합 커버는 test_files 의 프로바이더 행이 담당하고, 본 매니페스트는 "무엇을 반드시 담아야 하는가" 의 SSoT 로 둔다.
|
|
|
|
feature: 아웃바운드 URL 호스트 정규화 (검증 시점 ↔ 연결 시점 동형)
|
|
|
|
description: |
|
|
서버가 대신 외부로 요청을 보내는 모든 지점의 호스트 판정 계약.
|
|
|
|
근본 결함: 검증기는 `strtolower(trim($host))` 만 하고, 실제로 연결하는 libcurl/libidn2 는
|
|
IDNA/UTS#46 정규화를 한다. 두 시점이 주소를 다르게 읽으면 검증기가 공개 호스트로 승인한
|
|
주소가 실제로는 루프백·사설 대역으로 연결된다 (`localhost。` → `localhost`).
|
|
|
|
불변조건: **판정하는 문자열과 연결되는 문자열이 같다.** 정규화는
|
|
`OutboundUrlValidator::normalizeHost()` 단일 지점이 수행하고, 호스트를 보는 모든 경로
|
|
(`extractSafeHost` / `isPublicHost` / `isPublicHttpUrl` / `isHostAllowed` /
|
|
`isStructurallySafeUrl`, 그리고 검증기를 경유하지 않는 형제
|
|
`NicePaymentsApiService::isNicePayUrl`) 가 그 한 곳을 재사용한다. 사본을 두지 않는다.
|
|
|
|
경계: IP 리터럴은 정규화 대상이 아니다. 호스트명 문자 집합 검사에 IPv6 의 `:` 가 걸리면
|
|
사설·예약 대역 판정 코드가 도달 불가가 되어, 정규화가 **공개 IPv6 를 전량 차단**한다.
|
|
차단 방향의 회귀라 루프백 케이스만 있는 테스트로는 드러나지 않는다.
|
|
|
|
축 설계: 판정에 실제로 영향을 주는 입력만 축으로 둔다. 소비자(스케줄·언어팩·배송 API·
|
|
결제 승인 URL)는 같은 초크포인트를 공유하므로 축이 아니라 통합 지점의 분담이다.
|
|
|
|
axes:
|
|
host_form: [ascii, ideographic_dot_u3002, fullwidth_dot_uff0e, halfwidth_dot_uff61, trailing_dot, punycode_a_label, unicode_u_label, ip_literal_v4, ip_literal_v6]
|
|
target: [loopback_or_private, public]
|
|
entry_point: [validator_unit, form_request_rule, schedule_url, language_pack_url, shipping_api_url, nicepay_approval_url]
|
|
|
|
exclusions:
|
|
- { host_form: ip_literal_v4, entry_point: nicepay_approval_url, reason: "나이스페이먼츠 승인 URL 은 도메인 suffix 비교 — IP 리터럴은 어떤 형태든 거부" }
|
|
- { host_form: ip_literal_v6, entry_point: nicepay_approval_url, reason: "동일" }
|
|
- { host_form: punycode_a_label, target: loopback_or_private, reason: "punycode 는 국제화 도메인 표기 — 루프백/사설 대역에 대응하는 A-label 이 없다" }
|
|
- { host_form: unicode_u_label, target: loopback_or_private, reason: "동일 — U-label 정규화 결과가 루프백이 되는 경우는 점 동등문자 축이 담당" }
|
|
|
|
effects:
|
|
# 정규화 SSoT
|
|
- normalize_host_is_the_single_normalization_point
|
|
- extract_safe_host_delegates_to_normalize_host
|
|
- is_public_host_delegates_to_normalize_host
|
|
- nicepay_is_nicepay_url_reuses_core_normalize_host
|
|
- no_duplicated_normalization_logic_outside_validator
|
|
|
|
# 점 동등 문자 (보고된 우회 경로)
|
|
- ideographic_full_stop_u3002_maps_to_ascii_dot
|
|
- fullwidth_full_stop_uff0e_maps_to_ascii_dot
|
|
- halfwidth_ideographic_stop_uff61_maps_to_ascii_dot
|
|
- normalized_loopback_is_denied
|
|
- normalized_private_range_is_denied
|
|
- mixed_case_variant_is_denied_after_lowercasing
|
|
- trailing_dot_is_stripped_before_comparison
|
|
|
|
# 정상 입력 회귀 방지 (차단 방향 과잉의 안전망)
|
|
- public_ascii_domain_still_allowed
|
|
- real_internationalized_domain_still_allowed
|
|
- punycode_a_label_still_allowed
|
|
- non_standard_port_public_url_still_allowed
|
|
- public_ipv4_literal_still_allowed
|
|
- public_ipv6_literal_still_allowed
|
|
- public_ipv6_literal_with_port_still_allowed
|
|
- idn_conversion_failure_denies_instead_of_passing_through
|
|
|
|
# 소비자 전파 (초크포인트 하나가 전부를 보호하는지)
|
|
- schedule_url_rejects_normalized_internal_host
|
|
- language_pack_install_from_url_rejects_normalized_internal_host
|
|
- shipping_api_endpoint_rejects_normalized_internal_host
|
|
- form_request_rule_rejects_normalized_internal_host
|
|
- userinfo_disguised_host_is_rejected
|
|
- allow_internal_outbound_setting_keeps_structural_check_only
|
|
|
|
# 형제 (검증기 미경유 경로)
|
|
- nicepay_approval_url_rejects_host_that_only_looks_like_nicepay
|
|
- nicepay_approval_url_still_accepts_official_hosts
|
|
|
|
test_files:
|
|
- tests/Unit/Support/OutboundUrlValidatorTest.php
|
|
- tests/Feature/Security/OutboundRequestGuardTest.php
|
|
- plugins/_bundled/sirsoft-pay_nicepayments/tests/Unit/Services/NicePaymentsApiServiceTest.php
|
|
|
|
manual_verification:
|
|
- description: "앱 계층 우회 실측 — 스케줄 URL 생성"
|
|
steps:
|
|
- "관리자로 스케줄 관리 진입 → URL 호출 스케줄 생성"
|
|
- "주소에 ASCII `http://localhost/` → 422 차단 확인"
|
|
- "주소에 `http://localhost。/`(U+3002) → 422 차단 확인 (수정 전 201 생성)"
|
|
- "U+FF0E · U+FF61 변종도 각각 422 확인"
|
|
- "정상 공개 도메인·국제화 도메인은 그대로 생성되는지 확인"
|
|
- description: "정상 IPv6 회귀 확인"
|
|
steps:
|
|
- "공인 IPv6 리터럴 주소(대괄호 표기)로 스케줄 생성 → 허용"
|
|
- "루프백 `[::1]` · 사설 `[fc00::1]` → 차단"
|
|
|
|
notes: |
|
|
실행 단계(정규화된 호스트로 실제 루프백 연결이 성립하는지)는 호스트 OS 리졸버에 의존한다.
|
|
앱 계층 결함은 생성 201/422 로 판정되므로 실행 단계 재현은 판정 대상이 아니다.
|
|
|
|
관련 코드:
|
|
- app/Support/OutboundUrlValidator.php (normalizeHost = SSoT)
|
|
- app/Rules/PublicOutboundUrl.php (FormRequest 게이트)
|
|
- app/Services/ScheduleService.php · app/Services/LanguagePackService.php
|
|
- modules/_bundled/sirsoft-ecommerce (배송 API 엔드포인트 검증)
|
|
- plugins/_bundled/sirsoft-pay_nicepayments/src/Services/NicePaymentsApiService.php (isNicePayUrl)
|