설명서AEM as a Cloud Service사용 안내서

CDN 자격 증명 및 인증 구성 cdn-credentials-authentication

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자
NOTE
이 기능은 아직 일반적으로 사용할 수 없습니다. 얼리 어답터 프로그램에 참여하려면 aemcs-cdn-config-adopter@adobe.com에게 전자 메일을 보내십시오.

Adobe 제공 CDN에는 몇 가지 기능과 서비스가 있으며, 그중 일부는 적절한 수준의 엔터프라이즈 보안을 보장하기 위해 자격 증명과 인증에 의존합니다. Cloud Manager 구성 파이프라인을 사용하여 배포된 구성 파일에서 규칙을 선언하여 고객은 셀프서비스 방식으로 다음을 구성할 수 있습니다.

  • Adobe CDN이 고객 관리 CDN에서 오는 요청의 유효성을 검사하는 데 사용하는 HTTP 헤더 값입니다.
  • CDN 캐시에서 리소스를 제거하는 데 사용되는 API 토큰입니다.
  • 기본 인증 양식을 제출하여 제한된 콘텐츠에 액세스할 수 있는 사용자 이름/암호 조합 목록입니다.

구성 구문을 포함한 이러한 각 요소에 대해서는 아래 해당 섹션에 설명되어 있습니다. 공통 설정 섹션은 배포와 함께 공통되는 설정을 보여 줍니다. 마지막으로 키를 회전하는 방법에 대한 섹션이 있으며 이는 올바른 보안 방법으로 간주됩니다.

고객 관리 CDN HTTP 헤더 값 CDN-HTTP-value

AEM as a Cloud Service의 CDN 페이지에 설명된 대로 고객은 자체 CDN(Customer CDN(BYOCDN이라고도 함)을 통해 트래픽을 라우팅하도록 선택할 수 있습니다.

설정의 일부로 Adobe CDN과 고객 CDN은 X-AEM-Edge-Key HTTP 헤더의 값에 동의해야 합니다. 이 값은 Adobe CDN으로 라우팅되기 전에 고객 CDN의 각 요청에 대해 설정되고, 이 값은 값이 예상대로 맞는지 검증하므로 요청을 적절한 AEM 소스로 라우팅하는 데 도움이 되는 헤더를 포함하여 다른 HTTP 헤더를 신뢰할 수 있습니다.

X-AEM-Edge-Key 값이 EdgeKey1 및 EdgeKey2 속성에서 참조하는 실제 값과 함께 아래 구문으로 선언되었습니다. 구성을 배포하는 방법에 대해 알아보려면 일반 설정 섹션을 참조하십시오.

kind: "CDN"
version: "1"
metadata:
  envTypes: ["dev"]
data:
  experimental_authentication:
    authenticators:
      - name: edge-auth
        type: edge
        edgeKey1: ${{CDN_EDGEKEY_052824}}
        edgeKey2: ${{CDN_EDGEKEY_041425}}
    rules:
      - name: edge-auth-rule
        when: { reqProperty: tier, equals: "publish" }
        action:
          type: authenticate
          authenticator: edge-auth

X-AEM-Edge-Key 값의 구문은 다음과 같습니다.

  • 종류, 버전 및 메타데이터

  • 자식 experimental_authentication 노드가 포함된 데이터 노드입니다(기능이 릴리스되면 실험 접두사가 제거됨).

  • experimental_authentication에서 하나의 authenticators 노드와 하나의 rules 노드가 배열입니다.

  • 인증자: 토큰 또는 자격 증명의 유형을 선언할 수 있습니다. 이 경우 토큰은 에지 키입니다. 여기에는 다음 속성이 포함됩니다.

    • name - 설명 문자열입니다.
    • 형식 - edge이어야 합니다.
    • edgeKey1 - 비밀 토큰을 참조해야 하는 X-AEM-Edge-Key ​의 값. 이 토큰은 git에 저장되어서는 안 되며 대신 유형 비밀의 Cloud Manager 환경 변수(으)로 선언되어야 합니다. 서비스 적용 필드에서 모두를 선택합니다. 값(예: ${{CDN_EDGEKEY_052824}})은 추가된 날짜를 반영하는 것이 좋습니다.
    • edgeKey2 - 아래 암호 회전 섹션에 설명된 대로 암호 회전에 사용됩니다. edgeKey1과 유사하게 정의합니다. edgeKey1 및 edgeKey2 중 하나 이상을 선언해야 합니다.

  • 규칙: 사용해야 하는 인증자와 게시 및/또는 미리보기 계층 여부를 선언할 수 있습니다. 여기에는 다음이 포함됩니다.

    • name - 설명 문자열입니다.
    • when - 트래픽 필터 규칙 문서의 구문에 따라 규칙을 평가할 시기를 결정하는 조건입니다. 일반적으로 여기에는 현재 계층(예: 게시)의 비교가 포함되므로 모든 라이브 트래픽이 고객 CDN을 통한 라우팅으로 검증됩니다.
    • 작업 - 의도한 인증자가 참조된 "인증"을 지정해야 합니다.
NOTE
Edge 키를 참조하는 구성이 배포되기 전에 secret 유형의 Cloud Manager 환경 변수 변수(모두 ​가 서비스 적용용으로 선택됨)로 구성해야 합니다.

API 토큰 제거 purge-API-token

고객은 선언된 제거 API 토큰을 사용하여 CDN 캐시를 제거할 수 있습니다. 토큰은 아래 구문으로 선언됩니다. 배포 방법에 대해 알아보려면 일반 설정 섹션을 참조하세요.

kind: "CDN"
version: "1"
metadata:
  envTypes: ["dev"]
data:
  experimental_authentication:
    authenticators:
       - name: purge-auth
         type: purge
         purgeKey1: ${{CDN_PURGEKEY_031224}}
         purgeKey2: ${{CDN_PURGEKEY_021225}}
    rules:
       - name: purge-auth-rule
         when: { reqProperty: tier, equals: "publish" }
         action:
           type: authenticate
           authenticator: purge-auth

구문은

  • 종류, 버전 및 메타데이터

  • 하위 experimental_authentication 노드가 포함된 데이터 노드(기능이 릴리스되면 실험 접두사가 제거됨).

  • experimental_authentication에서 하나의 authenticators 노드와 하나의 rules 노드가 배열입니다.

  • 인증자: 토큰 또는 자격 증명의 유형을 선언할 수 있습니다. 이 경우 삭제 키입니다. 여기에는 다음 속성이 포함됩니다.

    • name - 설명 문자열입니다.
    • 유형 - 은(는) 삭제여야 합니다.
    • purgeKey1 - 해당 값은 비밀 토큰을 참조해야 하며, 이 토큰은 git에 저장되어서는 안 되고 대신 secret 유형의 Cloud Manager 환경 변수(으)로 선언되어야 합니다.
    • 서비스 적용 필드에서 모두를 선택합니다. 값(예: ${{CDN_PURGEKEY_031224}})은 추가된 날짜를 반영하는 것이 좋습니다.
    • purgeKey2 - 아래 회전 비밀 섹션 섹션에 설명된 대로 비밀 회전에 사용됩니다. purgeKey1 및 purgeKey2 중 하나 이상을 선언해야 합니다.

  • 규칙: 사용해야 하는 인증자와 게시 및/또는 미리보기 계층 여부를 선언할 수 있습니다. 여기에는 다음이 포함됩니다.

    • name - 설명 문자열
    • when - 트래픽 필터 규칙 문서의 구문에 따라 규칙을 평가할 시기를 결정하는 조건입니다. 일반적으로 현재 계층의 비교(예: 게시)가 포함됩니다.
    • 작업 - 의도한 인증자가 참조된 "인증"을 지정해야 합니다.
NOTE
Edge 키를 참조하는 구성을 배포하기 전에 secret 유형의 Cloud Manager 환경 변수 변수로 키를 구성해야 합니다.

기본 인증 basic-auth

사용자 이름과 암호를 요구하는 기본 인증 대화 상자를 표시하여 특정 콘텐츠 리소스를 보호합니다. 이 기능은 최종 사용자 액세스 권한에 대한 완전한 솔루션보다는 비즈니스 이해 당사자의 콘텐츠 검토와 같은 간단한 인증 사용 사례를 위한 것입니다.

최종 사용자는 다음과 같이 기본 인증 대화 상자가 표시되는 것을 경험합니다.

basicauth-dialog

구문은 아래 설명된 대로 선언됩니다. 배포 방법에 대한 자세한 내용은 아래의 일반 설정 섹션을 참조하십시오.

kind: "CDN"
version: "1"
metadata:
  envTypes: ["dev"]
data:
  experimental_authentication:
    authenticators:
       - name: my-basic-authenticator
         type: basic
         credentials:
           - user: johndoe
             password: ${{JOHN_DOE_PASSWORD}}
           - user: janedoe
             password: ${{JANE_DOE_PASSWORD}}
    rules:
       - name: basic-auth-rule
         when: { reqProperty: path, like: "/summercampaign" }
         action:
           type: authenticate
           authenticator: my-basic-authenticator

구문은

  • 종류, 버전 및 메타데이터

  • experimental_authentication 노드가 포함된 데이터 노드(기능이 릴리스되면 실험 접두사가 제거됨).

  • experimental_authentication에서 하나의 authenticators 노드와 하나의 rules 노드가 배열입니다.

  • 인증자: 이 시나리오에서는 다음 구조를 갖는 기본 인증자를 선언합니다.

    • name - 설명 문자열

    • 형식은 basic이어야 합니다.

    • 최종 사용자가 기본 인증 대화 상자에 입력할 수 있는 다음 이름/값 쌍을 각각 포함하는 자격 증명 배열입니다.

      • user - 사용자 이름
      • 암호 - 해당 값은 비밀 토큰을 참조해야 하며, git에 저장하면 안 되고, 대신 서비스 필드로 모두 ​가 선택된 상태에서 비밀 유형의 Cloud Manager 환경 변수로 선언되어야 합니다.

  • 규칙: 사용해야 하는 인증자와 보호해야 하는 리소스를 선언할 수 있습니다. 각 규칙에는 다음이 포함됩니다.

    • name - 설명 문자열
    • when - 트래픽 필터 규칙 문서의 구문에 따라 규칙을 평가할 시기를 결정하는 조건입니다. 일반적으로 게시 계층 또는 특정 경로의 비교가 포함됩니다.
    • 작업 - 이 시나리오에 대한 기본 인증인 의도한 인증자가 참조된 "인증"을 지정해야 합니다.
NOTE
Edge 키를 참조하는 구성을 배포하기 전에 secret 유형의 Cloud Manager 환경 변수 변수로 키를 구성해야 합니다.

공통 설정 common-setup

모든 인증자는 다음과 같이 설정됩니다.

  • 먼저 Git 프로젝트의 최상위 수준 폴더에 다음 폴더 및 파일 구조를 만듭니다.
config/
     cdn.yaml

  • 두 번째로 cdn.yaml 구성 파일에는 아래 예제에 설명된 노드가 포함되어야 합니다. kind 속성은 CDN(으)로 설정되어야 하며 버전은 현재 1인 스키마 버전으로 설정되어야 합니다. 메타데이터 노드에는 이 구성을 평가할 환경 유형(개발, 스테이지, 프로덕션)을 나타내는 "envTypes" 속성이 있습니다.

  • 마지막으로, Cloud Manager에서 타깃팅된 배포 구성 파이프라인을 만듭니다. 프로덕션 파이프라인 구성 및 비프로덕션 파이프라인 구성을 참조하십시오.

참고:

  • RDE는 현재 구성 파이프라인을 지원하지 않습니다.
  • yq을 사용하여 구성 파일(예: yq cdn.yaml)의 YAML 서식을 로컬에서 확인할 수 있습니다.

회전 비밀 rotating-secrets

경우에 따라 자격 증명을 변경하는 것이 좋습니다. 이는 비록 퍼지 키들에 대해 동일한 전략이 사용되지만, 에지 키의 예를 사용하여 이하에 예시된 바와 같이 달성될 수 있다.

  • 처음에는 edgeKey1만 정의되었습니다. 이 경우 ${{CDN_EDGEKEY_052824}}(으)로 참조되며 권장 규칙으로 만들어진 날짜를 반영합니다.
experimental_authentication:
  authenticators:
    - name: edge-auth
      type: edge
      edgeKey1: ${{CDN_EDGEKEY_052824}}
  • 키를 회전할 때가 되면 새 Cloud Manager 암호를 만드십시오(예: ${{CDN_EDGEKEY_041425}}).
  • 구성에서 edgeKey2에서 참조하고 배포합니다.
experimental_authentication:
  authenticators:
    - name: edge-auth
      type: edge
      edgeKey1: ${{CDN_EDGEKEY_052824}}
      edgeKey2: ${{CDN_EDGEKEY_041425}}
  • 이전 에지 키가 더 이상 사용되지 않으면 구성에서 edgeKey1을(를) 제거하여 제거하십시오.
experimental_authentication:
  authenticators:
    - name: edge-auth
      type: edge
      edgeKey2: ${{CDN_EDGEKEY_041425}}
  • Cloud Manager에서 이전 비밀 참조(${{CDN_EDGEKEY_052824}})를 삭제하고 배포합니다.
  • 다음 순환에 대한 준비가 되면 동일한 절차를 따르되, 이번에는 ${{CDN_EDGEKEY_031426}}과(와) 같은 이름의 새 Cloud Manager 환경 암호를 참조하여 구성에 edgeKey1을(를) 추가합니다.
experimental_authentication:
  authenticators:
    - name: edge-auth
      type: edge
      edgeKey2: ${{CDN_EDGEKEY_041425}}
      edgeKey1: ${{CDN_EDGEKEY_031426}}
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab