커스텀 스토리지
이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.
Capgo은 앱 번들을 위한 커스텀 스토리지 솔루션을 지원하여, 업데이트를 자체 인프라나 제3자 스토리지 서비스에 호스팅할 수 있습니다. 이는 특정 보안 요구사항, 컴플라이언스 필요성, 또는 기존 스토리지 인프라가 있는 조직에 특히 유용합니다.
개요
“개요” 섹션Capgo의 커스텀 스토리지는 번들을 외부 위치에 업로드하고, 해당 URL을 Capgo에 제공하여 작동합니다. 그러면 Capgo SDK가 Capgo의 기본 클라우드 스토리지 대신 커스텀 스토리지 위치에서 업데이트를 직접 다운로드합니다.
외부 URL 업로드
“외부 URL 업로드” 섹션커스텀 스토리지를 사용하는 가장 간단한 방법은 번들을 공개적으로 접근 가능한 URL에 업로드하고 해당 URL을 Capgo에 제공하는 것입니다.
기본 외부 URL 업로드
“기본 외부 URL 업로드” 섹션npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip이 명령은 Capgo이 번들을 Capgo의 클라우드 스토리지에 업로드하는 대신 지정된 URL의 번들을 참조하도록 지시합니다.
암호화 적용
“암호화 사용” 섹션외부 스토리지를 안전하게 사용하려면 번들을 암호화하고 복호화 키를 제공할 수 있습니다:
npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip --iv-session-key YOUR_IV_SESSION_KEYS3 연동
“S3 연동” 섹션Capgo는 Amazon S3 및 S3 호환 스토리지 서비스를 기본으로 지원합니다. CLI은 번들을 S3에 자동으로 업로드하고 Capgo가 S3 URL을 사용하도록 설정할 수 있습니다.
S3 업로드 옵션
“S3 업로드 옵션” 섹션npx @capgo/cli@latest bundle upload \ --s3-region us-east-1 \ --s3-apikey YOUR_ACCESS_KEY \ --s3-apisecret YOUR_SECRET_KEY \ --s3-bucket-name your-bucket-nameS3 설정 완료
“S3 전체 구성” 섹션S3 호환 서비스 또는 커스텀 엔드포인트의 경우:
npx @capgo/cli@latest bundle upload \ --s3-region us-east-1 \ --s3-apikey YOUR_ACCESS_KEY \ --s3-apisecret YOUR_SECRET_KEY \ --s3-endpoint https://s3.your-provider.com \ --s3-bucket-name your-bucket-name \ --s3-port 443 \ --no-s3-ssl # Only if your endpoint doesn't support SSLS3 설정 파라미터
“S3 구성 매개변수” 섹션| 파라미터 | 설명 | 필수 |
|---|---|---|
--s3-region | S3 버킷에 사용할 AWS 리전 | 지원 |
--s3-apikey | S3 액세스 키 ID | 지원 |
--s3-apisecret | S3 시크릿 액세스 키 | 지원 |
--s3-bucket-name | S3 버킷 이름 | 지원 |
--s3-endpoint | S3 커스텀 엔드포인트 URL | 아니요 |
--s3-port | S3 엔드포인트 포트 | 아니요 |
--no-s3-ssl | S3 업로드 시 SSL 비활성화 | 아니요 |
Bundle 준비 및 암호화
“Bundle 준비 및 암호화” 섹션커스텀 스토리지, 특히 암호화를 사용할 때는 번들을 올바르게 준비해야 합니다. 이는 zip 파일 생성 및 선택적 암호화를 포함합니다.
1단계: Zip Bundle 생성
“1단계: Zip 번들 생성” 섹션먼저 앱 번들의 zip 파일을 생성합니다:
npx @capgo/cli@latest bundle zip com.example.app --path ./distzip 명령은 zip 파일의 체크섬을 반환합니다. 필요 시 이 체크섬을 사용하여 zip 파일을 암호화할 수 있습니다. 사용하세요 --json 옵션을 사용하여 체크섬을 포함한 구조화된 출력을 가져옵니다.
Zip 명령 옵션
“Zip 명령 옵션” 섹션npx @capgo/cli@latest bundle zip [appId] \ --path ./dist \ --bundle 1.2.3 \ --name myapp-v1.2.3 \ --json \ --no-code-check \ --key-v2 \ --package-json ../../package.json,./package.json| 옵션 | 설명 |
|---|---|
--path | 압축할 폴더 경로 (기본값: capacitor.config의 webDir) |
--bundle | zip 파일 이름에 사용할 Bundle 버전 번호입니다. |
--name | zip 파일의 사용자 지정 이름 |
--json | 결과를 JSON 형식으로 출력 (체크섬 포함) |
--no-code-check | notifyAppReady() 호출 및 index 파일 확인 건너뛰기 |
--key-v2 | v2 암호화 사용 |
--package-json | 모노레포용 package.json 파일 경로 (쉼표로 구분) |
2단계: Bundle 암호화 (선택 사항)
“Step 2: Encrypt the Bundle (Optional)” 섹션보안을 강화하려면 업로드 전에 zip 번들을 암호화하세요:
# Using default local keynpx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM
# Using custom key filenpx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key ./path/to/.capgo_key_v2
# Using key data directlynpx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key-data "PRIVATE_KEY_CONTENT"이 CHECKSUM 파라미터는 필수이며, zip 파일의 체크섬이어야 합니다. zip 명령어 출력에서 체크섬을 확인할 수 있습니다(사용 --json 옵션을 사용하여 구조화된 출력을 얻으세요).
기본적으로 encrypt 명령어는 로컬 개인 서명 키를 사용합니다. 사용 --key 또는 --key-data options.
encrypt 명령은 업로드 또는 복호화에 필요한 ivSessionKey 값을 반환합니다.
암호화 명령 옵션
“암호화 명령 옵션” 섹션| 옵션 | 설명 |
|---|---|
zipPath | 암호화할 zip 파일 경로 (필수) |
checksum | zip 파일의 체크섬 (필수) - zip 명령어에서 확인 |
--key | 개인 서명 키의 사용자 지정 경로 (선택 사항, 기본적으로 로컬 키 사용) |
--key-data | 개인 서명 키 데이터 직접 입력 (선택 사항) |
--json | 결과를 JSON 형식으로 출력 |
전체 워크플로우 예시
“전체 워크플로 예제” 섹션예제 1: 암호화를 사용한 외부 URL
“예제 1: 암호화를 사용한 외부 URL” 섹션-
앱 빌드:
터미널 창 npm run build -
zip bundle 생성:
터미널 창 npx @capgo/cli@latest bundle zip com.example.app --path ./dist --bundle 1.2.3이 명령이 반환하는 체크섬을 기록하세요.
-
번들 암호화:
터미널 창 npx @capgo/cli@latest bundle encrypt ./com.example.app-1.2.3.zip CHECKSUM_FROM_STEP_2출력에서
ivSessionKey를 확인하세요. -
스토리지에 업로드: 암호화된 zip 파일을 호스팅 서비스에 업로드하세요.
-
Capgo에 등록:
터미널 창 npx @capgo/cli@latest bundle upload \--external https://your-cdn.com/bundles/com.example.app-1.2.3.zip \--iv-session-key IV_SESSION_KEY_FROM_STEP_3
예제 2: S3 직접 업로드
“예제 2: S3 직접 업로드” 섹션 제목-
앱 빌드:
터미널 창 npm run build -
S3에 직접 업로드:
터미널 창 npx @capgo/cli@latest bundle upload \--s3-region us-west-2 \--s3-apikey YOUR_ACCESS_KEY \--s3-apisecret YOUR_SECRET_KEY \--s3-bucket-name your-app-bundles \--channel Production
예제 3: 암호화를 적용한 S3
“예제 3: 암호화를 사용하는 S3” 섹션 제목-
빌드하고 zip으로 압축:
터미널 창 npm run buildnpx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2 -
번들 암호화:
터미널 창 npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM -
암호화하여 S3에 업로드:
터미널 창 npx @capgo/cli@latest bundle upload \--s3-region us-west-2 \--s3-apikey YOUR_ACCESS_KEY \--s3-apisecret YOUR_SECRET_KEY \--s3-bucket-name your-app-bundles \--iv-session-key IV_SESSION_KEY_FROM_STEP_2 \--channel Production
보안 고려 사항
“보안 고려 사항” 섹션커스텀 스토리지 사용 시 다음 보안 모범 사례를 고려하세요:
접근 제어
“접근 제어” 섹션- 스토리지 URL이 앱 사용자에게는 접근 가능하되, 공개적으로 검색되지 않도록 설정하세요
- 가능한 경우 서명된 URL 또는 토큰 기반 인증을 사용하세요
- 웹 기반 앱에 대해 적절한 CORS 헤더를 구현하세요
암호화
“암호화” 섹션- 민감한 번들은 항상 Capgo 암호화 도구를 사용하여 암호화하세요
- 암호화 키를 안전하게 저장하고 정기적으로 교체하세요
- 모든 번들 URL에 HTTPS를 사용하세요 (모바일 및 Electron 앱에 필수)
모니터링
“모니터링” 섹션- 접근 로그를 모니터링하여 비정상적인 다운로드 패턴을 감지하세요
- Bundle 다운로드 실패 시 알림 설정
- 스토리지 권한을 정기적으로 감사
문제 해결
“문제 해결” 섹션일반적인 이슈
“자주 발생하는 문제” 섹션Bundle이 다운로드되지 않는 경우:
- URL이 공개적으로 접근 가능하고 HTTPS를 사용하는지 확인하세요 (모바일 및 Electron 앱에 필수)
- 웹 앱의 CORS 헤더 확인
- Bundle 형식이 올바른지 확인
암호화 오류:
- 다음을 확인하세요:
ivSessionKey암호화된 bundle과 일치하는지 확인 - bundle이 올바른 키로 암호화되었는지 확인
- 새 bundle에 encryption v2가 사용되었는지 확인
S3 업로드 실패:
- S3 자격 증명 및 권한 확인
- 버킷 정책 및 CORS 설정 확인
- 지정된 region이 올바른지 확인
디버그 명령어
“Debug Commands” 섹션bundle 상태 확인:
npx @capgo/cli@latest app debugBundle 무결성 확인:
npx @capgo/cli@latest bundle list다음 단계
“다음 단계” 섹션Custom Storage에서 계속하기
“Custom Storage에서 계속하기”라는 제목의 섹션사용 중이라면 커스텀 스토리지 보안 및 컴플라이언스 계획을 세우려면, 다음 항목과 연결하세요: 암호화 암호화 구현 상세 정보: 컴플라이언스 컴플라이언스 구현 상세 정보: Capgo 보안 스캐너 Capgo Security Scanner 제품 워크플로우: Capgo 보안 Capgo Security 제품 워크플로우 및 Capgo 신뢰 센터 Capgo Trust Center 제품 워크플로우: