웹 보안

다운로드 0
업데이트 2026. 11. 23.

URL 정규화

URL 정규화는 요청 경로를 URL 템플릿으로 묶고 매개변수를 꺼내는 기준을 관리합니다. URL 템플릿, 동기화 상태, 테스트 세 탭으로 이루어집니다. 템플릿을 추가, 수정, 삭제하려면 관리자 권한이 필요합니다.

URL 템플릿 탭

등록된 템플릿 목록입니다. 호스트와 검색어(템플릿, 설명)로 좁히고, 행을 누르면 오른쪽에 수정 패널이 열립니다. 여러 행을 체크해 한꺼번에 삭제할 수 있습니다.

템플릿 추가와 수정

템플릿 추가를 누르거나 목록의 행을 누르면 오른쪽 패널이 열립니다.

  • 호스트: 로그를 저장한 테이블 이름입니다. 비워 두면 모든 호스트에 적용됩니다.
  • 메서드: HTTP 메서드입니다. 모두를 고르면 모든 메서드에 적용됩니다.
  • path 템플릿: 요청 경로의 패턴입니다. 아래 문법을 따릅니다.
  • path 매개변수: path 템플릿의 자리표시자마다 자동으로 생깁니다. 타입과 길이 범위를 정합니다.
  • 쿼리 매개변수: 쿼리 문자열의 키입니다. 쿼리 매개변수 추가로 이름과 타입을 등록합니다.
  • 설명: 템플릿이 무엇인지 적습니다. 예: 사용자 주문 목록

저장하면 몇 초 안에 모든 노드에 반영됩니다.

path 템플릿 문법

세그먼트마다 다음 중 하나를 씁니다.

형식의미예
고정 문자열그 문자열과 같은 세그먼트orders
:이름세그먼트 하나. 값을 이 이름의 매개변수로 꺼냅니다:order_id
:이름.확장자고정 확장자로 끝나는 세그먼트 하나. 확장자를 뺀 값을 꺼냅니다:image_id.png
*나머지 경로 전체. 마지막 세그먼트에만 씁니다/static/*
  • 템플릿은 /로 시작하고 쿼리 문자열을 포함하지 않습니다.
  • 저장할 때 소문자로 바꾸고 중복 슬래시와 끝 슬래시를 없앱니다. 매칭도 대소문자를 구분하지 않습니다.
  • 자리표시자 이름은 영문 소문자, 숫자, 밑줄로 짓고, 가리키는 대상을 나타내게 합니다. 예: :user_id, :order_id

여러 템플릿이 한 요청에 맞으면 더 구체적인 템플릿을 씁니다.

  • 정확한 호스트가 모든 호스트보다 먼저입니다.
  • 같은 호스트에서는 고정 세그먼트, :이름.확장자, :이름, * 순입니다.
  • 같은 위치에서는 정확한 메서드가 모두보다 먼저입니다.

예를 들어 /api/users/me와 /api/users/:user_id가 모두 있으면 /api/users/me 요청은 고정 템플릿에 매칭됩니다.

매개변수 타입

타입의미
객체 식별자주인이 있는 객체를 가리키는 값입니다. BOLA 탐지와 크롤링 탭은 이 타입만 봅니다. 예: 주문 번호, 계정 ID, 사용자별 문서 이름
공개 이름누구나 읽는 공개 페이지의 이름입니다. 예: 블로그 글 주소, 제품 소개 페이지 이름
숫자수량, 페이지, 크기처럼 객체를 가리키지 않는 수치
고정 값값이 몇 가지로 정해진 매개변수. 예: sort, lang
텍스트검색어 같은 자유 텍스트
URLURL이나 리다이렉트 대상. 예: return, next
미지정아직 정하지 않음
Tip
같은 경로라도 메서드에 따라 타입이 다를 수 있습니다. 앱 소개 페이지(GET)의 앱 이름은 공개 이름이지만, 같은 앱을 수정하는 요청(PUT, DELETE)에서는 객체 식별자입니다. 이런 경우 메서드를 모두로 묶지 말고 메서드별로 템플릿을 따로 등록하세요.

근거 없이 객체 식별자로 지정하면 정상 크롤링과 공개 페이지 열람이 BOLA 후보로 올라옵니다. 주체 하나가 다루는 값이 적고, 남의 값에 접근하면 401, 403, 404가 나는 매개변수만 객체 식별자로 지정하세요.

숫자가 아닌 매개변수에는 최소 길이와 최대 길이를 정할 수 있습니다. 범위를 벗어난 값은 매개변수 이상(too_short, too_long)으로 표시됩니다. 대부분의 요청이 들어가는 범위로 정하고, 드물게 튀는 긴 값에 맞추지 마세요.

동기화 상태 탭

템플릿은 분석 서버에 저장된 뒤, 행위 프로파일 websec-path-templates로 모든 노드에 배포됩니다. 이 탭에서 배포 상태를 확인합니다.

상태의미
동기화됨모든 템플릿이 노드에 반영되었습니다
빌드 중프로파일을 다시 만들고 있습니다
반영 대기저장된 템플릿이 아직 프로파일에 반영되지 않았습니다
프로파일 없음프로파일이 지워졌습니다. 재빌드를 누르면 다시 만듭니다

템플릿을 저장하거나 삭제하면 프로파일이 자동으로 다시 빌드됩니다. 상태가 오래 바뀌지 않으면 재빌드를 누르세요.

테스트 탭

요청 하나를 노드와 같은 방식으로 정규화해 봅니다. 메서드, 호스트, 요청 path를 입력하고 테스트를 누르면 다음이 나옵니다.

  • 매칭된 템플릿
  • 매개변수마다 이름, 타입, 값
  • 경로 형태(숫자, UUID 등을 토큰으로 바꾼 경로). 매칭되는 템플릿이 없을 때 새 템플릿을 정하는 데 참고합니다.

템플릿이 아직 노드에 배포되지 않았으면 그 사실이 표시됩니다.

테스트한 요청은 주소에 남으므로, 주소를 공유하면 같은 결과를 볼 수 있습니다.