설명서AEM사용 안내서

[AEM Assets]{class="badge positive" title="AEM Assets에 적용됩니다)."}

디지털 자산을 Adobe Experience Manager에 Cloud Service Assets​(으)로 추가 add-assets-to-experience-manager

마지막 업데이트: 2026년 9월 25일
  • 적용 대상:
  • Experience Manager as a Cloud Service

작성 대상:

  • User
  • Admin

Adobe Experience Manager Assets은(는) 다양한 소스의 다양한 디지털 에셋을 허용합니다. 원본 바이너리와 생성된 렌디션을 저장하고 워크플로우 및 Adobe AI 서비스를 사용하여 자산을 처리하고 다양한 채널 및 표면에 콘텐츠를 배포합니다.

Adobe Experience Manager은(는) 업로드된 디지털 파일의 이진 콘텐츠를 자동으로 강화하여 자산을 더 쉽게 검색하고, 다시 사용할 수 있으며, 배달할 준비가 되도록 합니다. Experience Manager은(는) 풍부한 메타데이터, 스마트 태그, 렌디션 및 기타 DAM(디지털 에셋 관리) 서비스를 통해 이러한 파일을 강화합니다. 로컬 폴더 또는 네트워크 드라이브에서 Experience Manager Assets​(으)로 이미지, 문서 및 원시 이미지 파일과 같은 다양한 유형의 파일을 업로드할 수 있습니다.

저장소에 에셋을 추가하는 방법

가장 일반적으로 사용되는 브라우저 업로드 외에 다른 방법으로 Experience Manager 저장소에 에셋을 추가할 수 있습니다. 이러한 다른 방법에는 Adobe Asset Link 또는 Experience Manager 데스크톱 앱과 같은 데스크톱 클라이언트, 고객이 만들 업로드 및 수집 스크립트, Experience Manager 확장으로 추가된 자동화된 수집 통합이 포함됩니다.

추가 서비스 및 처리

Experience Manager에서 모든 이진 파일을 업로드하고 관리할 수 있지만, 가장 일반적으로 사용되는 파일 형식은 메타데이터 추출 또는 미리 보기/렌디션 생성과 같은 추가 서비스를 지원합니다. 자세한 내용은 지원되는 파일 형식을 참조하십시오.

업로드된 에셋에 대해 추가 처리를 수행하도록 선택할 수도 있습니다. 에셋이 업로드되는 폴더에 여러 에셋 처리 프로필을 구성하여 특정 메타데이터, 렌디션 또는 이미지 처리 서비스를 자동으로 추가할 수 있으므로 에셋이 수동 개입 없이 게재 요구 사항을 충족하도록 할 수 있습니다. 업로드할 때 자산 처리를 참조하세요.

업로드 메서드 개요

Assets에서 제공하는 업로드 방법은 다음과 같습니다. 올바른 방법은 볼륨, 워크플로우 및 관련 담당자에 따라 다르므로 Adobe은 사용하기 전에 사용 사례와 각 업로드 옵션의 적용 가능성을 이해할 것을 권장합니다.

업로드 방법
사용 시기
기본 담당자
Assets 콘솔 사용자 인터페이스
가끔 업로드, 누르기 및 끌기, 찾기 업로드. 를 사용하여 많은 에셋을 업로드하지 마십시오.
모든 사용자
API 업로드
업로드 중 다이내믹 의사 결정용.
개발자
Experience Manager 데스크톱 앱
낮은 볼륨 에셋 수집이지만 마이그레이션용은 아닙니다.
관리자, 마케터
Adobe Asset Link
크리에이티브 및 마케터가 지원되는 Creative Cloud 데스크톱 앱 내에서 자산에 대해 작업할 때 유용합니다.
Creative, 마케터
일괄 에셋 수집기
대규모 마이그레이션 및 경우에 따라 대량으로 수집하는 경우에 권장됩니다. 지원되는 데이터 저장소에만 해당됩니다.
관리자, 개발자

자산 업로드 upload-assets

Adobe Experience Manager Assets은(는) 단일 파일 또는 여러 파일을 업로드하는 두 가지 방법을 지원합니다. 바탕 화면에서 Assets 사용자 인터페이스(웹 브라우저)와 대상 폴더로 직접 파일을 끌어다 놓거나 [만들기] 메뉴를 사용하여 Assets 사용자 인터페이스 내에서 업로드를 시작​합니다. 두 방법 모두 선택한 폴더 위치에 디지털 에셋을 추가합니다.

IMPORTANT
파일 이름이 100자보다 큰 Assets을(를) Experience Manager에 업로드했습니다​은(는) Dynamic Media에서 사용할 때 단축된 이름을 제공합니다.
파일 이름의 처음 100자​는 그대로 유지되며 나머지 문자는 영숫자 문자열로 바뀝니다. 이 이름 바꾸기 메서드는 Dynamic Media에서 에셋을 사용할 때 고유한 이름을 보장하므로 에셋 간의 이름 지정 충돌을 방지할 수 있습니다. 또한 Dynamic Media에서 허용되는 최대 에셋 파일 이름 길이​을 수용하므로 자르기를 수행하면 모든 에셋이 해당 제한을 준수합니다.

  1. Assets 사용자 인터페이스에서 디지털 자산을 추가할 위치로 이동합니다.

  2. 에셋을 업로드하려면 다음 방법 중 하나를 사용하십시오.

    • 도구 모음에서 만들기 > 파일​을 클릭합니다. 필요한 경우 제공된 대화 상자에서 파일 이름을 변경할 수 있습니다.
    • HTML5를 지원하는 브라우저에서 자산을 Assets 사용자 인터페이스로 직접 끌어 옵니다. 이 방법에서는 파일 이름 바꾸기 대화 상자가 표시되지 않습니다.

    createmenu

    여러 파일을 선택하려면 Ctrl 키(Windows) 또는 Command 키(macOS)를 누른 상태에서 파일 선택기 대화 상자에서 자산을 선택합니다. iPad을 사용하는 경우 한 번에 하나의 파일만 선택할 수 있습니다.

  3. 진행 중인 업로드를 취소하려면 진행률 표시줄 옆의 닫기(X)를 클릭합니다. 취소를 수행하면 진행 중인 전송이 중지되므로 Assets은(는) 불완전한 파일을 남기지 않도록 현재 에셋에서 부분적으로 업로드된 부분을 삭제합니다. 모든 파일을 업로드하기 전에 업로드 작업을 취소하면 Assets에서 현재 파일의 업로드를 중지하고 콘텐츠를 새로 고칩니다. 그러나 업로드가 이미 완료된 파일은 삭제되지 않고 대상 폴더에 남아 있습니다.

  4. Assets의 업로드 진행 대화 상자에 업로드한 파일과 업로드에 실패한 파일의 수가 표시되어 일괄 처리 상태를 확인할 수 있습니다. 또한 Assets 사용자 인터페이스에는 업로드한 가장 최근 에셋 또는 처음 만든 폴더가 표시됩니다.

NOTE
중첩된 폴더 계층을 업로드하려면 자산 일괄 업로드를 참조하십시오.

기존 에셋에 대한 업로드 처리 handling-upload-existing-file

기존 에셋과 경로가 동일한(이름 및 위치가 동일한) 에셋을 업로드하면 세 가지 해결 옵션이 표시되는 경고 대화 상자가 트리거됩니다. 기존 에셋 바꾸기, 다른 버전 만들기 또는 둘 다 유지. 각 옵션은 복제를 다르게 처리합니다.

  • 기존 에셋 바꾸기: 기존 에셋을 바꾸면 해당 에셋이 완전히 덮어쓰므로 기존 에셋에 적용된 메타데이터 및 이전 수정 사항(예: 주석 및 자르기)이 영구적으로 삭제됩니다. 이 문제는 대체 에셋이 에셋의 내역을 보존하지 않고 저장된 에셋에 쓰기 때문에 발생합니다.

    note
    NOTE
    에셋이 잠겨 있거나 체크 아웃된 경우 에셋 바꾸기 옵션을 사용할 수 없습니다.

  • 다른 버전을 만듭니다: 기존 에셋의 새 버전이 저장소에 만들어지므로 작업이 손실되지 않도록 이전 상태를 유지할 수 있습니다. 타임라인에서 두 버전을 볼 수 있으며 필요한 경우 기존 버전으로 되돌릴 수 있습니다.

  • 둘 다 유지: 두 에셋을 모두 유지하도록 선택하면 원본 에셋과 새로 업로드한 에셋이 모두 공존하도록 새 에셋의 이름이 바뀝니다.

Assets에서 중복 자산을 유지하려면 보관​을 클릭하세요. 업로드한 중복 에셋을 삭제하려면 삭제​를 클릭합니다.

파일 이름 처리 및 금지된 문자 filename-handling

Adobe Experience Manager (AEM) Assets은(는) 파일 이름에 금지된 문자가 포함된 모든 자산의 업로드를 차단합니다. 파일 이름에 허용되지 않는 문자가 하나 이상 포함되어 있으면 Assets이(가) 경고 메시지를 표시하고 허용되지 않는 문자를 제거하거나 파일의 이름을 허용되는 이름으로 바꿀 때까지 업로드를 차단합니다. 이 안전 조치는 업로드 시점에 실행되므로 에셋이 저장소에 들어가기 전에 문제가 되는 파일 이름이 발견되었습니다.

이러한 제한이 있는 이유

파일 이름 문자 제한을 통해 파일 시스템, 스토리지 레이어 및 웹 URL에서 에셋 및 폴더 이름이 호환되도록 할 수 있습니다. 슬래시, 콜론 및 기타 예약된 기호와 같은 문자는 파일 경로 및 URL에서 특별한 의미를 가지므로 이를 제한하면 이름 지정 충돌, 끊어진 링크 및 전달 오류가 다운스트림에서 방지됩니다.

조직의 특정 파일 이름 지정 규칙에 맞추기 위해 Assets 업로드 대화 상자를 사용하면 업로드 중에 긴 파일 이름을 지정할 수 있습니다. 공백으로 구분된 다음 문자는 지원되지 않습니다.

  • 자산 이름에 잘못된 문자: * / : [ \\ ] | # % { } ? & 또는 ;=(세미콜론, 등호)
  • 자산 폴더 이름에 잘못된 문자: * / : [ \\ ] | # % { } ? \" . ^ ; + & \t

잘못된 파일 이름의 예:

  • JPG_JD_small file ~!)$@;(-_=+^',..jpg
  • JPG_JD_small file ~!)$@;=(-_+^',..jpg

위의 목록에서 예약된 문자가 포함되어 있으므로 두 예 모두 거부됩니다. 업로드에 성공하려면 업로드를 다시 시도하기 전에 금지된 문자를 제거하거나 허용된 대체 문자로 바꾸십시오.

자산 일괄 업로드 bulk-upload

일괄 에셋 수집기 는 대량의 에셋을 효율적으로 처리합니다. 대규모 수집은 광범위한 파일 덤프나 일상적인 마이그레이션이 아닙니다. 대규모 수집을 비즈니스 목적에 효율적으로 도움이 되는 의미 있는 프로젝트로 만들려면 마이그레이션을 계획하고 자산 조직을 의도적으로 조정하십시오. 모든 수집은 다르기 때문에 일반 규칙을 적용하는 대신 특정 저장소 구성 및 비즈니스 요구 사항을 고려합니다. 다음 모범 사례는 일괄 수집을 계획하고 실행하는 데 도움이 됩니다.

  • 자산 조정: DAM(디지털 자산 관리) 저장소에 필요하지 않은 자산을 제거합니다. 사용되지 않거나, 더 이상 사용되지 않거나, 중복된 에셋을 제거하는 것이 좋습니다. 이러한 하우스키핑은 전송된 데이터와 수집된 자산의 수를 줄여 보다 빠르고 안정적인 수집을 가능하게 합니다.
  • 자산 구성: 파일 크기, 파일 형식, 사용 사례 또는 우선 순위별로 정의된 논리적 순서로 콘텐츠를 구성해 보십시오. 복잡하고 크기가 큰 파일은 처리 시간과 시스템 리소스를 더 많이 필요로 하므로 파일을 격리하면 처리 병목 현상을 방지할 수 있습니다. 파일 크기 필터링 옵션(아래에 설명)을 사용하여 큰 파일을 별도로 수집하는 것도 고려해 볼 수 있습니다.
  • 시차를 두는 수집: 수집을 여러 일괄 수집 프로젝트로 나누는 것이 좋습니다. 시차를 둔 수집을 사용하면 콘텐츠를 더 빨리 보고 필요에 따라 수집을 조정할 수 있습니다. 예를 들어 사용량이 적은 시간 동안 또는 점진적으로 여러 청크로 처리 집약적인 에셋을 수집할 수 있습니다. 그러나 한 번에 많은 처리가 필요하지 않은 더 작고 간단한 에셋을 수집할 수 있습니다.

더 많은 수의 파일을 업로드하려면 다음 방법 중 하나를 사용하십시오. 사용 사례 및 메서드도 참조하세요.

  • 자산 업로드 API: 필요한 경우 API를 사용하는 사용자 지정 업로드 스크립트나 도구를 사용하여 자산의 추가 처리를 추가합니다(예: 메타데이터 번역 또는 파일 이름 바꾸기).
  • Experience Manager 데스크톱 앱: 로컬 파일 시스템에서 에셋을 업로드하는 크리에이티브 전문가 및 마케터에게 유용합니다. 로컬에서 사용할 수 있는 중첩된 폴더를 업로드하는 데 사용합니다.
  • 일괄 수집 도구: Experience Manager을(를) 배포할 때 가끔 또는 처음에 대량의 자산을 수집하는 데 사용합니다.

일괄 에셋 가져오기 도구 asset-bulk-ingestor

자산 일괄 가져오기 도구​는 Microsoft Azure Blob 저장소 또는 Amazon Simple Storage Service(S3) 데이터 저장소에서 자산을 대규모로 수집하는 관리자 그룹​에서만 사용할 수 있습니다. 대량 수집은 많은 수의 에셋을 저장소로 직접 이동하는 권한이 있는 대량 작업이므로 관리자가 액세스할 수 없습니다. 따라서 안전하게 구성하려면 높은 권한이 필요합니다. 구성 및 수집에 대한 자세한 내용은 비디오를 참조하십시오.

https://video.tv.adobe.com/v/341391/?captions=kor&quality=12&learn=on

다음 이미지는 관리자가 데이터 저장소에서 Adobe Experience Manager​(으)로 자산을 수집하는 다양한 단계를 보여줍니다. 연결된 개체 저장소에서 자산을 읽고, 전송하고, Experience Manager​(으)로 처리하는 스테이징된 파이프라인을 통해 수집이 진행되므로 큰 배치가 안정적으로 처리됩니다.

일괄 수집 도구

사전 요구 사항

이 기능을 사용하려면 Microsoft Azure 또는 Amazon Web Services(AWS)​의 외부 저장소 계정이나 버킷이 필요합니다. 일괄 가져오기 프로세스는 이 외부 계정에서 직접 소스 에셋을 읽으므로 올바르게 구성된 Azure 또는 AWS 저장소 위치가 필수 전제 조건입니다.

NOTE
저장소 계정 컨테이너 또는 버킷을 private(으)로 만들고 승인된 요청​의 연결만 수락합니다. 저장소를 private으로 구성하면 신뢰할 수 있고 인증된 호출자에 대한 액세스가 제한되므로 수집 중에 소스 자산이 무단 액세스로부터 보호됩니다. 그러나 인그레스 네트워크 연결에 대한 추가 제한 사항은 지원되지 않습니다.
NOTE
외부 저장소 계정은 일괄 가져오기 도구와 다른 파일 및 폴더 이름 지정 규칙을 적용할 수 있습니다. 허용되지 않는 이름 및 이스케이프 처리된 이름에 대한 자세한 내용은 일괄 가져오기 중 파일 이름 처리를 참조하십시오.

일괄 가져오기 도구 구성 configure-bulk-ingestor-tool

Adobe Experience Manager에서 일괄 가져오기 도구를 구성하려면 다음 단계를 수행합니다.

  1. 도구 > Assets > 일괄 가져오기​로 이동합니다. 만들기 옵션을 선택하십시오.

  2. 제목 필드에 대량 가져오기 구성의 제목을 지정합니다.

  3. Source 가져오기 드롭다운 목록에서 데이터 원본 유형을 선택합니다.

  4. 데이터 소스와의 연결을 만드는 데 사용할 값을 제공합니다. 예를 들어 Azure Blob 저장소​를 데이터 소스로 선택하는 경우 Azure 저장소 계정, Azure Blob 컨테이너 및 Azure 액세스 키의 값을 지정합니다.

  5. 드롭다운 목록에서 필요한 인증 모드를 선택합니다. 두 모드는 부여하는 액세스 수준에 따라 다릅니다. Azure 액세스 키​는 Azure 저장소 계정에 대한 완전한 무제한 액세스를 제공하는 반면, Azure SAS 토큰​은(는) 관리자가 권한 및 만료 정책을 사용하여 토큰의 기능을 제한할 수 있도록 합니다. 따라서 Azure SAS 토큰​은(는) 더 제한적인 옵션이며 범위 및 시간 바인딩된 액세스만 부여합니다.

  6. 소스 폴더 필드에 데이터 소스의 자산이 포함된 루트 폴더의 이름을 입력합니다.

  7. (선택 사항) 최소 크기별 필터링 필드의 수집 프로세스에 에셋을 포함할 최소 파일 크기(MB)를 제공합니다.

  8. (선택 사항) 자산의 최대 파일 크기(MB)를 제공하여 최대 크기로 필터링 필드의 수집 프로세스에 자산을 포함시킵니다.

  9. (선택 사항) MIME 유형 제외 필드에서 수집에서 제외할 MIME 유형의 쉼표로 구분된 목록을 지정합니다. MIME 유형은 각 에셋의 파일 형식을 식별하므로 이 필터를 사용하면 가져오지 않을 형식을 건너뛸 수 있습니다. 예를 들어, image/jpeg, image/.*, video/mp4과 같이 입력합니다. 지원되는 모든 파일 형식을 참조하세요.

  10. MIME 유형 포함 필드의 수집에 포함할 MIME 유형의 쉼표로 구분된 목록을 지정하십시오. 지원되는 모든 파일 형식을 참조하세요.

  11. 파일을 Experience Manager​(으)로 가져온 후 원본 데이터 저장소에서 원본 파일을 삭제하려면 가져온 후 원본 파일 삭제 옵션을 선택하십시오. 이렇게 하면 소스 데이터 저장소에서 저장소를 회수하고 나중에 실행할 때 동일한 파일을 다시 가져올 수 없습니다.

  12. 가져오기 모드​를 선택합니다. 건너뛰기, 바꾸기 또는 버전 만들기​를 선택합니다. 건너뛰기 모드가 기본값입니다. 일치하는 에셋이 대상에 이미 있으므로 수집자는 해당 에셋을 가져오기를 건너뛰므로 기존 콘텐츠를 덮어쓸 수 없습니다. 바꾸기 및 버전 만들기 옵션의 의미를 확인합니다.

  13. DAM(디지털 자산 관리)에서 Experience Manager이(가) 자산을 가져오는 위치를 정의하려면 Assets 대상 폴더 필드에 경로를 지정하십시오. 예: /content/dam/imported_assets

  14. (선택 사항) 메타데이터 파일 필드에서 가져올 메타데이터 파일(CSV 형식으로 제공)을 지정합니다. 소스 Blob 위치에 CSV 파일을 지정하고 일괄 가져오기 도구를 구성하는 동안 경로를 참조하십시오. 이 필드에서 참조된 CSV 파일 형식은 자산 메타데이터를 일괄적으로 가져오기 및 내보내기할 때 사용된 CSV 파일 형식과 동일합니다. 가져오기 후 소스 파일 삭제 옵션을 선택하는 경우 제외 또는 MIME 유형 포함 필드 또는 경로/파일별 필터링 필드를 사용하여 CSV 파일을 필터링하십시오. 이렇게 하면 메타데이터 CSV 자체가 삭제되거나 자산으로 수집되지 않습니다. 정규 표현식을 사용하여 이러한 필드의 CSV 파일을 필터링할 수 있습니다.

  15. 구성을 저장하려면 저장​을 클릭하세요.

일괄 가져오기 도구 구성 관리 manage-bulk-import-configuration

일괄 가져오기 도구 구성을 만든 후 자산을 Experience Manager 인스턴스로 일괄 수집하기 전에 구성을 확인하고 평가할 수 있습니다. 이 단계에서 구성을 관리하면 설정을 검토하고 에셋 소스에 대한 연결을 확인하고 설정을 테스트할 수 있습니다. 이렇게 하면 구성이 예상대로 작동하며 자산을 대규모로 가져오기 전에 수집 오류를 방지하는 데 도움이 됩니다.

구성 관리 옵션 액세스 access-configuration-management-options

일괄 가져오기 도구 구성 관리에 사용할 수 있는 옵션을 보려면 도구 > Assets > 일괄 가져오기​로 이동한 다음 관리할 구성을 선택하십시오. 구성을 선택하면 해당 특정 설정에 사용할 수 있는 관리 작업이 표시되므로 전체 일괄 가져오기를 시작하기 전에 구성을 검사, 평가 및 조정할 수 있습니다. 수집 전에 평가가 수행되므로 구성 문제를 조기에 식별하고 해결할 수 있으므로 자산 가져오기에 실패하거나 불완전한 위험을 줄일 수 있습니다.

구성 편집 edit-configuration

구성 세부 정보를 편집하려면 다음 단계를 따르십시오.

  1. 수정할 구성을 선택합니다.
  2. 구성을 편집 모드로 열려면 편집​을 클릭하세요.
  3. 필요에 따라 편집 가능한 구성 세부 정보를 업데이트한 다음 변경 사항을 저장합니다.

두 필드는 고정되어 있으며 편집 작업 중에는 수정할 수 없습니다. 구성의 제목 및 데이터 원본 가져오기. 이러한 값은 구성의 ID 및 가져온 데이터의 출처를 정의하므로 잠깁니다. 이러한 값을 만든 후 변경하면 구성을 처음 설정할 때 설정된 참조가 손상됩니다. 다른 모든 구성 세부 정보는 편집에서 계속 사용할 수 있으므로 구성을 처음부터 다시 작성하지 않고도 설정을 세분화할 수 있습니다.

구성 삭제 delete-configuration

벌크 가져오기 구성을 삭제하면 사용 가능한 구성 목록에서 영구적으로 제거됩니다. 구성이 더 이상 필요하지 않거나, 실수로 생성되었거나, 업데이트된 구성으로 대체하려는 경우 구성을 삭제합니다.

벌크 가져오기 구성을 삭제하려면 다음 단계를 수행합니다.

  1. 대량 가져오기 구성 목록에서 제거할 구성을 선택합니다.
  2. 삭제​를 클릭합니다.

이 작업은 선택한 일괄 가져오기 구성을 제거합니다. 구성을 삭제하면 저장된 설정이 제거되므로 선택한 구성을 주의 깊게 검토한 후 삭제를 확인하여 아직 사용 중인 구성을 제거하지 않도록 하십시오.

데이터 소스에 대한 연결 확인 validate-connection

연결을 확인하기 위해 구성을 사용하기 전에 Experience Manager이(가) 데이터 원본에 연결할 수 있는지, 제공된 자격 증명과 연결 매개 변수가 올바른지 확인합니다. 이 검사를 먼저 실행하면 연결할 수 없는 끝점이나 잘못된 인증으로 인한 다운스트림 오류가 방지됩니다.

데이터 소스에 대한 연결의 유효성을 검사하려면 다음 단계를 수행합니다.

  1. 유효성을 검사할 구성을 선택합니다.
  2. 확인​을 클릭합니다.

연결에 성공하면 Experience Manager에 데이터 원본에 대한 연결이 설정되었음을 나타내는 확인 메시지가 표시됩니다. 이 메시지는 구성이 유효하고 사용할 준비가 되었는지 확인합니다.

일괄 가져오기 성공 메시지

실패한 연결 문제 해결 troubleshoot-connection

유효성 검사가 성공하지 않으면 Experience Manager에서 성공 확인 대신 오류 메시지를 표시합니다. 실패한 연결을 해결하려면 다음을 확인하십시오.

  • 연결 세부 정보: 구성에 있는 호스트, 포트 및 끝점 값이 올바르게 입력되었는지 확인합니다.
  • 자격 증명: 데이터 원본에 대해 제공한 사용자 이름, 암호 또는 인증 토큰이 유효하고 최신 상태인지 확인하세요.
  • 네트워크 액세스: Experience Manager이(가) 네트워크를 통해 데이터 원본에 연결할 수 있으며 방화벽 또는 보안 규칙이 연결을 차단하지 않는지 확인하십시오.

구성을 수정한 후 확인​을 다시 클릭하여 유효성 검사를 다시 실행하십시오. 성공 메시지가 연결이 설정되었음을 확인할 때까지 이 프로세스를 반복합니다.

대량 가져오기 작업에 대한 테스트 실행 호출 invoke-test-run-bulk-import

구성을 선택하고 시험 실행​을 클릭하여 일괄 가져오기 작업에 대한 테스트 실행을 호출합니다. 시험 실행​은(는) 자산을 가져오지 않고 선택한 대량 가져오기 구성 및 해당 소스 연결 을(를) 확인합니다. 이를 통해 전체 가져오기로 커밋하기 전에 설정이 올바른지 확인할 수 있습니다. 먼저 테스트를 실행하면 실제 작업이 아닌 미리 구성 또는 연결 문제가 표시되므로 가져오기 실패 또는 부분 가져오기 위험이 줄어듭니다.

테스트 실행이 완료되면 Experience Manager에 대량 가져오기 작업에 대한 다음 세부 정보가 표시됩니다.

  • 연결 상태 — Experience Manager이(가) 제공된 자격 증명을 사용하여 구성된 원본 위치에 성공적으로 연결하는지 여부입니다.
  • Assets이(가) 검색됨 — 가져오기 조건과 일치하는 원본 경로에 있는 에셋의 수입니다.
  • 예상 가져오기 범위 — 가져올 내용에 대한 개요로서, 구성을 통해 의도한 파일을 대상으로 하는지 확인할 수 있습니다.
  • 경고 또는 오류 — 연결할 수 없는 경로, 잘못된 자격 증명 또는 지원되지 않는 에셋과 같이 가져오기를 성공하지 못하는 모든 문제입니다.

시험 실행 결과

이러한 세부 사항을 검토하여 구성이 올바른지 확인하십시오. 시험 실행​이 오류나 경고를 보고하면 실제 대량 가져오기 작업을 시작하기 전에 이를 해결하고 테스트를 다시 실행하십시오.

일괄 가져오기 도중 파일 이름 처리 filename-handling-bulkimport

자산이나 폴더를 대량으로 가져올 때 Experience Manager Assets는 가져오기 소스에 존재하는 전체 구조를 가져옵니다. Experience Manager은(는) 자산 및 폴더 이름에 있는 특수 문자에 대한 기본 제공 규칙을 따르므로 이러한 파일 이름을 삭제해야 합니다. 이렇게 하면 가져온 이름이 저장소 규칙을 준수하고 자산 경로를 손상시키지 않습니다. 폴더 이름과 자산 이름 모두에서, 사용자가 정의한 제목은 변경되지 않고 JCR(Java Content Repository) 속성 jcr:title에 저장됩니다. 이 속성은 정리된 기술 이름과 독립적으로 사람이 읽을 수 있는 제목을 유지합니다.

일괄 가져오기 중에 Experience Manager은(는) 에셋 및 폴더를 다시 가져오지 않도록 하기 위해 기존 폴더를 찾고, 가져오기가 발생하는 상위 폴더에 적용된 정리 규칙도 확인합니다. 정리 규칙이 상위 폴더에 적용되면 가져오기 소스에도 동일한 규칙이 적용됩니다. 새로운 가져오기의 경우 자산 및 폴더의 파일 이름을 관리하기 위해 다음과 같은 정리 규칙이 적용됩니다.

일괄 가져오기에서 허용되지 않는 이름

파일 및 폴더 이름에 다음 문자가 허용되지 않음​입니다.

  • 제어 및 전용 사용 문자(0x00 ~ 0x1F, \u0081, \uE000)
  • 파일 또는 폴더 이름 점(.)으로 끝나는

따라서 가져오기 프로세스 중에 이름이 이러한 조건과 일치하는 파일 또는 폴더를 건너뛰고 실패로 표시됩니다.

일괄 가져오기에서 자산 이름 처리

자산 파일 이름의 경우 Experience Manager이(가) API JcrUtil.escapeIllegalJcrChars​을(를) 사용하여 JCR 이름 및 경로를 정리합니다.

  • 유니코드 문자는 변경되지 않음

  • 특수 문자를 URL 이스케이프 코드로 바꿉니다. 예를 들어 new%asset.png이(가) new%25asset.png(으)로 업데이트되었습니다.

    code language-none 
                    URL escape code

"               %22
%               %25
'               %27
*               %2A
/               %2F
:               %3A
[               %5B
\n              %0A
\r              %0D
\t              %09
]               %5D
|               %7C

일괄 가져오기에서 폴더 이름 처리

폴더 파일 이름의 경우 Experience Manager이(가) API DamUtil.getSanitizedFolderName​을(를) 사용하여 JCR 이름 및 경로를 정리합니다.

  • 대문자는 소문자로 변환됨

  • 유니코드 문자는 변경되지 않음

  • 예를들어, new folder이(가) new-folder(으)로 업데이트되었습니다.

    code language-none 
    "
#
%
&
*
+
.
:
;
?
[
]
^
{
}
|
/         It is used for split folder in cloud storage and is pre-handled, no conversion here.
\         Not allowed in Azure, allowed in AWS.
\t
space     It is the space character.

1회 또는 반복 일괄 가져오기 예약 schedule-bulk-import

일회성 일괄 가져오기 또는 반복 일괄 가져오기를 예약하려면 다음 단계를 실행합니다.

  1. 대량 가져오기 구성을 만듭니다.

  2. 구성을 선택하고 도구 모음에서 일정​을 선택합니다.

  3. 일회성 수집을 설정하거나 시간별, 일별 또는 주별 일정을 설정합니다. 제출​을 클릭합니다. 반복 일정을 사용하면 수동으로 다시 실행하지 않고도 정의된 간격에 따라 가져오기 소스의 새 에셋을 자동으로 수집할 수 있습니다.

    일괄 수집기 작업 예약

Assets 대상 폴더 보기 view-assets-target-folder

일괄 가져오기 작업을 실행한 후 자산을 가져오는 Assets 대상 위치를 보려면 구성을 선택한 다음 Assets 보기​를 클릭합니다.

일괄 가져오기 도구 실행 run-bulk-import-tool

일괄 가져오기 도구를 구성하고 선택적으로 일괄 가져오기 도구 구성을 관리한 후 관리자는 구성 작업을 실행하여 자산의 일괄 수집을 시작할 수 있습니다.

일괄 가져오기 프로세스를 시작하려면 도구 > Assets > 일괄 가져오기(으)로 이동하고 일괄 가져오기 구성을 선택한 다음 실행​을 클릭합니다. 확인하려면 실행​을 다시 클릭하세요.

Experience Manager은(는) 작업이 성공적으로 완료되면 작업 상태를 처리 중 및 성공(으)로 업데이트합니다. Experience Manager에서 가져온 자산을 보려면 보기Assets​을(를) 클릭하십시오.

작업이 진행되는 동안 다음과 같이 수집 프로세스를 제어할 수 있습니다.

  • 중지 — 구성을 선택하고 중지​를 클릭하여 일괄 수집 프로세스를 중지합니다.
  • 실행 — 중지된 위치에서 프로세스를 다시 시작하려면 실행​을 다시 클릭합니다.
  • 시험 실행 — 시험 실행​을 클릭하여 수집을 커밋하지 않고 가져오기 보류 중인 자산의 세부 정보를 확인합니다. 이를 통해 관리자는 가져오기가 완료되기 전에 해당 범위를 확인할 수 있습니다.

실행 후 작업 관리 manage-jobs-after-execution

Experience Manager을(를) 사용하면 대량 가져오기 작업의 기록을 볼 수 있습니다. 작업 내역은 작업 상태, 작업 생성자, 로그와 함께 시작 날짜 및 시간, 생성 날짜 및 시간, 완료 날짜 및 시간 등의 기타 세부 정보로 구성됩니다. 이 기록은 관리자가 각 일괄 가져오기 작업을 추적, 문제 해결 및 확인할 수 있는 전체 감사 추적을 제공합니다.

일괄 가져오기 구성에 대한 작업 내역 보기 viewing-job-history

작업 기록 보기를 사용하면 특정 일괄 가져오기 구성에 대한 실행 레코드를 검토하여 이전 가져오기 실행 및 그 결과를 볼 수 있습니다. 구성에 대한 작업 내역에 액세스하려면 다음을 수행합니다.

  1. 내역을 검토할 구성을 선택합니다.
  2. 작업 기록​을 클릭합니다.
  3. 목록에서 특정 작업을 선택합니다.
  4. 해당 작업의 전체 세부 정보를 보려면 열기​를 클릭하십시오.

일괄 수집기 작업 예약

Adobe Experience Manager은(는) 작업 기록을 표시하므로 기록된 각 대량 가져오기 작업의 상태와 결과를 검사할 수 있습니다. 이 기록을 검토하면 가져오기가 성공적으로 완료되었는지 확인하고 예상대로 완료되지 않은 작업 문제를 해결하는 데 유용합니다.

대량 가져오기 작업 기록 페이지에서 삭제​를 클릭하여 구성에서 특정 대량 가져오기 작업을 제거할 수도 있습니다. 작업을 삭제하면 일괄 가져오기 구성에 대한 작업 기록에서 해당 레코드가 제거되어 기록 목록을 정리하고 관련 실행에 초점을 맞출 수 있습니다.

데스크탑 클라이언트를 사용하여 에셋 업로드 upload-assets-desktop-clients

Adobe Experience Manager은(는) 웹 브라우저 UI(사용자 인터페이스) 외에도 자산 업로드 Adobe Asset Link 및 Experience Manager데스크톱 앱​에 대한 두 개의 데스크톱 클라이언트를 지원합니다. 두 데스크탑 클라이언트 모두 웹 브라우저를 열지 않고도 직접 에셋 업로드를 가능하게 합니다.

  • Adobe Asset Link은(는) Adobe Photoshop, Adobe Illustrator 및 Adobe InDesign 데스크톱 응용 프로그램 내에서 Experience Manager개의 자산에 직접 액세스할 수 있는 권한을 제공합니다. Photoshop, Illustrator 또는 InDesign을 종료하지 않고 현재 열려 있는 문서를 Adobe Asset Link 인터페이스에서 직접 Experience Manager에 업로드합니다.
  • Experience Manager 데스크톱 앱은(는) 파일 형식이나 각 에셋을 처리하는 기본 응용 프로그램에 관계없이 데스크톱에서 에셋 관리를 간소화합니다. 브라우저 업로드는 플랫 파일 목록만 지원하므로 데스크톱 앱은 로컬 파일 시스템에서 중첩된 폴더 계층 구조​에 있는 파일을 업로드하는 기본 클라이언트입니다. 따라서 폴더 구조를 유지할 때 Experience Manager 데스크톱 앱은 한 번의 작업으로 전체 계층 구조를 업로드하지만, 브라우저에서는 먼저 파일을 병합해야 합니다.

업로드 시 에셋 처리 process-when-uploaded

업로드된 에셋에 대한 추가 처리를 수행하려면 업로드 폴더에 처리 프로필​을 적용하십시오. 이러한 프로필은 Assets에 있는 폴더의 속성 페이지에서 사용할 수 있으며, 각 자산이 폴더에 추가된 후 변형되는 방식을 제어합니다.

처리 프로필 추가 옵션이 있는 자산 폴더의 속성

확장이 없거나 잘못된 디지털 자산은 원하는 대로 처리되지 않습니다. 따라서 이러한 에셋을 업로드할 때 시스템이 올바른 프로필을 선택하기 위해 파일 확장명을 사용하므로 아무것도 발생하지 않거나 잘못된 처리 프로필이 적용될 수 있습니다. 올바른 프로필이 자동으로 실행되지 않는 경우에도 사용자는 DAM(디지털 에셋 관리) 저장소에 바이너리 파일을 저장할 수 있습니다.

다음 탭을 사용할 수 있습니다.

  • 메타데이터 프로필은(는) 해당 폴더에 업로드된 자산에 기본 메타데이터 속성​을 적용하여 폴더 전체에서 일관되고 검색 가능한 메타데이터를 유지합니다.
  • 처리 프로필은(는) 기본적으로 가능한 것보다 더 많은 렌디션​을 생성하여 각 소스 에셋에서 생성된 파생된 버전 집합을 확장합니다.

또한 배포에서 Dynamic Media​을(를) 사용하도록 설정한 경우 다음 추가 탭을 사용할 수 있습니다.

NOTE
Dynamic Media 자르기 및 자산에 대한 기타 작업은 비파괴적입니다. 즉, 이 작업은 업로드된 원본을 변경하지 않습니다. 대신 Dynamic Media은(는) 배달 시간에 자산을 자르거나 변형하는 매개 변수를 제공합니다. 이렇게 하면 소스 바이너리가 그대로 유지되고 다른 변환에 다시 사용할 수 있습니다.

처리 프로필이 할당된 폴더의 경우 프로필 이름이 카드 보기의 썸네일에 표시됩니다. 목록 보기에서 처리 프로필 열에 프로필 이름이 나타납니다.

API를 사용하여 에셋 업로드 또는 수집 upload-using-apis

개발자 참조의 자산 업로드 섹션은 오픈 소스 소프트웨어 개발 키트(SDK) 및 샘플 클라이언트에 대한 링크와 함께 업로드 API 및 프로토콜에 대한 전체 기술 세부 정보를 제공합니다. 이러한 API(애플리케이션 프로그래밍 인터페이스)를 통해 개발자는 자산을 프로그래밍 방식으로 업로드하거나 수집할 수 있으므로 수동 업로드보다는 자동화되고 반복 가능한 워크플로우를 사용할 수 있습니다. 오픈 소스 SDK 및 샘플 클라이언트는 업로드 프로토콜이 실제로 작동하는 방식을 보여 주는 사용 준비된 참조 구현을 제공하여 통합을 가속화합니다.

자산 업로드 보안 및 모범 사례 asset-upload-security-and-best-practices

에셋 업로드 보안은 사용자 또는 시스템이 제출한 파일의 유효성 검사, 스캔, 저장 및 서비스 방법을 제어하므로 악의적인 콘텐츠, 데이터 손상, 스토리지 또는 대역폭 남용으로부터 애플리케이션을 보호합니다. 무제한 또는 검증되지 않은 업로드는 맬웨어 삽입, 무단 코드 실행 및 서버 리소스 소진에 가장 일반적인 매개변수가 되기 때문에 업로드 파이프라인 보안은 매우 중요한 것으로 간주됩니다.

핵심 업로드 보안 제어 core-upload-security-controls

효과적인 자산 업로드 보안은 업로드 수명 주기의 모든 단계에서 적용되는 계층화된 제어에 의존합니다. 주요 제어 내용은 다음과 같습니다.

  • 파일 형식 유효성 검사 — 허용 목록은 무시하기가 훨씬 어렵고 위장한 실행 가능한 콘텐츠가 미끄러지는 것을 방지하기 때문에 허용 목록에 추가하다가 아닌 허용된 형식의 명시적 차단 목록에 추가하다에 대해 각 업로드를 확인합니다.
  • 파일 크기 제한 — 최대 크기 임계값을 적용하여 디스크 공간이나 메모리를 다 사용할 수 있는 과대 업로드로 인한 서비스 거부 상태를 방지합니다.
  • 콘텐츠 검사 — 공격자가 해로운 파일을 가장하기 위해 확장을 정기적으로 스푸핑하므로 파일 확장명이나 클라이언트가 제공한 MIME(Multipurpose Internet Mail Extensions) 형식을 신뢰하는 대신 실제 파일 서명(Magic Bytes)을 검사합니다.
  • 맬웨어 검사 - 업로드한 자산을 사용 가능하게 만들기 전에 바이러스 백신 또는 맬웨어 검사를 통해 실행하여 감염된 파일이 다른 사용자에게 배포되지 않고 격리되도록 합니다.
  • 파일 이름 정리 — 경로 트래버스 및 디렉터리 이스케이프 공격을 방지하기 위해 파일 이름에서 특수 문자, 경로 구분 기호 및 제어 시퀀스를 삭제하거나 정규화합니다.

다음 모범 사례를 순서대로 적용하여 업로드 워크플로를 강화합니다.

  1. 서버에서 유효성 검사 — 모든 클라이언트측 유효성 검사를 권고 사항으로만 처리하고 모든 검사 서버측을 적용합니다. 악의적인 작업자가 클라이언트측 컨트롤을 건너뛸 수 있기 때문입니다.
  2. 웹 루트 외부에 자산 저장 — 업로드된 파일을 웹 서버에서 직접 실행할 수 없는 위치에 보관합니다. 이렇게 하면 공격자가 업로드된 스크립트를 코드로 실행할 수 없습니다.
  3. 업로드된 파일 이름 바꾸기 - 서버에서 생성한 예측 불가능한 식별자를 저장된 파일에 할당하여 기존 자산을 덮어쓰지 않도록 하고 저장된 콘텐츠를 열거하지 않도록 합니다.
  4. 권한 제한 — 업로드된 파일에 필요한 최소 읽기 및 쓰기 권한을 부여하고 실행 파일로 표시하지 않으므로 손상된 파일을 실행할 수 없습니다.
  5. 업로드 인증 및 승인 — 요청하는 사용자에게 업로드 권한이 있는지 확인하여 익명의 남용 및 승인되지 않은 제출에 대한 노출을 제한합니다.
  6. 속도 제한 및 스로틀 — 사용자 또는 세션당 업로드 속도 제한을 적용하여 자동 남용 및 리소스 소진 위험을 줄입니다.

업로드 후 처리 및 저장 handling-and-storage-after-upload

파일이 수락된 후에도 보안 책임은 계속됩니다. 저장 및 제공 중 자산을 보호하려면 다음 작업을 수행하십시오.

  • 암호화된 연결을 통해 자산 제공 — HTTPS(Hypertext Transfer Protocol Secure)를 통해 업로드된 콘텐츠를 전달하므로 전송 중에 파일을 가로채거나 변조할 수 없습니다.
  • 사용자 생성 콘텐츠 격리 — 별도의 도메인 또는 전용 CDN(콘텐츠 전달 네트워크)​에서 신뢰할 수 없는 업로드를 처리합니다. 이 콘텐츠를 격리하면 교차 사이트 스크립팅 및 쿠키 도난 공격의 영향이 제한되기 때문입니다.
  • 올바른 응답 헤더 설정 — 정확한 Content-Type 헤더를 반환하고 적절한 경우 강제로 다운로드하므로 브라우저에서 저장된 파일을 잘못 해석하고 실행하지 않습니다.
  • 업로드 기록 및 감사 - 업로드 메타데이터 및 액세스 이벤트를 기록하여 인시던트 조사를 지원하고 남용 패턴을 조기에 탐지하는 데 도움이 됩니다.

이러한 제어 및 모범 사례에 따라 에셋 업로드에 대한 방어 심층적 접근 방식을 설정하여 하나의 확인 누락이 전체 타협으로 이어지는 위험을 줄입니다.

사전 서명된 URL을 사용한 직접적인 바이너리 업로드 direct-binary-upload

Adobe Experience Manager​(AEM) as a Cloud Service이(가) 직접적인 바이너리 업로드 흐름을 통해 에셋을 업로드하는 3단계 순서: (1) 클라이언트가 사전 서명된 URL​을(를) 요청하고, (2) 해당 URL을 사용하여 바이너리를 저장소에 직접 업로드하고, (3) 에셋이 인증된 API 호출로 완료됩니다. 이 설계는 자산 등록을 인증된 제어 하에 유지하면서 큰 바이너리 전송을 스토리지로 직접 오프로드합니다.

URL 라이프타임 및 재사용 url-lifetime-and-reuse

  • 사전 서명된 URL은 수명이 짧고 약 1시간 동안 유효합니다. 그러나 정확한 TTL(Time to Live)​은(는) 게시되거나 보장된 Service level agreement(SLA)가 아닙니다. 지속 시간을 변경할 수 있는 구현 세부 사항으로 취급하고 값을 통합으로 하드 코딩하지 마십시오.
  • 사전 서명된 URL은 단일 업로드 세션의 일부로 즉시 사용해야 합니다. 나중에 저장 및 재사용하도록 설계되지 않았으며 여러 업로드에서 재사용할 수 없습니다. 각 업로드 세션은 자체 URL을 가져옵니다.

사전 서명된 URL 보안 security-of-presigned-urls

  • 자산 만들기 및 종료는 올바른 자격 증명과 uploadToken​을(를) 사용하는 별도의 인증된 API 호출에 따라 다르므로 사전 서명된 URL을 유출하는 것만으로는 자산을 만들 수 없습니다. 행위자가 사전 서명된 URL만 가져오는 경우 해당 행위자는 유효한 인증 및 관련 업로드 토큰 없이 에셋 등록을 완료할 수 없습니다.
  • 이 인증 요구 사항은 유출된 URL의 실질적인 영향을 제한합니다. 필수 자격 증명과 uploadToken​은(는) 두 번째 제어로 작동하므로 URL을 단독으로 노출해도 권한이 없는 에셋이 등록되지 않습니다.
  • 사전 서명된 URL을 자체 통합에서 중요한 값으로 처리합니다. 기록하지 말고 항상 HTTPS​를 사용하고 업로드 세션 이후에 지속하지 마십시오.

프로그래밍 방식 업로드를 위한 인증 authentication-for-programmatic-uploads

JWT(서비스 자격 증명)​만 Adobe Experience Manager​(AEM)에 프로그래밍 방식의 에셋 업로드를 지원합니다. AEM API 액세스에 두 가지 인증 메커니즘이 있으며 자산 업로드 작업에 대해 상호 교환 불가​입니다. 잘못된 자격 증명 유형을 선택하는 것은 업로드 통합 실패의 가장 일반적인 원인입니다.

자격 증명 유형
생성된 위치
자산 업로드 API에 대해 지원되는지 여부
OAuth 서버 간(S2S) 자격 증명
Adobe Developer Console
자산 업로드 API 호출에 대해 지원되지 않음​입니다. 자산 업로드 API가 이 자격 증명 유형을 완전히 거부하므로 이를 사용하면 올바르게 할당된 제품 프로필(예: Assets명의 Collaborator 사용자)에도 지속적인 403 금지됨 오류가 발생합니다.
서비스 자격 증명(JWT)
AEM Developer Console
이 은(는) 서버 간 에셋 업로드 API 호출에 지원됩니다.
NOTE
에셋의 바이너리를 직접 업데이트하는 이전 에셋 HTTP API는 더 이상 사용되지 않습니다. 새로운 통합에서는 자산 바이너리를 프로그래밍 방식으로 AEM으로 전송하는 현재 지원되는 메서드인 다이렉트 이진 업로드 흐름을 대신 사용합니다.

API 업로드에 사용되는 기술 계정은 경로 수준에서 명시적 저장소 수준 액세스 제어 목록(ACL)​이 부여되어야 합니다. 두 가지 ACL 권한이 필요합니다.

  • /content/dam​의 jcr:read — DAM(디지털 에셋 관리) 콘텐츠 루트에 대한 읽기 액세스 권한을 부여합니다.
  • 특정 대상 하위 폴더의 rep:write(또는 jcr:all) — 자산이 업로드되는 대상 경로에 대한 쓰기 액세스 권한을 부여합니다.

이러한 경로 수준 ACL에는 올바른 자격 증명 형식과 올바른 관리자 콘솔 제품 프로필 또는 그룹 멤버십이​에 추가로 필요합니다.

기술 계정의 라이선스를 올바르게 부여하고 그룹화할 수 있으며 여전히 403 금지됨 오류를 받습니다. 이 문제는 제품 프로필 또는 그룹 할당 및 저장소 ACL이 독립 컨트롤이며 둘 다 필수​이기 때문에 발생합니다. 따라서 경로 수준 ACL이 부여되지 않은 경우 자격 증명 유형과 제품 프로필이 올바르게 구성된 경우에도 계정에 대한 액세스가 거부됩니다.

맬웨어 감지 및 격리 malware-detection-and-quarantine

Adobe Experience Manager (AEM)의​맬웨어 감지​ ​ ​이(가) 업로드된 모든 파일을 검색하고 감염된 파일을 전용 격리 영역으로 이동하여 저장소의 나머지 부분에서 의심스러운 자산을 격리합니다. 맬웨어 검색​을 사용하도록 설정하면 시스템이 각 업로드를 검사하고 감염이 감지되면 파일을 자동으로 격리합니다. 이렇게 하면 활성 워크플로우에서 위협을 격리하고 감염된 에셋이 게시, 다운로드 또는 다른 사용자에게 배포되는 것을 방지할 수 있습니다.

격리된 자산에 대한 액세스는 전용 격리 관리자 그룹을 통해 적용된 표준 Adobe Experience Manager​(AEM) 권한​에 의해 관리됩니다. 격리 가시성이 고정된 단일 역할에 연결되지 않으므로 액세스 권한을 유연하게 확장할 수 있습니다.

  • 격리 관리자 그룹 구성원은 기본적으로 격리된 자산에 액세스할 수 있습니다.
  • 추가 사용자 지정 그룹​은(는) 운영 또는 보안 요구 사항이 광범위한 감독을 요구할 때 격리 영역에 대한 액세스 권한을 부여 받을 수 있습니다.
  • 따라서 여러 그룹​은(는) 기능을 하나의 역할로 제한하지 않고 동시에 격리 가시성을 유지할 수 있습니다.

이 권한 모델을 사용하면 권한이 있는 사용자만 격리된 콘텐츠를 검사, 릴리스 또는 제거할 수 있으므로 잠재적으로 유해한 파일에 대한 제어된 검토 프로세스를 유지할 수 있습니다.

맬웨어 검색 및 격리에 대한 자세한 내용은 맬웨어 검색을 참조하세요.

파일 유형 처리 및 업로드 제한 사항 file-type-handling-and-upload-restrictions

  • Adobe Experience Manager​(AEM)에서는 업로드에 기본 파일 형식 제한을 적용하지 않습니다. 실행 파일 확장명​이 포함된 파일(예: .exe 또는 .exe.pdf)을 에셋 변환으로 업로드할 수 있습니다.
  • 이는 취약성이 아닌 예상되는 행동입니다. AEM은 브라우저나 서버에서 업로드된 활성 콘텐츠 또는 스크립트​를 렌더링하거나 실행하지 않습니다. 업로드된 파일은 코드로 실행되지 않고 비활성 자산 변환으로만 저장되고 사용되므로 실행 파일을 업로드하면 AEM의 기본 보안 모델에서 RCE(원격 코드 실행) 위험이 발생하지 않습니다. AEM이 자체적으로 이를 적용하지 않고 배포 조직에 이러한 제어를 남겨두기 때문에 규정 준수 요구 사항이 더 엄격한 조직은 필요한 경우 자체 업로드 유효성 검사 또는 허용 목록​을 적용해야 합니다.
  • 에셋 처리에 대해 지원되는 파일 형식 및 MIME(Multipurpose Internet Mail Extensions) 유형이 별도로 문서화됩니다. 지원되지 않는 유형은 완전히 처리되지 않습니다. 즉, 지원되지 않는 파일은 예상 표현물을 생성하지 못할 수 있습니다.

신뢰성 모범 사례 업로드 upload-reliability-best-practices

업로드하기 전에 에셋 최적화 optimize-assets-before-upload

  • 비디오, PDF 및 GIF​와 같은 대규모 또는 특수 에셋 유형의 경우 권장 파일 크기 제한, 인코딩 설정 및 기본 형식을 따르십시오. 이러한 사양을 준수하면 크기가 초과되거나 비표준 파일이 트랜스코딩 및 썸네일 생성 단계에 가장 많은 부하를 주기 때문에 업로드, 처리 및 미리보기 생성 중 플랫폼 성능에 영향을 주지 않습니다.

비즈니스 크리티컬 파일에 지원되는 업로드 경로 사용 use-supported-upload-paths

  • 임시 폴더 수준의 일괄 업로드가 아닌 비즈니스 크리티컬 파일에 대해 지원되는 업로드 API 또는 UI 흐름을 사용​하십시오. 지원되는 경로는 일관성 있는 유효성 검사, 인코딩 및 오류 처리를 적용하므로 손상 또는 손실을 견딜 수 없는 파일을 보다 안정적으로 선택할 수 있습니다.
  • 폴더 수준의 드래그 앤 드롭 업로드를 수행하면 보고된 사례별로 파일 손상​이 발생하는 경우가 있습니다. 따라서 중요한 자산에는 권장되지 않습니다.

폴더 수준 업로드에 실패하거나 파일이 손상되는 경우 folder-level-upload-fails

증거 자료를 즉시 확보하십시오. 기본 원인은 환경별 또는 파일별로 다르기 때문에 증거가 분실되면 진단이 어려워지기 때문입니다.

  1. 정확한 오류 메시지 또는 관찰된 동작을 기록합니다. 오류 발생 즉시 기록하십시오.
  2. 오류 상태 및 오류 대화 상자의 스크린샷을 찍습니다.
  3. HAR(HTTP 보관) 파일을 저장 또는 네트워크 로그​를 브라우저 세션에서 저장하십시오. 오류를 추적하는 데 필요한 요청/응답 세부 정보를 캡처합니다.
  4. 지원되는 업로드 경로에 대해 다시 테스트할 수 있도록 영향을 받는 파일을 유지​합니다.

이 증거를 즉시 캡처하면 지원 팀과 엔지니어링 팀이 문제를 재현하고 해결하는 데 필요한 환경 및 파일별 세부 정보를 얻을 수 있지만, 사후 손상(로그 또는 원본 오류 없음)을 진단하는 것은 비현실적인 경우가 많습니다.

업로드 실패에 대한 체크리스트 문제 해결 troubleshooting-checklist-for-upload-failures

  1. API(Application Programming Interface) 업로드가 금지됨: 먼저 자격 증명 형식을 확인하십시오. Adobe Developer Console의 OAuth S2S(서버 간) 자격 증명이 자산 업로드 API에 대해 지원되지 않음​됩니다. 대신 Adobe Experience Manager​(AEM) 개발자 콘솔에서 발급된 서비스 자격 증명(JSON 웹 토큰 또는 JWT)​을(를) 사용하십시오. 두 자격 증명 유형은 서로 다른 콘솔을 통해 프로비저닝되고 서로 다른 범위를 부여하므로, 다른 자격 증명 유형을 다른 자격 증명 유형으로 대체하면 계정이 유효한 것으로 보이는 경우에도 403 사용할 수 없음​이 생성됩니다.

  2. 403 자격 증명 및 그룹 멤버십이 올바르더라도 사용할 수 없습니다: 기술 계정에 특정 대상 폴더의 /content/dam 및 rep:write/jcr:all​에 명시적 jcr:read​이(가) 있는지 확인하십시오. AEM은 역할로만 작성하지 않고 저장소 노드 수준에서 자산 쓰기를 승인하므로 그룹 또는 프로필 멤버십은 폴더 수준 ACL(액세스 제어 목록)을 대체하지 않습니다. 따라서 계정은 올바른 그룹에 속할 수 있지만 노드 수준 ACL이 정확한 대상 폴더에 설정될 때까지 계속 거부됩니다.

  3. 업로드가 성공했지만 자산이 표시되지 않거나 바이너리가 손상된 것 같습니다: 수집 방법으로 폴더 수준 일괄 업로드를 배제하십시오. 표준 업로드 API 또는 UI(사용자 인터페이스)를 통해 다시 시도하고 문제가 반복되면 로그를 캡처합니다. 대량 수집 경로는 표준 API와 다르게 바이너리를 처리하므로 수집 방법을 격리하는 것이 업로드 경로 자체에서 손상이 발생하는지 여부를 확인하는 가장 빠른 방법입니다.

  4. 보안 검토 플래그 무제한 파일 업로드: AEM은 기본적으로 업로드된 활성 콘텐츠 서버측 또는 인브라우저를 실행하지 않습니다. 콘텐츠가 실행되지 않으므로 제한되지 않은 파일 업로드는 결함이 아닌 플랫폼 비헤이비어가 될 수 있습니다. 즉, 콘텐츠가 실행되지 않을 경우 저장된 액티브 콘텐츠의 주요 위험이 없어집니다. 이 설정은 조직에서 추가 업로드 시간 유효성 검사를 필요로 하지 않는 한 유지됩니다. 이 경우 유효성 검사는 기본 동작 위에 정책 제어로 추가해야 합니다.

  5. 사전 서명된 URL 노출에 대해 걱정함: 사전 서명된 URL은 이진 파일을 저장소로 직접 전송하는 데 사용되는 시간 제한 및 사전 승인된 링크입니다. URL이 짧은 유효성 창 내에서 사용되었는지, 그리고 자산 종료에 유효한 uploadToken​을(를) 전달하는 별도의 인증된 호출이 필요하는지 확인하십시오. 이 2단계 디자인은 유출된 사전 서명된 URL(Uniform Resource Locator)의 노출 범위를 제한합니다. URL 소유만으로는 유효하고 별도로 인증된 uploadToken 없이 자산을 확정할 수 없기 때문입니다. 따라서 유효성 창이 닫힌 후 유출되는 URL에는 실제 쓰기 기능이 없습니다.

팁, 모범 사례 및 제한 사항 tips-limitations

  • 직접적인 바이너리 업로드​는 자산을 업로드하는 새로운 방법입니다. 기본적으로 Experience Manager 사용자 인터페이스, Adobe Asset Link 및 Experience Manager 데스크톱 앱을 비롯한 제품 기능 및 클라이언트에서 지원됩니다. 고객의 기술 팀에서 사용자 정의하거나 확장하는 모든 사용자 지정 코드는 새로운 업로드 API(Application Programming Interface) 및 프로토콜을 사용해야 합니다.

  • 큰 폴더 처리: Experience Manager Assets은(는) 1000개 이상의 직접 하위 폴더(자산 또는 하위 폴더)를 포함하는 폴더를 지원합니다. 폴더가 이 1,000개 항목 임계값​을 초과하면 관리 UI는 비동기적으로 업데이트된 인덱스로 전환하여 폴더 콘텐츠를 나열합니다. 이 색인은 비동기적으로 업데이트되므로 새로 만든 폴더 및 자산은 짧은 지연 후에 나타나며 일반적으로 몇 초​에 불과합니다. 관리자 보기에서 이러한 폴더를 열 때 배너는 최종 사용자에게 다음과 같은 동작을 알립니다. “이 디렉터리에는 1,000개 이상의 항목이 있습니다. 업로드 및 새 폴더 생성이 지연될 수 있습니다.”

  • 바꾸기 및 자산 ID 다시 생성: 이름 충돌 대화 상자에서 바꾸기​을(를) 선택하면 새 자산에 대해 자산 ID가 다시 생성됨​됩니다. 이 ID는 이전 에셋의 ID와 다릅니다. Assets Insights에서 Adobe Analytics을(를) 사용하여 노출수 또는 클릭수를 추적할 수 있도록 설정한 경우 Analytics에서 원래 자산 ID에 대한 노출수 및 클릭수를 추적하고 새 ID를 이전 레코드와 조정할 수 없기 때문에 다시 생성된 자산 ID가 Analytics에서 자산에 대해 캡처된 데이터를 무효화합니다.

  • 파일 이름에 사용할 수 없는 문자: 일부 업로드 방법을 사용하면 사용자가 파일 이름에 사용할 수 없는 문자 사용할 수 없는 문자가 있는 자산을 업로드할 수 있습니다. 이러한 경우 금지된 문자는 - 기호로 대체됩니다.

  • 브라우저 업로드 제한 사항: 브라우저를 사용하여 에셋을 업로드하면 중첩된 폴더 계층이 아닌 플랫 파일 목록만 지원됩니다. 중첩된 폴더 내의 모든 자산을 업로드하려면 전송 중에 폴더 구조를 유지하는 데스크톱 앱을(를) 사용합니다.

  • 폴더 구조 일괄 가져오기: 일괄 가져오기 메서드는 전체 폴더 구조를 데이터 원본에 있는 그대로 가져옵니다. 그러나 Experience Manager에는 비어 있지 않은 폴더만 만들어집니다. 즉, 원본의 빈 폴더는 가져온 계층에서 생략됩니다.

추가 참조

Related Articles
recommendation-more-help
experience-manager-cloud-service-help-main-toc