Set URL/Protocol Rewrite Rules

사용자가 CDNetworks CDN 플랫폼을 통해 웹사이트 콘텐츠에 액세스할 때, 콘솔에서 간단한 규칙을 구성하여 요청 URL의 프로토콜, 다양한 요청 콘텐츠, 요청 헤더 또는 사용자의 지리적 위치와 같은 다양한 기준에 따라 사용자에게 특정 콘텐츠를 전송할 수 있습니다. 현재 CDNetworks 는 특정 상태 코드와 새로운 URL 을 반환하여 클라이언트가 새 요청을 시작하도록 유도하는 URL 또는 프로토콜 재작성(rewrite) 시나리오를 지원합니다.

How to Set Up URL/Protocol Rewrite Rules

1. CDNetworks Console 에 로그인하여 적절한 제품을 선택합니다.
2. Configuration 페이지로 이동하여 구성할 도메인을 찾은 다음, 그 위의 Modify Configuration 또는 도메인 이름 오른쪽의 편집 버튼 을 클릭합니다.
3. 구성 수정 페이지에서 Page Rules 아래의 Redirects 를 찾은 다음 Add 버튼을 클릭합니다.
4. 규칙 편집 페이지에서 필요에 따라 다음 구성 항목을 추가할 수 있습니다.

Apply to
CDNetworks 에서는 콘솔에 URL 정규식을 입력하여 URL Pattern (Regex) 을 통해 사용자의 요청이 재작성 규칙에 맞는지 판단할 수 있습니다. 예를 들어, rewrite/*.(jpg|png|gif) 는 rewrite 디렉터리의 jpg|png|gif 파일에 대한 요청이 이 규칙과 일치함을 의미합니다.

Advanced Scope Conditions
규칙의 적용 범위를 위한 기본 일치 조건으로 URL Pattern 을 구성하는 것 외에도 Advanced Scope Conditions 를 클릭하여 Advanced Scope 를 통해 기타 조건을 추가할 수 있습니다. 복합 구성 항목으로 다음 매개변수 중 하나 이상을 선택할 수 있으며, 이는 기본 URL 정규식과 결합하여 AND 관계를 형성하여 규칙의 최종 범위를 결정합니다.

Exclude 로 표시된 Advanced Scope 항목은 기본 일치 규칙 범위 내의 특정 경우를 제외하는 NOT(부정)을 의미합니다. 위에 나열된 각 구성 항목은 단일 규칙에서 한 번만 나타날 수 있으며 단일 규칙에서 UA 와 Exclude User-Agent 는 상호 배타적이며, Country(및 해당 제외 항목)와 Request Header(및 해당 제외 항목)도 각각 상호 배타적입니다. 따라서 최대 4개의 고급 구성 항목이 동시에 존재할 수 있습니다.

Rewrite Type
현재 CDNetworks 에서는 Protocol Rewrite 또는 URL Rewrite 중 하나를 선택할 수 있습니다. 선택한 유형에 관계없이 클라이언트에 반환할 응답 상태 코드를 선택해야 합니다. CDNetworks 는 301;302;303;307 범위의 응답 상태 코드를 지원하며 기본값은 302 입니다.

Type 1: Protocol Rewrite
프로토콜 재작성(Protocol rewriting)은 CDN 에지 노드가 클라이언트 요청을 받을 때 프로토콜을 다시 작성하는 것을 의미합니다. 노드는 캐싱 및 원본 가져오기(origin pull)를 위해 다시 작성된 프로토콜을 사용합니다. 원본으로 다시 요청하는 동안 프로토콜만 다시 작성되는 경우 관련 규칙 구성은 HTTP/HTTPS Back to Origin 을 참조하십시오.
이 규칙에서는 HTTP -> HTTPS 또는 HTTPS -> HTTP 를 선택할 수 있습니다.

Type 2: URL Rewrite
Protocol Rewrite 와 유사하게 URL 재작성은 CDN 노드가 요청을 받을 때 수행되며 캐싱 및 원본 가져오기에 다시 작성된 URL 을 사용합니다. 원본으로 요청을 반환하는 동안 요청 URL 호스트와 포트만 교체해야 하는 경우 관련 규칙 구성은 Host Header and Port 를 참조하십시오.
URL Rewrite 의 경우 Original URL 에 다시 작성할 요청 URL 을 입력합니다. 정규식 또는 전체 URL(예: (https://[^/]+)/.* 또는 http://domain/browse/index.html?aa=1)일 수 있습니다. Target URL 에 다시 작성된 URL 을 입력하며 http:// 또는 https:// 로 시작해야 합니다.

Priority
이 규칙의 우선순위를 1~10 사이로 설정할 수 있습니다. 숫자가 높을수록 일치 및 적용 우선순위가 높음을 나타냅니다. 여러 규칙에 동일한 일치 조건이 있는 경우 우선순위가 높은 규칙만 적용됩니다.

Add 버튼을 클릭하여 규칙 페이지로 들어가 세부 매개변수를 구성하는 것 외에도 Add 버튼 옆에 있는 Quick Settings 를 클릭하여 프로토콜 또는 URL 재작성을 간단하게 구성할 수도 있습니다. 빠른 구성에서 Apply to 는 기본적으로 모든 요청으로 설정되고 응답 상태 코드는 302 가 되며, 다시 작성할 프로토콜, 원본 URL 및 대상 URL, 우선순위와 같은 나머지 구성은 모두 사용자 지정할 수 있습니다.

위의 구성을 완료한 후 Confirm 을 클릭한 다음 Next 를 선택하여 구성을 제출하십시오. 프로덕션 환경에 영향을 주지 않으려면 먼저 Pre-deploy 를 통해 테스트 환경에서 구성을 확인하는 것이 좋습니다. 구성이 올바른지 확인되면 Deploy Directly 를 클릭하여 라이브 환경에서 구성을 공식적으로 활성화합니다. 적용하는 데 일반적으로 약 3~5분이 걸립니다. 사전 배포 테스트에 대한 자세한 내용은 Verifying Configuration Effectiveness Through Pre-deployment 자습서를 참조하십시오.

Configuration Examples

Example 1: URL 정규식 및 UA, Country 필드와 일치하는 요청에 대한 프로토콜 재작성
이 규칙과 연결된 도메인의 경우 요청이 그림에 표시된 URL 정규식과 일치하고 UA 헤더가 Mozilla/4.0 이며 사용자의 국가가 Japan; South-Korea 인 경우, CDN 서버는 재작성된 프로토콜에 따른 URL 을 캐시하고 클라이언트에 반환합니다. 예를 들어 http://domain/rewrite/example.jpg 에 대한 요청은 https://domain/rewrite/example.jpg 를 반환하고, 상태 코드 303 을 함께 보내어 클라이언트가 새 프로토콜의 URL 에 대한 새 요청을 시작하도록 유도합니다.

Example 2: URL 정규식 및 UA, Country 필드, 특정 URL 과 일치하는 요청에 대한 URL 재작성
이 규칙과 연결된 도메인의 경우 요청이 그림에 표시된 URL 정규식과 일치하고 UA 헤더가 Mozilla/4.0 이며 사용자의 국가가 Japan; South-Korea 이고 지정된 Original URL 과 일치하는 경우, CDN 서버는 재작성된 URL 을 캐시하고 클라이언트에 반환합니다. 예를 들어 https://domain/rewrite/urltype1.jpg 에 대한 요청은 https://domain/target/urltype1.jpg 를 반환하고, 상태 코드 302 를 함께 보내어 클라이언트가 반환된 URL 에 대한 새 요청을 시작하도록 유도합니다.

Notes

노드가 캐싱 및 원본 요청에 재작성된 URL 을 사용하므로 재작성된 도메인은 CDNetworks CDN 플랫폼에서 가속화된 도메인이어야 합니다.
Protocol Rewrite 유형의 경우 도메인당 하나의 규칙만 허용됩니다. 이는 요청이 HTTP -> HTTPS 및 HTTP -> HTTPS 모두에 동시에 적중할 경우 발생할 수 있는 잠재적인 루프 문제를 방지하기 위한 것입니다. 여러 개의 Protocol Rewrite 규칙을 구성하려면 기술 지원 팀에 문의하십시오.