원본 간 리소스 공유 이해(CORS)

Adobe Experience Manager의 원본 간 리소스 공유(CORS)를 사용하면 비 AEM 웹 속성을 사용하여 인증되거나 인증되지 않은 클라이언트측에서 AEM을 호출하여 콘텐츠를 가져오거나 AEM과 직접 상호 작용할 수 있습니다.

이 문서에 설명된 OSGI 구성은 다음 작업에 충분합니다.

AEM Publish에서 다중 원본 CORS 액세스가 필요한 경우 이 설명서를 참조하세요.

Adobe Granite 원본 간 리소스 공유 정책 OSGi 구성

CORS 구성은 AEM에서 OSGi 구성 팩토리로 관리되며 각 정책은 팩토리의 하나의 인스턴스로 표시됩니다.

Adobe Granite Cross-Origin Resource Sharing Policy (com.adobe.granite.cors.impl.CORSPolicyImpl)

정책 선택

정책을 선택하려면

이 값과 일치하는 첫 번째 정책이 사용됩니다. 찾을 수 없으면 CORS 요청이 거부됩니다.

정책이 전혀 구성되어 있지 않으면 처리기가 비활성화되어 있으므로 서버의 다른 모듈이 CORS에 응답하지 않는 한 CORS 요청도 응답하지 않습니다.

정책 속성

허용된 원본

허용된 원본(Regexp)

허용된 경로

노출된 머리글

최대 나이

지원되는 헤더

허용된 메서드

자격 증명 지원

예제 구성

사이트 1은 GET개의 요청을 통해 콘텐츠를 사용하는 익명으로 액세스할 수 있는 기본 읽기 전용 시나리오입니다.

{
  "supportscredentials":false,
  "exposedheaders":[
    ""
  ],
  "supportedmethods":[
    "GET",
    "HEAD"
  ],
  "alloworigin":[
    "http://127.0.0.1:3000",
    "https://site1.com"

  ],
  "maxage:Integer": 1800,
  "alloworiginregexp":[
    "http://localhost:.*"
    "https://.*\.site1\.com"
  ],
  "allowedpaths":[
    "/content/_cq_graphql/site1/endpoint.json",
    "/graphql/execute.json.*",
    "/content/site1/.*"
  ],
  "supportedheaders":[
    "Origin",
    "Accept",
    "X-Requested-With",
    "Content-Type",
    "Access-Control-Request-Method",
    "Access-Control-Request-Headers"
  ]
}

사이트 2는 보다 복잡하며 승인 및 변경(POST, PUT, DELETE) 요청이 필요합니다.

{
  "supportscredentials":true,
  "exposedheaders":[
    ""
  ],
  "supportedmethods":[
    "GET",
    "HEAD"
    "POST",
    "DELETE",
    "PUT"
  ],
  "alloworigin":[
    "http://127.0.0.1:3000",
    "https://site2.com"

  ],
  "maxage:Integer": 1800,
  "alloworiginregexp":[
    "http://localhost:.*"
    "https://.*\.site2\.com"
  ],
  "allowedpaths":[
    "/content/site2/.*",
    "/libs/granite/csrf/token.json",
  ],
  "supportedheaders":[
    "Origin",
    "Accept",
    "X-Requested-With",
    "Content-Type",
    "Access-Control-Request-Method",
    "Access-Control-Request-Headers",
    "Authorization",
    "CSRF-Token"
  ]
}

Dispatcher 캐싱 관련 사항 및 구성 dispatcher-caching-concerns-and-configuration

Dispatcher 4.1.1 이상 응답 헤더를 캐시할 수 있습니다. 이렇게 하면 요청이 익명인 한 CORS이(가) 요청한 리소스와 함께 CORS 헤더를 캐시할 수 있습니다.

일반적으로 Dispatcher에서 콘텐츠를 캐시하기 위한 동일한 고려 사항을 Dispatcher에서 CORS 응답 헤더를 캐시하는 데 적용할 수 있습니다. 다음 표는 CORS개의 헤더(및 CORS개의 요청)를 캐시할 수 있는 시기를 정의합니다.

CORS 요청 헤더 허용

필요한 HTTP 요청 헤더가 처리를 위해 AEM에 전달되도록하려면 Dispatcher의 /clientheaders 구성에서 허용되어야 합니다.

/clientheaders {
   ...
   "Origin"
   "Access-Control-Request-Method"
   "Access-Control-Request-Headers"
}

CORS 응답 헤더 캐싱

캐시된 콘텐츠에서 CORS 헤더를 캐시하고 제공할 수 있도록 하려면 다음 /cache /headers 구성을(를) AEM Publish dispatcher.any 파일에 추가하십시오.

/publishfarm {
    ...
    /cache {
        ...
        # CORS HTTP response headers
        # https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#the_http_response_headers
        /headers {
            ...
            "Access-Control-Allow-Origin"
            "Access-Control-Expose-Headers"
            "Access-Control-Max-Age"
            "Access-Control-Allow-Credentials"
            "Access-Control-Allow-Methods"
            "Access-Control-Allow-Headers"
        }
    ...
    }
...
}

dispatcher.any 파일을 변경한 후 웹 서버 응용 프로그램을 다시 시작 ​해야 합니다.

/cache/headers 구성 업데이트 후 다음 요청에서 헤더가 적절하게 캐시되도록 하려면 캐시를 완전히 지워야 할 수 있습니다.

CORS 문제 해결

로깅을 com.adobe.granite.cors에서 사용할 수 있습니다.

팁:

지원 자료