설명서

Akamai 설정

Last update: Wed Feb 26 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

다음 스크린샷은 Akamai Property Manager을(를) 사용하여 Akamai CDN 설정을 사용하여 AEM에서 콘텐츠를 전달하도록 속성을 구성하는 방법을 보여줍니다. 필수 설정이 빨간색 원으로 표시되어 있습니다.

​# 필수 속성 설정

원본 서버

구성 속성:

이름
값
댓글
원본 서버 호스트 이름
main--<repo>--<organization>.aem.live
저장소 및 조직을 다음으로 바꾸기 사이트에 대한 값입니다.
순방향 호스트 헤더
원본 호스트 이름
캐시 키 호스트 이름
들어오는 호스트 헤더
True 클라이언트 IP 헤더 보내기
아니요

비헤이비어 추가: Vary 헤더 제거

구성 속성:

이름
값
댓글
Vary 헤더 제거
(요)일

동작 추가: 발신 요청 헤더 수정

많은 발신 요청 헤더가 필요합니다. 아래 표를 참조하십시오. 모든 항목에 대해 "중복 헤더 방지" 설정을 활성화한 상태로 유지합니다.

구성 속성:

작업
헤더 이름 선택
사용자 정의 헤더 이름
새 헤더 값
수정
기타
X-Forwarded-Host
{{builtin.AK_HOST}}
수정
기타
X-BYO-CDN-Type
akamai
Modify
Other
X-Push-Invalidation
enabled

동작 추가/수정: 캐싱

구성 속성:

이름
값
캐싱 옵션
원본 캐시 제어 승인
향상된 RFC 지원
아니요
명예 사병
아니요
Honor must-revalid
아니요

동작 추가: HTTP/2

(선택 사항이지만 권장됨)

규칙 추가: 발신 응답 헤더 수정

사이드바의 규칙 목록에서 "+ 규칙" 버튼을 클릭합니다.

"빈 규칙 템플릿"을 선택하고 "조건부 스트립 헤더"와 같은 이름을 설정한 다음 "규칙 삽입"을 클릭합니다.

적용할 규칙에 대한 기준을 설정하려면 "+ 일치"를 클릭하십시오.

그런 다음 다음을 선택합니다.

  • 조건
  • 경로
  • 다음 중 하나와 일치하지 않음
  • *.plain.html

일치하는 항목이 있는 경우 "+ 동작" 및 "표준 속성 동작"을 클릭하여 동작을 설정합니다

그런 다음 "발신 응답 헤더 수정"을 선택합니다.

다음 값 포함:

  • 작업: 제거
  • 헤더 이름 선택: 기타
  • 사용자 지정 헤더 이름: X-Robots-Tag

이는 모두 컨텐츠 전달에 필수적인 속성 설정입니다.

선택 사항: 원본 요청 인증

토큰 기반 사이트 인증을 사용하는 경우 "동작 추가: 발신 요청 헤더" 아래에 다음을 추가하십시오.

구성 속성:

이름
값
댓글
작업
수정
사용자 정의 헤더 이름
승인
New Header Value
token <YOUR_TOKEN_HERE>
토큰 기반 사이트 인증에서 받은 사이트 토큰 값으로 대체합니다.
머리글 중복 방지
예

이 설정을 사용하면 Akamai가 CDN에서 AEM Origin으로 요청을 인증하고, 이 요청이 Authorization 헤더에서 받은 토큰을 확인합니다.

주의 사항

활성화하지 않음 Akamai mPulse 실제 사용 모니터링. 대부분의 사이트에 대한 성능 영향은 무시할 수 있지만, 일관된 고성능을 위해 지어진 사이트의 경우 등대 점수가 100에 도달하는 것을 방지할 수 있습니다. AEM에는 Real Use Monitoring 서비스가 내장되어 있으므로이(가) 이중 계측을 불필요하고 권장되지 않습니다.

또한 렌더링 성능 및 사용자 환경을 현저히 방해하므로 활성화하지 않음 Akamai Bot Manager Premier​("트랜잭션 끝점 보호"라고도 함) 또는 유사한 웹 응용 프로그램 방화벽 서비스를 사용하지 마십시오. AEM의 사이트는 백엔드에서 보트 공격으로부터 보호되므로 이러한 성능 비용은 무시할만한 이점을 제공합니다.

Akamai 푸시 무효화 설정

푸시 무효화는 작성자가 콘텐츠 변경 사항을 게시할 때마다 고객의 프로덕션 CDN(예: www.yourdomain.com)에 있는 콘텐츠를 자동으로 제거합니다.

콘텐츠는 URL 및 캐시 태그/키로 제거됩니다.

푸시 무효화는 프로젝트 구성(Sharepoint의 Excel 통합 문서 이름 .helix/config.xlsx 또는 Google 드라이브의 Google 시트 이름 .helix/config)에 특정 속성을 추가하여 사용할 수 있습니다.

구성 속성:

키
값
댓글
cdn.prod.host
<Production Host>
운영 사이트의 호스트 이름(예: ) www.yourdomain.com
cdn.prod.type
akamai
cdn.prod.endpoint
<host>
빠른 제거 API 자격 증명
cdn.prod.clientSecret
<client_secret>
빠른 제거 API 자격 증명
cdn.prod.clientToken
<client_token>
빠른 제거 API 자격 증명
cdn.prod.accessToken
<access_token>
빠른 제거 API 자격 증명

AEM 푸시 무효화는 Akamai 빠른 제거 API, 특히 URL로 삭제 및 캐시 태그로 삭제 ​를 사용합니다.

빠른 제거 API 자격 증명은 다음으로 구성됩니다.

host = akaa-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.luna.akamaiapis.net
client_token = akab-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX
client_secret = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
access_token = akab-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX

사용자 지정 권한으로 API 클라이언트 만들기의 지침에 따라 생성할 수 있습니다.

ID 및 액세스 관리로 이동:

API 클라이언트 만들기:



필요한 그룹/역할 권한:

이 도구를 사용하여 자격 증명의 유효성을 검사할 수 있습니다.

특수 언급 - Akamai Edge-Control 헤더

AEM은 신뢰할 수 있는 푸시 무효화와 함께 특정 CDN에 적용되는 캐싱 정보를 제공하기 위해 세밀하게 조정되고 안정적인 방법을 사용합니다. 이를 통해 기존의 TTL 기반 접근 방식에 비해 캐시 효율성과 일관성을 향상시킬 수 있습니다.

모든 CDN 공급업체는 캐싱을 지시하는 방법에 직접 영향을 주는 방법을 지원하며, Akamai의 장기 지원 Edge-Control 헤더를 사용하는 동안 Akamai용 로드맵(https://www.akamai.com/blog/news/targeted-cache-control 참조)에 "Targeted Cache Control"(TCC)과 같은 표준화 노력이 반영되어 기쁘게 생각합니다.

recommendation-more-help
10a6ce9d-c5c5-48d9-8ce1-9797d2f0f3ec