서버가 외부 입력으로 목적지가 제어되는 outbound HTTP 요청을 보내는 지점을 전수 조사해, 내부망(사설 IP·루프백·링크로컬·메타데이터)과 host 위조를 차단한다. KVE-2026-1546(이니시스 인증 URL 접두사 매칭 우회)과 동일 클래스의 지점(언어팩 URL 설치, 스케줄 URL 호출, 배송비 계산 API, GitHub URL 판정)을 코어 공용 유틸 App\Support\OutboundUrlValidator 로 수렴시켰다. - 접두사 매칭을 host 완전일치로 교체 — userinfo(@) 위장과 접미사 확장 도메인 우회 벡터 차단. - 사내 서버 호출이 정당한 관리자 지점(스케줄·외부 API)은 신규 설정 security.allow_internal_outbound_urls(기본 off)로 옵트인. - 언어팩 URL 설치는 원격 코드 다운로드라 옵트인과 무관하게 내부 주소 항상 차단. - 웹소켓 연결 테스트는 localhost·사설 IP 가 정상 구성이므로 구조적 위조만 차단. 각 지점에 red 재현 → 수정 → green 회귀 테스트 + 실브라우저 E2E 로 검증. 수기 API 문서가 자동 재생성으로 소실되는 사고를 막는 PreToolUse 훅을 함께 추가한다.
94 lines
3.6 KiB
PHP
94 lines
3.6 KiB
PHP
<?php
|
|
|
|
namespace Plugins\Sirsoft\VerificationKginicis\Tests\Unit\Services;
|
|
|
|
use PHPUnit\Framework\Attributes\DataProvider;
|
|
use PHPUnit\Framework\Attributes\Test;
|
|
use Plugins\Sirsoft\VerificationKginicis\Services\InicisGateway;
|
|
use Plugins\Sirsoft\VerificationKginicis\Tests\PluginTestCase;
|
|
|
|
/**
|
|
* InicisGateway::validateAuthUrl 의 목적지 위조 차단 검증.
|
|
*
|
|
* 콜백 body 의 `authRequestUrl` 은 인증 없이 외부에서 들어오는 값이며, 이 값이 그대로
|
|
* 서버-서버 STEP3 POST 의 목적지가 된다. host 를 완전 일치로 검증하지 않으면 공격자가
|
|
* 내부망 주소나 자신의 서버로 요청을 유도해 SSRF 및 본인인증 결과 위조가 가능하다.
|
|
*/
|
|
class InicisGatewayValidateAuthUrlTest extends PluginTestCase
|
|
{
|
|
private InicisGateway $gateway;
|
|
|
|
protected function setUp(): void
|
|
{
|
|
parent::setUp();
|
|
|
|
$this->gateway = new InicisGateway;
|
|
}
|
|
|
|
/**
|
|
* 이니시스 표준 도메인은 통과한다.
|
|
*
|
|
* @param string $url 검증 대상 authRequestUrl
|
|
*/
|
|
#[Test]
|
|
#[DataProvider('validAuthUrlProvider')]
|
|
public function it_accepts_official_inicis_auth_urls(string $url): void
|
|
{
|
|
$this->assertTrue(
|
|
$this->gateway->validateAuthUrl($url),
|
|
"정상 이니시스 URL 이 거부됨: {$url}"
|
|
);
|
|
}
|
|
|
|
/**
|
|
* 표준 도메인으로 위장한 URL 은 모두 거부한다.
|
|
*
|
|
* @param string $url 검증 대상 authRequestUrl
|
|
* @param string $reason 차단 사유 (실패 메시지용)
|
|
*/
|
|
#[Test]
|
|
#[DataProvider('forgedAuthUrlProvider')]
|
|
public function it_rejects_forged_auth_urls(string $url, string $reason): void
|
|
{
|
|
$this->assertFalse(
|
|
$this->gateway->validateAuthUrl($url),
|
|
"위조 URL 이 통과함 ({$reason}): {$url}"
|
|
);
|
|
}
|
|
|
|
/**
|
|
* 정상 authRequestUrl 목록.
|
|
*
|
|
* @return array<string, array{string}>
|
|
*/
|
|
public static function validAuthUrlProvider(): array
|
|
{
|
|
return [
|
|
'표준 kssa 도메인' => ['https://kssa.inicis.com/auth/result'],
|
|
'표준 fcsa 도메인' => ['https://fcsa.inicis.com/auth/result'],
|
|
'대소문자 혼용' => ['https://KSSA.INICIS.COM/auth/result'],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 위조 authRequestUrl 목록 — 접두사 매칭 우회 벡터 전수.
|
|
*
|
|
* @return array<string, array{string, string}>
|
|
*/
|
|
public static function forgedAuthUrlProvider(): array
|
|
{
|
|
return [
|
|
'userinfo 로 루프백 위장' => ['https://kssa.inicis.com@127.0.0.1/', 'userinfo(@) 뒤가 실제 목적지'],
|
|
'userinfo 로 메타데이터 위장' => ['https://kssa.inicis.com@169.254.169.254/latest/meta-data/', '클라우드 메타데이터 탈취'],
|
|
'userinfo 로 공격자 서버 위장' => ['https://kssa.inicis.com@attacker.example/fake', '인증결과 위조'],
|
|
'접미사 확장 도메인' => ['https://kssa.inicis.com.attacker.example/fake', '공격자 소유 도메인'],
|
|
'하이픈 접미사' => ['https://fcsa.inicis.com-evil.example/', '공격자 소유 도메인'],
|
|
'내부 IP 직접 지정' => ['https://127.0.0.1/', '내부망 직접 타격'],
|
|
'경로에만 표준 도메인' => ['https://attacker.example/https://kssa.inicis.com', '경로 위장'],
|
|
'http 다운그레이드' => ['http://kssa.inicis.com/auth', '평문 전송'],
|
|
'scheme 부재' => ['//kssa.inicis.com/auth', 'scheme 부재'],
|
|
'빈 문자열' => ['', '입력 없음'],
|
|
];
|
|
}
|
|
}
|