path-style 도메인 관련 문제
1. COS 버킷은 path-style 도메인을 지원하나요?
전체 서비스의 보안성과 안정성을 보장하기 위해, 2024년 1월 1일 이후 생성된 버킷은 path-style 도메인 사용을 지원하지 않습니다. 2024년 1월 1일 이전에 생성된 버킷은 영향을 받지 않으며 path-style 도메인을 계속 사용할 수 있으나, virtual-hosted-style 도메인을 우선적으로 사용하는 것을 권장합니다. 자세한 내용은 COS 버킷 도메인 사용 보안 관리 안내를 참고하시기 바랍니다. 2. path-style 도메인 사용 여부를 어떻게 확인하나요?
방법 1: 객체 URL 또는 액세스 도메인을 통해 확인합니다.
path-style 도메인 형식: cos.<Region>.myqcloud.com/<BucketName-APPID>.
virtual-hosted-style 도메인 형식: <BucketName-APPID>.cos.<Region>.myqcloud.com.
방법 2: 로그를 통해 확인합니다. path-style 요청의 로그 기록은 다음 조건을 만족합니다.
eventSource 필드: 액세스 도메인 형식은 cos.<Region>.myqcloud.com과 같습니다. 예: cos.ap-guangzhou.myqcloud.com.
eventName 필드: 이벤트 이름이 GetService가 아닙니다.
3. SDK를 사용하여 path-style 도메인에서 virtual-hosted-style 도메인으로 전환하려면 어떻게 하나요?
COS 미니프로그램, JavaScript, Node.js, Android, iOS SDK는 path-style 도메인 사용을 지원합니다. 미니프로그램 SDK를 예로 들어 전환 작업 단계는 다음과 같습니다.
단계 1: SDK 인스턴스화 시 ForcePathStyle:true를 ForcePathStyle:false로 수정하거나 해당 매개변수를 제거합니다. 예:
new COS({ ForcePathStyle: false })
new COS({})
단계 2: 미니프로그램 SDK의 경우, WeChat 오픈 플랫폼에서 버킷 도메인 <BucketName-Appid>.cos.<Region>.myqcloud.com을 화이트리스트 도메인으로 설정해야 합니다.
4. 2024년 1월 1일 이후에 새로 생성된 버킷이 path-style 도메인을 사용하여 접근할 경우 어떤 오류가 발생하나요?
오류 요청의 예시는 다음과 같습니다.
GET /bucket-125000000/test.txt HTTP/1.1
Host: cos.ap-guangzhou.myqcloud.com
HTTP/1.1 403 Forbidden
<?xml version="1.0" encoding="UTF-8"?>
<Error>
<Code>PathStyleDomainForbidden</Code>
<Message>The bucket you are attempting to access must be addressed using COS virtual-styled domain.</Message>
</Error>
기본 도메인 미리보기, 다운로드 기능 관련 문제
1. COS 버킷 기본 도메인은 브라우저에서 객체 미리보기 및 apk/ipa 유형 파일의 다운로드를 지원하나요?
전체 서비스의 보안성과 안정성을 보장하기 위해, 2024년 1월 1일 이후 생성된 버킷의 경우 COS 기본 도메인(버킷 기본 도메인, 정적 웹사이트 도메인, 글로벌 가속 도메인 포함)을 사용하여 객체에 액세스하는 경우, 모든 유형의 파일은 미리보기를 지원하지 않으며 apk/ipa 유형 파일의 다운로드도 지원되지 않습니다. 자세한 내용은 COS 버킷 도메인 사용 보안 관리 안내를 참고하시기 바랍니다. 2024년 1월 1일 이후 생성된 버킷의 경우, 사용자가 기본 도메인을 사용하여 객체에 액세스하면 COS는 응답 헤더에 다음 두 개의 Header를 추가합니다. 따라서 기본 도메인을 사용할 때는 브라우저에서 직접 파일을 미리 볼 수 없습니다.
x-cos-force-download:true
Content-Disposition: attachment
2024년 1월 1일 이후 생성된 버킷의 경우, 사용자가 기본 도메인을 사용하여 apk/ipa 유형 파일(파일 확장자가 .apk 또는 .ipa임)에 접근하면 다운로드 요청이 오류를 반환합니다. 오류 정보 예시는 다음과 같습니다.
HTTP/1.1 403 Forbidden
<?xml version="1.0" encoding="UTF-8"?>
<Error>
<Code>DownloadForbidden</Code>
<Message>The APK/IPA file is not allowed to be distributed in a public network using COS default domain, please use custom domain instead.</Message>
</Error>
2. 2024년 1월 1일 이전에 생성된 버킷의 경우 기본 도메인을 사용할 때 브라우저 미리보기 및 apk/ipa 다운로드를 지원하나요?
2024년 1월 1일 이전에 생성된 버킷의 기본 도메인은 영향을 받지 않지만 우선적으로 사용자 정의 도메인을 사용하는 것을 권장합니다.
3. 영향을 받는 기본 도메인은 무엇인가요?
영향을 받는 도메인에는 COS 서비스가 직접 제공하는 버킷 도메인, 정적 웹사이트 도메인, 글로벌 가속 도메인이 있습니다.
|
버킷 도메인 | <Bucket-Appid>.cos.<Region>.myqcloud.com |
정적 웹사이트 도메인 | <Bucket-Appid>.cos-website.<Region>.myqcloud.com |
글로벌 가속 도메인 | <Bucket-Appid>.cos.accelerate.myqcloud.com |
4. CDN 도메인은 브라우저 미리보기를 지원하나요? apk/ipa 유형 파일의 다운로드를 지원하나요?
Tencent Cloud CDN
Tencent Cloud CDN을 사용하고 원본 서버가 COS 버킷으로 구성된 경우, CDN 도메인의 미리보기 및 다운로드는 영향을 받지 않으며 CDN 도메인을 통해 apk/ipa 유형 파일을 정상적으로 다운로드할 수 있습니다.
제3자 CDN
제3자 CDN 서비스가 COS 버킷으로 origin-pull을 하는 경우, 원본 서버 구성이 COS 기본 도메인인 경우 영향을 받게 됩니다.
5. 사설망에서 기본 도메인을 접근할 때는 브라우저 미리보기가 지원되나요? apk/ipa 유형 파일의 다운로드는 지원되나요?
사설망 접근은 영향을 받지 않습니다.
6. 사용자 정의 도메인은 브라우저 미리보기를 지원하나요? apk/ipa 유형 파일 다운로드를 지원하나요?
지원합니다.
7. 2024년 1월 1일 이후 생성된 버킷에서 브라우저로 파일을 정상적으로 미리 보는 방법은 무엇인가요?
2024년 1월 1일 이후 생성된 버킷의 경우, 사용자가 파일을 정상적으로 미리 보려면 버킷에 사용자 정의 도메인을 구성해야 합니다. 사용자 정의 도메인 구성은 사용자 정의 원본 서버 도메인 활성화하기를 참고하십시오. 또한 사용자는 해당 파일에 올바른 Content-Type 헤더를 지정해야 하고, Content-Disposition의 매개변수 값은 attachment로 설정할 수 없습니다. 브라우저가 현재 파일 형식을 지원하는 경우, 브라우저는 파일을 직접 다운로드하지 않고 즉시 열게 됩니다.
8. 정적 웹사이트 사용은 영향을 받나요?
2024년 1월 1일 이후 생성된 버킷의 경우 기본 도메인(정적 웹사이트 도메인 포함)으로 한 미리보기는 제한됩니다. 따라서 정적 웹사이트의 인덱스 문서, 오류 문서 등의 기능들이 큰 영향을 받게 됩니다.
정적 웹사이트 기능을 정상적으로 사용하려면 버킷에 사용자 정의 도메인을 구성하고 원본 서버를 정적 웹사이트로 설정해야 합니다. 자세한 내용은 사용자 정의 원본 서버 도메인 활성화하기를 참고하십시오. 9. 2024년 1월 1일 이후 생성된 버킷에서 apk/ipa 파일을 정상적으로 다운로드하려면 어떻게 해야 하나요?
2024년 1월 1일 이후 생성된 버킷의 경우, 사용자가 파일을 정상적으로 미리 보려면 버킷에 사용자 정의 도메인을 구성해야 합니다. 사용자 정의 도메인 구성은 사용자 정의 원본 서버 도메인 활성화하기를 참고하십시오.