클라우드 스토리지 연결
암호화된 미디어 전송을 위해 AWS S3, Microsoft Azure, Google Cloud Storage, Alibaba Cloud OSS 또는 Tencent Cloud COS를 연결합니다.
Follow the first cloud package tutorial to connect a provider, publish a test clip and verify playback.
For Tencent Cloud COS, follow the step-by-step COS setup and playback guide.
1. Choose your storage#
관리형 1AICLOUD를 사용하거나 AWS S3, Microsoft Azure Blob Storage, Google Cloud Storage, Alibaba Cloud OSS 또는 Tencent Cloud COS를 연결하세요. 암호화 미디어와 의도적으로 공개할 자산을 위한 전용 버킷 또는 컨테이너를 만드세요. 원본 영상과 비공개 문서는 별도 스토리지에 보관하세요.
프로덕션 사용 전 본인 계정, 권한, 리전 및 전송 설정으로 커넥터를 검증해야 합니다. 연결 확인 성공은 목록 조회만 검증합니다. 아래 업로드 및 재생 확인도 완료하세요.
| Provider | Connection fields | Access method |
|---|---|---|
| AWS S3 | 버킷, 리전, Access key ID, Secret access key | Amazon S3 API. 그림으로 설명한 S3 및 CloudFront 가이드를 참조하세요. |
| Microsoft Azure Blob Storage | 컨테이너, 스토리지 계정 이름, 스토리지 계정 키 | 단일 blob용 단기 HTTPS 업로드 SAS를 사용하는 네이티브 Blob API. Azure 퍼블릭 클라우드만 지원합니다. |
| Google Cloud Storage | 버킷, 서비스 계정의 HMAC access ID 및 HMAC secret | https://storage.googleapis.com의 XML API. 서비스 계정 JSON 키는 HMAC 자격 증명이 아닙니다. |
| Alibaba Cloud OSS | 버킷, cn-hangzhou 등의 리전, RAM AccessKey ID 및 AccessKey secret | https://oss-cn-hangzhou.aliyuncs.com의 S3 호환 API. Alibaba Cloud에서 계정의 S3 호환 인증을 활성화해야 할 수도 있습니다. |
| Tencent Cloud COS | APPID를 포함한 전체 버킷 이름, ap-guangzhou 등의 리전, CAM SecretId 및 SecretKey | S3-compatible API at https://cos.ap-guangzhou.myqcloud.com. |
DRM-X는 계정 또는 리전에서 새 공급자의 API 엔드포인트를 도출합니다. 클라우드 공급자는 스토리지, 요청, 전송 및 해당하는 대역폭 비용을 별도로 청구합니다. 실제 사용량과 공급자 요금을 사용 가능한 1AICLOUD 요금제와 비교하세요.
2. Configure credentials#
전송 버킷에 필요한 목록 조회, 읽기, 쓰기, 복사 및 삭제 권한만 부여하세요. Google은 Cloud Storage Settings → Interoperability의 서비스 계정 HMAC 자격 증명을 사용합니다. Alibaba는 RAM, Tencent는 CAM 자격 증명을 사용합니다. 자격 증명은 Console → Cloud Storage → Connect storage에만 저장하세요. DRM-X는 저장된 자격 증명을 암호화하며 저장 후 비밀 값을 반환하지 않습니다. 편집 시 두 자격 증명 필드를 모두 비워 두면 기존 값이 유지되고, 둘 다 입력하면 교체됩니다.
Azure에서는 Shared Key 접근을 활성화한 전용 스토리지 계정을 사용하세요. 계정 키는 스토리지 계정 전체에 접근할 수 있으므로 전송 데이터와 비공개 데이터를 분리하세요. 이 커넥터에는 Microsoft Entra 인증, user-delegation SAS 및 소버린 클라우드 엔드포인트가 포함되지 않습니다.
3. Configure public HTTPS delivery#
암호화 미디어의 공개 전송 URL 또는 CDN 오리진을 선택하세요. AWS에서는 CloudFront Origin Access Control을 적용한 비공개 S3 버킷을 사용하세요. Azure에서는 구성된 HTTPS CDN이나 의도적으로 공개 blob 접근을 허용한 컨테이너를 사용하세요. 직접 Blob URL에는 https://ACCOUNT.blob.core.windows.net/CONTAINER/protected처럼 계정과 컨테이너가 모두 포함됩니다. Google, Alibaba, Tencent에서는 버킷에 매핑되는 HTTPS 전송 도메인이나 CDN을 구성하세요. 클라우드 콘솔 URL, 비공개 API 전용 엔드포인트, 만료되는 서명 URL 또는 자격 증명이 포함된 URL을 공개 접두사로 사용하지 마세요.
공개 객체 접근은 암호화된 바이트를 노출하며, DRM 라이선스 권한 부여가 복호화를 제어합니다. CDN 응답을 포함하여 최종 전송 호스트에 GET/HEAD CORS를 구성하세요.
4. Allow browser uploads and playback#
https://6.drm-x.com에서만 PUT을 허용하는 업로드 CORS 규칙을 만드세요. Content-Type와 아래 공급자별 헤더를 허용하세요. 각 공급자의 CORS 구성 형식을 사용하세요. Azure와 Google은 S3 CORS JSON 문서를 허용하지 않습니다.
| Provider | 추가로 허용할 업로드 헤더 |
|---|---|
| AWS S3, Google Cloud Storage, Tencent Cloud COS | x-amz-meta-drmx-sha256 |
| Alibaba Cloud OSS | x-amz-meta-drmx-sha256, x-oss-s3-compat |
| Microsoft Azure Blob Storage | x-ms-blob-type, x-ms-meta-drmx_sha256 |
GET 및 HEAD용 재생 규칙을 별도로 추가하고, Range 요청 헤더를 허용하며 ETag, Content-Length, Content-Range, Accept-Ranges을 노출하세요. 암호화 미디어의 공개 읽기 출처에는 *를 사용하거나 정확한 플레이어 출처를 나열하세요. 미디어 요청에는 교차 출처 쿠키를 보내지 않아야 합니다. CORS는 브라우저 구성이지 접근 권한 부여가 아닙니다.
5. Connect and map paths#
Cloud Storage를 열고 Connect storage를 선택한 다음 공급자와 해당 필드를 입력하세요. 필요하면 보호 콘텐츠의 기본 경로와 이에 맞는 공개 URL 접두사를 설정하세요. 예를 들어 기본 경로 protected와 공개 접두사 https://media.example.com/protected는 객체 movie/manifest.mpd을 키 protected/movie/manifest.mpd에 매핑합니다. 직접 Azure URL에서는 공개 접두사에 컨테이너도 포함하세요. Save and verify를 선택하세요. Packager가 이 연결에 게시해야 한다면 기본 연결로 설정하세요.
기존에 저장한 스토리지 연결은 계속 사용할 수 있습니다. 공급자 식별 정보, 자격 증명, 기본 선택 및 게시된 URL이 유지됩니다. 편집, 검증 및 업로드에도 계속 사용할 수 있습니다.
6. Verify with your account#
- Console에서 목록 조회를 확인한 다음 작은 암호화 샘플을 업로드하세요. 바이트 크기와 공개 Preview URL을 검증하세요.
- 공개 GET 및 HEAD를 테스트한 다음
Range: bytes=0-15을 테스트하세요. 예상 바이트, HTTP 206 및 Content-Range를 확인하세요. - 폴더, 공백 및 비ASCII 문자가 있는 파일명, 이름 변경, 자격 증명 교체 및 폐기 가능한 테스트 객체 삭제를 테스트하세요. 권한이 없는 요청이 비밀 값을 노출하지 않고 실패하는지 확인하세요.
- Desktop Packager 또는 CLI로 완전한 암호화 패키지를 게시하세요. Published 상태를 확인한 다음 대상 브라우저/기기에서 Content ID로 재생하고 탐색 기능을 테스트하세요.
- 공급자, 리전, 결과 및 타임스탬프를 검증 증거로 보관하세요. 계정 비밀 값이나 서명된 업로드 URL은 기록하지 마세요.
브라우저의 단일 요청 업로드는 5 GiB, Azure는 5,000 MiB로 제한됩니다. 대용량 영상에는 분할된 Packager 출력을 사용하세요. 보존, 일시 삭제, 스냅샷 및 버전 관리로 인해 공급자 측 데이터가 남거나 삭제가 차단될 수 있습니다. 현재 객체를 삭제했다고 해서 보존된 모든 버전이 지워졌다는 뜻은 아닙니다.
7. Troubleshooting#
목록 조회는 되지만 업로드가 실패하면 PUT CORS, 모든 서명 요청 헤더, 쓰기 권한 및 시간/만료를 확인하세요. 업로드는 되지만 공개 URL이 실패하면 버킷/컨테이너, 기본 경로, CDN 오리진 매핑 및 파일명의 대소문자를 비교하세요. URL에 직접 접근할 수 있지만 재생 시 Failed to fetch가 표시되면 GET/HEAD CORS와 CDN 캐시를 확인하세요. Alibaba가 S3 인증을 거부하면 Alibaba Cloud 지원팀에 호환 모드를 확인하세요.
DRM-X 6.0