Upload Credential

요청 양식에 업로드 자격 증명을 입력하세요. 파라미터 이름은 token입니다.

업로드 자격 증명을 생성하기 위한 세 가지 주요 데이터 소스는 다음과 같습니다.

• 업로드 정책 데이터 (putPolicy)
  업로드 정책 데이터는 리소스 업로드 시 제공되는 구성 정보 집합입니다. 이 정보를 통해 CDNetworks 클라우드 스토리지(오브젝트 스토리지)는 사용자 업로드 요구사항(업로드할 리소스, 업로드 대상 버킷, 업로드 결과를 콜백으로 받을지 리디렉션할지 여부, 피드백 데이터 설정 필요 유무, 인증 업로드 만료 시각 등)을 인지할 수 있습니다.

• 시크릿 키 (SecretKey)
  SK는 클라우드 스토리지 플랫폼 키 관리자에게서 받으시기 바랍니다.

• 액세스 키 (AccessKey)
  AK도 클라우드 스토리지 플랫폼 키 관리자에게서 받으시기 바랍니다.

업로드 자격 증명uploadToken은 위 세 가지 데이터 소스를 기반으로 한 복잡한 서명 연산의 결과입니다. 업로드 자격 증명을 검증함으로써 불법적인 업로드 요청 및 침입을 차단할 수 있습니다.

업로드 정책 데이터

데이터 형식

{
  "scope": "<bucket string>",
  "deadline": "<deadline string>",
  "saveKey": "<saveKey string>",
  "returnUrl": "<returnUrl string>",
  "returnBody": "<returnBody string>",
  "overwrite": "<overwrite int>",
  "fsizeLimit": "<fsizeLimit long>",
  "callbackUrl": "<callbackUrl string>",
  "callbackBody": "<callbackBody string>",
  "persistentOps": "<persistentOps string>",
  "persistentNotifyUrl": "<persistentNotifyUrl string>",
  "contentDetect": "<contentDetctstring>",
  "detectNotifyURL": "<detectNotifyURL string>",
  "detectNotifyRule":"<detectNotifyRule>",
  "separate": "<separate int>"
}

형식 설명

참고:

1. persistenOps 필드 설정 시 persistentNotifyUrl 필드도 반드시 함께 설정하세요. 플랫폼은 persistentNotifyUrl로 명령 처리 결과를 알립니다. 자세한 내용은 Notification Data Content Description을 참고하세요.
2. 업로드 처리 메커니즘을 사용할 때 persistenOps 필드 등록 시, 명령 파라미터 saveas가 꼭 필요하며, 키는 원본 파일과 다를 수 있습니다. 그렇지 않으면 "The Persistent File Already Exists"라는 401 오류가 반환됩니다.
3. 파일명 지정 우선 순위는 Scope의 key > saveKey > form key > 원본 파일명 순입니다.

​​업로드 자격 증명 생성 알고리즘​

1. 업로드 정책 작성
업로드 파일 정보를 JSON 형식(putPolicy)으로 캡슐화합니다.

{
  "scope": "<bucket string>",
  "deadline": "<deadline string>",
  "returnBody": "<returnBody string>",
  "overwrite": "<overwrite int>",
  "fsizeLimit": "<fsizeLimit long>",
  "returnUrl": "<returnUrl string>"
}

2. URL-Safe Base64 코드로 업로드 정책 인코딩

putPolicy에 URL-Safe Base64 인코딩을 적용하여 encodePutPolicy를 얻습니다.

encodePutPolicy = urlsafe_base64_encode(putPolicy)

3. HMAC-SHA1 서명 생성
SecretKey를 사용해 encodePutPolicy에 대해 HMAC-SHA1 서명을 생성하여 Sign을 얻습니다.

Sign = hmac_sha1(encodePutPolicy, "<SecretKey>")

4. 서명 데이터 URL-Safe Base64 인코딩
서명 데이터 Sign에 URL-Safe Base64 인코딩을 적용해 encodeSign을 얻습니다.

encodeSign = urlsafe_base64_encode(Sign)

5. 업로드 자격 증명 생성
AccessKey, encodedSign, encodePutPolicy를 콜론(:)으로 연결하여 업로드 자격 증명 uploadToken을 생성합니다.

uploadToken = AccessKey:encodedSign:encodePutPolicy