Akamai(BYOCDN)

이 구성은 에이전틱 트래픽(AI 봇 및 LLM 사용자 에이전트의 요청)을 Edge Optimize 백엔드 서비스(live.edgeoptimize.net)로 라우팅합니다. 사람 방문자와 SEO 봇은 기존과 동일하게 사용자의 원본 서버에서 계속 제공됩니다. 구성을 테스트하려면 설정이 완료된 후 응답에서 헤더 x-edgeoptimize-request-id를 찾습니다.

사전 요구 사항

Akamai Property Manager 규칙을 설정하기 전에 다음을 확인하십시오.

  • 도메인에 대한 Akamai Property Manager 액세스
  • LLM Optimizer UI에서 검색한 Edge Optimize API 키 단계는 API 키 검색을 참조하십시오.
  • (선택 사항) 스테이징 라우팅을 테스트하려면 스테이징 API 키를 참조하십시오.

구성

다음 Akamai Property Manager 규칙은 에이전틱 HTML 페이지 트래픽을 Edge Optimize로 라우팅합니다. 구성에는 다음 단계가 포함됩니다.

​1. 라우팅 기준 설정(사용자 에이전트 및 HTML 트래픽 일치)

다음 사용자 에이전트에 대한 라우팅을 설정합니다.

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
 *ClaudeBot*
 *Claude-User*
 *Claude-SearchBot*
NOTE
Optimize at Edge 라우팅 규칙을 에이전틱 HTML 페이지 트래픽에만 적용합니다. 일반적인 설정은 확장자가 없는 페이지 URL에 대해 htmlEMPTY_STRING을 일치시키기 위해 파일 확장자​와 같은 요청 측 기준을 사용하는 것입니다. 사이트가 다른 URL 패턴에서 HTML을 제공하거나 API 엔드포인트와 같이 확장자 없는 비페이지 경로를 포함하는 경우, 추가 경로 기반 기준으로 규칙을 세분화합니다.

라우팅 기준 설정

​2. 원본 및 SSL 동작 설정

원본을 live.edgeoptimize.net으로 설정하고 SAN을 *.edgeoptimize.net으로 일치시킵니다.

NOTE
Edge에서 최적화 규칙을 추가한 후 속성 활성화에 실패하는 경우, 규칙이 기본 규칙과 다른 원본 서버 SSL 확인 모드를 사용하는지 여부를 확인하십시오. 이 경우 기본 규칙과 일치하도록 Edge에서 최적화 규칙을 업데이트해야 합니다. 예를 들어 기본 규칙에서 플랫폼 설정​을 사용한다면 여기에서도 플랫폼 설정​을 사용하십시오. 필요한 설정을 사용할 수 없다면 Akamai 지원 센터에 문의하십시오.

원본 및 SSL 동작 설정

​3. 캐시 키 변수 설정

캐시 키 변수 PMUSER_EDGE_OPTIMIZE_CACHE_KEYLLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}로 설정합니다.

캐시 키 변수 설정

​4. 캐싱 규칙

캐싱 규칙

​5. 수신 요청 헤더 수정

다음 수신 요청 헤더를 설정합니다.
x-edgeoptimize-api-key를 LLMO에서 가져온 API 키로 설정하고,
x-edgeoptimize-configLLMCLIENT=TRUE;로 설정하며,
x-edgeoptimize-url{{builtin.AK_URL}}로 설정합니다.

수신 요청 헤더 수정

방화벽 규칙을 통해 Optimize at Edge 허용(선택 사항)

CDN에서 WAF 또는 보트 관리자를 사용하는 경우:

  • Edge 서비스에서 최적화 서비스를 통해 원본 콘텐츠를 가져올 수 있도록 WAF 또는 봇 관리자에서 *AdobeEdgeOptimize/1.0* 사용자 에이전트를 최적화합니다.

  • 방화벽에 사용자 에이전트 이외의 추가 확인이 필요한 경우 암호를 생성하고(예: openssl rand -hex 32):

    • 다른 x-edgeoptimize-* 헤더와 함께 라우팅 규칙에 암호가 포함된 x-edgeoptimize-fetcher-key을(를) 추가합니다.
    • x-edgeoptimize-fetcher-key이(가) 같은 암호와 일치하는 요청을 허용하도록 WAF 또는 보트 관리자 규칙을 추가합니다.
  • Edge에서 최적화 는 이 헤더를 있는 그대로 전달합니다. — 전체 키 라이프사이클을 소유합니다.

속성 관리자에서 x-edgeoptimize-fetcher-key 헤더 설정

NOTE
Akamai Bot Manager의 *AdobeEdgeOptimize/1.0* 사용자 에이전트와 x-edgeoptimize-fetcher-key 헤더도 허용 목록에 추가합니다.

​6. 수신 응답 헤더 수정

수신 응답 헤더 수정

​7. 캐시 ID 수정

캐시 ID 수정

​8. 발신 요청 헤더 수정

x-forwarded-host 헤더를 {{builtin.AK_HOST}}로 설정합니다.

발신 요청 헤더 수정

​9. 사이트 페일오버

사이트 장애 조치 구성에는 기본 Optimize at Edge 라우팅 규칙 내의 장애 조치 동작 그리고 대체가 발생할 때 응답 헤더를 추가하는 형제 규칙 등 두 부분이 있습니다.

9a. 사이트 페일오버 동작 구성

기본 Optimize at Edge 라우팅 규칙 내부에 사이트 장애 조치 동작​이라는 하위 규칙을 생성합니다. 모두 일치​로 설정하고 다음 기준을 추가하십시오.

  • 응답 상태 코드​의 범위는 400에서 599까지입니다.
  • 원본 시간 제한​은 Yes입니다.

사이트 장애 조치(Failover)

사이트 장애 조치 동작 구성

9b. 장애 조치(failover) 응답 헤더 규칙 구성

IMPORTANT
라우팅 규칙의 형제(동일한 수준)로서 EdgeOptimize 장애 조치(Failover) - 테스트 헤더 규칙을 만듭니다. 이 규칙들은 중첩되지 않습니다. Akamai Property Manager 규칙 트리에서 계층은 다음과 같아야 합니다.
code language-none
▼ Optimize at Edge                         ← parent rule group
      ▼ Optimize at Edge Routing               ← routing child
          Site Failover Behavior                 ← nested child
      EdgeOptimize Failover - Test Header      ← sibling of routing child
형제 규칙은 Akamai가 원래 호스트 이름에 대해 실패한 요청을 다시 만들 때 평가됩니다. 라우팅 규칙에 대한 API-키 기준은 해당 요청이 Edge Optimize로 다시 전송되지 않게 합니다.
또한 동일한 요청에 대해 원본, 캐싱 비헤이비어 또는 캐시 ID를 변경하는 향후 매칭 규칙에 의해 Edge 라우팅에서 최적화 규칙이 재정의되지 않도록 하십시오. 다른 매칭 규칙이 이들 비헤이비어를 재설정하면 Edge 라우팅 또는 캐싱에서 최적화가 예상대로 작동하지 않을 수 있습니다.

장애 조치 응답 헤더 규칙 구성

사이트 장애 조치는 Edge Optimize가 오류를 반환하거나 제한 시간을 초과하는 경우에도 Akamai가 원래 호스트 이름에 대한 요청을 다시 생성하여 방문자가 여전히 사이트의 정상적인 응답을 받을 수 있게 합니다.

시나리오
비헤이비어
Edge Optimize는 2XX 또는 3XX를 반환합니다.
최적화된 응답이 제공됩니다. x-edgeoptimize-request-id가 있습니다.
Edge Optimize가 4XX5XX를 반환하거나 원본이 제한 시간을 초과합니다.
원래 호스트 이름에 대한 요청이 다시 생성됩니다. 응답에는 x-edgeoptimize-fo: true가 포함됩니다.

설정 확인

설정을 완료한 후 봇 트래픽이 Edge Optimize로 라우팅되고 있으며 사람 트래픽이 영향을 받지 않는지 확인합니다.

1. 봇 트래픽 테스트(최적화해야 함)

에이전틱 사용자 에이전트를 사용하여 AI 봇 요청을 시뮬레이션합니다.

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: chatgpt-user"

성공적인 응답에는 요청이 Edge Optimize를 통해 라우팅되었음을 확인하는 x-edgeoptimize-request-id 헤더가 포함됩니다.

< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85

2. 사람 트래픽 테스트(영향을 받지 않아야 함)

일반 사람 브라우저 요청을 시뮬레이션합니다.

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"

응답에는 x-edgeoptimize-request-id 헤더가 없어야 합니다. 페이지 콘텐츠와 응답 시간은 Optimize at Edge를 활성화하기 전과 동일하게 유지되어야 합니다.

3. 두 시나리오를 구분하는 방법

헤더
봇 트래픽(최적화됨)
사람 트래픽(영향을 받지 않음)
x-edgeoptimize-request-id
있음 - 고유한 요청 ID가 포함되어 있습니다.
없음
x-edgeoptimize-fo
장애 조치가 발생한 경우에만 표시됩니다(값: true).
없음

LLM Optimizer UI에서 트래픽 라우팅 상태를 확인할 수도 있습니다. 고객 구성(으)로 이동하고 CDN 구성 탭을 선택합니다.

AI 에이전트에 최적화 배포 — 완료됨

사용 가능한 기회, 자동 최적화 워크플로 및 FAQ를 포함하여 Edge에서 최적화에 대해 자세히 알아보려면 Edge에서 최적화 개요로 돌아가십시오.

recommendation-more-help
llm-optimizer-help-main-toc