tencent cloud

Video on Demand

릴리스 노트 및 공지 사항
릴리스 노트
제품 소개
제품 개요
Product Features
제품 기능
제품 장점
시나리오
솔루션
구매 가이드
과금 개요
과금 방식
구매 가이드
청구서 조회
연장 안내
연체 안내
환불 안내
시작하기
콘솔 가이드
콘솔 소개
서비스 개요
애플리케이션 관리
미디어 관리
리소스 패키지 관리
License Management
사례 튜토리얼
미디어 업로드
VOD 미디어 파일을 스마트 콜드 스토리지하는 방법
비디오 처리
배포 및 재생
이벤트 알림 수신 방법
원본 서버 마이그레이션 방법
라이브 방송 녹화
사용자 지정 Origin-pull을 수행하는 방법
라이브 방송 하이라이트 클리핑을 VOD에 통합하기 위한 가이드
EdgeOne을 사용하여 VOD 콘텐츠 배포하는 방법
개발 가이드
미디어 업로드
미디어 처리
비디오 AI
이벤트 알림
비디오 재생
미디어 파일 다운로드
서브 애플리케이션 시스템
오류 코드
플레이어 SDK 문서
Overview
Basic Concepts
Features
Free Demo
Free Trial License
Purchase Guide
SDK Download
Licenses
Player Guide
Integration (UI Included)
Integration (No UI)
Advanced Features
API Documentation
Player Adapter
Player SDK Policy
FAQs
모바일 재생
요금
비디오 업로드
비디오 배포
비디오 재생
Web 재생
전체 화면 재생
데이터 통계
액세스 관리
미디어 자산 콜드 스토리지
Agreements
Service Level Agreement
VOD 정책
개인 정보 보호 정책
데이터 처리 및 보안 계약
문의하기
용어집

클라이언트 업로드 서명

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2023-10-26 17:31:32
클라이언트 업로드 시작 전, App의 서명 배포 서버에 업로드 서명을 신청해야 합니다. 클라이언트 업로드 작업 실행 시, 이 서명이 있어야 VOD가 업로드 승인 여부를 확인할 수 있습니다.

서명 생성 단계

1. Tencent Cloud API 키 가져오기 SecretId, SecretKey와 같은 서버 API 호출에 필요한 보안 자격 증명을 가져옵니다. 자세한 방법은 다음과 같습니다.
1.1 콘솔에 로그인하고 [클라우드 서비스]>[CAM]>[API 키 관리]를 선택해 ‘API 키 관리’ 페이지로 이동합니다.
1.2 Tencent Cloud API 키를 받습니다. 아직 키를 생성하지 않은 경우, [키 생성]을 클릭하면 한 쌍의 SecretId와 SecretKey가 생성됩니다.
2. 일반 텍스트 문자열 스플라이스 original 아래와 같이 URL QueryString의 형식 요구 사항에 따라 일반 텍스트 서명 문자열 original을 연결합니다.
secretId=[secretId]&currentTimeStamp=[currentTimeStamp]&expireTime=[expireTime]&random=[random]
설명:
상기 original의 [secretId], [currentTimeStamp], [expireTime][random]은 실제 매개변수 값으로 대체되어야 합니다.
original은 4개의 필수 매개변수 secretId, currentTimeStamp, expireTimerandom을 포함해야 하고 여러 임의의 매개변수 옵션을 포함할 수 있습니다. 자세한 내용은 서명 매개변수를 참고하십시오.
매개변수 값은 UrlEncode되어야 하며 그렇지 않으면 QueryString 구문 분석이 실패할 수 있습니다.
3. 일반 텍스트 문자열을 서명으로 변환(예: Java 코드 사용).
3.1 SecretKey를 사용하여 HMAC-SHA1 알고리즘으로 original 일반 텍스트 문자열을 암호화하여 signatureTmp를 가져옵니다.
Mac mac = Mac.getInstance("HmacSHA1");
SecretKeySpec secretKey = new SecretKeySpec(this.secretKey.getBytes("UTF-8"), mac.getAlgorithm());
mac.init(secretKey);
byte[] signatureTmp = mac.doFinal(original.getBytes("UTF-8"));
주의:
signatureTmp는 UTF-8로 인코딩되고 HMAC-SHA1로 암호화된 바이트 배열입니다.
3.2 UTF-8을 사용하여 일반 텍스트 문자열 original을 바이트 배열로 인코딩하고, 배열을 signatureTmp와 병합한 다음 이 조합을 Base64로 인코딩하여 signature를 가져옵니다.
String signature = base64Encode(byteMerger(signatureTmp, original.getBytes("utf8")));
설명:
byteMerger와 base64Encode는 각각 배열 병합과 Base64 인코딩 방식으로, 자세한 내용은 Java의 서명 코드 예시를 참고하십시오.

서명 생성 예시

VOD는 또한 서명 생성을 위한 코드 예시와 참고 및 확인을 위한 서명 생성 툴을 제공합니다.

서명 매개변수에 대한 설명

매개변수 이름
필수 여부
유형
설명
secretId
Yes
String
Tencent Cloud API 키의 SecretId. 가져오는 방법은 클라이언트에서 업로드 가이드 - Tencent Cloud API 키 가져오기를 참고하십시오.
currentTimeStamp
Yes
Integer
현재의 Unix 타임스탬프.
expireTime
Yes
Integer
서명 만료에 대한 Unix 타임스탬프.
expireTime = currentTimeStamp + 서명 유효 기간
서명 유효 기간의 최대값은 7,776,000(즉, 90일)입니다.
random
Yes
Integer
일반 텍스트 서명 문자열을 구성하는 데 사용되는 매개변수(십진수). 최대값은 xxxxx(32비트 부호 없는 이진수의 최대값)입니다.
classId
No
Integer
비디오 파일 카테고리. 기본값: 0.
procedure
No
String
비디오에 대한 후속 작업 작업. 즉 비디오 파일이 업로드된 후 태스크 플로우 작업이 자동으로 시작됩니다. 이 매개변수 값은 태스크 플로우 템플릿 이름입니다. VOD는 태스크 플로우 템플릿 생성 및 템플릿 이름 지정을 지원합니다.
taskPriority
No
Integer
후속 비디오 작업의 우선 순위(procedure가 지정된 경우에만 유효). 값 범위: [-10, 10] 기본값: 0.
taskNotifyMode
No
String
태스크 플로우 상태 변경에 대한 알림 모드(procedure가 지정된 경우에만 유효).
Finish: 이벤트 알림은 태스크 플로우가 완전히 실행된 후에만 시작됩니다.
Change: 태스크 플로우의 서브 작업 상태가 변경되는 즉시 이벤트 알림이 시작됩니다.
None: 태스크 플로우에 대한 콜백은 허용되지 않습니다.
기본값: Finish.
sourceContext
No
String
사용자 요청 정보를 전달하는 데 사용되는 소스 컨텍스트입니다. 업로드 완료 콜백 API는 이 필드의 값을 반환합니다. 최대 250자를 포함할 수 있습니다.
oneTimeValid
No
Integer
서명의 일회성 여부. 자세한 내용은 클라이언트 업로드 가이드 - 일회성 서명을 참고하십시오.
0(기본값): 활성화되지 않음. 1: 활성화됨.
관련 오류 코드는 일회성 서명 설명을 참고하십시오.
vodSubAppId
No
Integer
서브 애플리케이션 ID, 이 매개변수가 공란, 0 또는 Tencent Cloud AppId면, 작업된 서브 애플리케이션이 ‘메인 애플리케이션’이 됩니다.
sessionContext
No
String
사용자 요청 정보를 전달하는 데 사용되는 세션 컨텍스트. 프로시저 매개변수가 지정되면 태스크 플로우 상태 변경 콜백 API가 이 필드의 값을 반환합니다. 최대 1,000자를 포함할 수 있습니다.
storageRegion
No
String
스토리지 리전 지정. 콘솔에서 직접 스토리지 리전을 추가할 수 있습니다. 자세한 내용은 스토리지 설정 업로드를 참고하십시오. 이 필드는 리전 영어 약칭을 입력해야 합니다.

일회성 서명 설명

일회성 서명 기능이 활성화된 후 서명 서버는 사용자에게 배포되는 서명이 매번 다른지 확인해야 합니다(예: 동시에 배포되는 서명의 random 매개변수가 고유해야 함). 그렇지 않으면 중복 서명 오류가 발생합니다.
서명 오류로 인해 업로드가 실패하면 재시도를 위해 새 서명을 받아야 합니다.
Android 및 Java용 SDK로 인한 서명 오류의 오류 코드는 1001입니다.

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백