__CAPGO_KEEP_0__

이 플러그인에 대한 설치 단계와 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하십시오.

Capgo은 앱 번들을위한 사용자 정의 저장 솔루션을 지원하여 업데이트를 호스팅하는 데 사용할 수있는 자체 인프라 또는 제 3 자 저장소 서비스를 허용합니다. 이 기능은 특정 보안 요구 사항, 규정 준수 요구 사항 또는 기존 저장소 인프라가있는 조직에 특히 유용합니다.

개요

Capgo의 사용자 정의 저장소에서 작동하는 Capgo은 업로드 된 번들을 외부 위치로 업로드하고 Capgo에 업데이트할 수 있는 URL을 제공합니다. Capgo SDK는 Capgo의 기본 클라우드 저장소 대신 사용자 정의 저장소 위치에서 업데이트를 다운로드합니다.

외부 URL 업로드

Capgo에 저장소를 업로드하는 가장 단순한 방법은 Capgo에 공개적으로 접근할 수 있는 URL을 업로드하고 그 URL을 Capgo에 제공하는 것입니다.

기본 외부 URL 업로드

npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip

이 명령은 Capgo이 지정된 URL에 있는 번들을 참조하도록 Capgo의 클라우드 스토리지에 업로드하는 대신에 instruct합니다.

암호화

암호화된 외부 저장소에 대한 보안을 위해, __CAPGO_KEEP_0__의 번들을 암호화하고 복호화 키를 제공할 수 있습니다.

npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip --iv-session-key YOUR_IV_SESSION_KEY

S3 통합

Capgo은 Amazon S3 및 S3 호환 저장소 서비스에 대한 built-in 지원을 제공합니다. CLI은 자동으로 번들을 S3로 업로드하고 Capgo을 S3 URL을 사용하도록 구성할 수 있습니다.

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-name

__CAPGO_KEEP_1__

__CAPGO_KEEP_3__

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 SSL

__CAPGO_KEEP_6__

__CAPGO_KEEP_8__	__CAPGO_KEEP_9__	__CAPGO_KEEP_10__
`--s3-region`	__CAPGO_KEEP_11__	네
`--s3-apikey`	__CAPGO_KEEP_0__	네
`--s3-apisecret`	__CAPGO_KEEP_0__	네
`--s3-bucket-name`	__CAPGO_KEEP_0__	네
`--s3-endpoint`	__CAPGO_KEEP_0__	아니오
`--s3-port`	__CAPGO_KEEP_0__	아니오
`--no-s3-ssl`	__CAPGO_KEEP_0__	아니요

압축물 준비 및 암호화

사용자 지정 저장소 사용할 때 특히 암호화 사용할 때, 압축물 준비가 필요합니다. 이에는 zip 파일을 생성하고 선택적으로 암호화하는 것이 포함됩니다.

1단계: zip 압축물 생성

먼저 앱 압축물을 zip 파일로 생성하세요:

npx @capgo/cli@latest bundle zip com.example.app --path ./dist

zip 명령어는 zip 파일의 체크섬을 반환합니다. 체크섬을 사용하여 zip 파일을 암호화할 수 있습니다. 필요시 --json option을 사용하여 체크섬을 포함한 구조화된 출력을 얻을 수 있습니다.

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 파일 이름으로 사용할 버전 번호
`--name`	zip 파일 이름을 사용자 지정
`--json`	JSON 형식으로 결과를 출력 (체크섬 포함)
`--no-code-check`	notifyAppReady() 호출 및 인덱스 파일을 확인하지 않음
`--key-v2`	암호화 v2 사용
`--package-json`	모노레포의 package.json 파일 경로 (쉼표로 구분)

Step 2: 압축 파일을 암호화 하세요 (선택)

보안을 강화하기 위해 업로드하기 전에 압축 파일을 암호화 하세요:

# Using default local key
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

# Using custom key file
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key ./path/to/.capgo_key_v2

# Using key data directly
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key-data "PRIVATE_KEY_CONTENT"

The CHECKSUM 이 매개 변수는 필수이며, zip 파일의 체크섬이어야 합니다. 체크섬은 zip 명령어의 출력에서 얻을 수 있습니다 (구조화된 출력을 위한 옵션을 사용하세요). --json 기본적으로 암호화 명령어는 로컬 개인 서명 키를 사용합니다. 사용자 지정 키를 지정하려면 옵션을 사용하세요.

암호화 명령어는 암호화 된 결과를 반환합니다. --key Copy to clipboard --key-data The

parameter is required and should be the checksum of your zip file. You can get the checksum from the zip command output (use ivSessionKey 업로드 또는 복호화를 위해 필요합니다.

암호화 명령 옵션

옵션	설명
`zipPath`	암호화할 zip 파일의 경로 (필수)
`checksum`	zip 명령으로 얻은 zip 파일의 체크섬 (필수)
`--key`	사용자 지정 개인 서명 키의 경로 (선택, 기본값은 로컬 키)
`--key-data`	직접 개인 서명 키 데이터 (선택)
`--json`	출력 결과를 JSON 형식으로 반환

__CAPGO_KEEP_0__ 워크플로 예제

__CAPGO_KEEP_1__: 외부 URL에 암호화

앱을 빌드하세요.
터미널 창
```
npm run build
```
zip 압축 파일을 생성하세요.
터미널 창
```
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 업로드

앱을 빌드하세요:
터미널 창
```
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 암호화

빌드 및 zip:

npm run build
npx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2

__CAPGO_KEEP_1__

npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM

__CAPGO_KEEP_3__

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

__CAPGO_KEEP_4__

__CAPGO_KEEP_6__

__CAPGO_KEEP_7__

__CAPGO_KEEP_0__
사용자들이 앱에 접근할 수 있도록 저장 URL을 제공하지만 공개적으로 발견되지 않도록 하세요.
가능한 경우 서명된 URL 또는 토큰 기반 인증을 사용하세요.

웹 기반 앱에 대한 적절한 CORS 헤더를 implement하세요.

Always encrypt sensitive bundles using the Capgo encryption tools
항상 sensitive bundle을 __CAPGO_KEEP_0__ 암호화 도구를 사용하여 암호화하세요.
암호화 키를 안전하게 저장하고 정기적으로 rotate하세요.

모바일 및 Electron 앱의 경우 모든 bundle URL에 HTTPS를 사용하세요.

모니터링
이상한 다운로드 패턴을 감지하기 위해 액세스 로그를 모니터링하세요.
정기적으로 저장 권한을 감사하세요

문제 해결

일반적인 문제

Bundle 다운로드 오류:

URL이 공개적으로 접근 가능하고 HTTPS를 사용하는지 확인하세요 (모바일 및 Electron 앱의 경우 필수입니다).
웹 앱의 CORS 헤더를 확인하세요.
Bundle 형식이 올바른지 확인하세요.

암호화 오류:

암호화된 Bundle과 일치하는지 확인하세요. ivSessionKey __CAPGO_KEEP_0__
해시된 파일이 올바른 키로 암호화되었는지 확인하세요.
새로운 파일에 대해 암호화 v2를 사용하도록 확인하세요.

S3 업로드 실패:

S3 인증 정보와 권한을 확인하세요.
버킷 정책과 CORS 구성 확인하세요.
지정된 지역이 올바른지 확인하세요.

디버그 명령어

해시된 파일 상태를 확인하세요.

npx @capgo/cli@latest app debug

해시된 파일의完整성을 확인하세요.

npx @capgo/cli@latest bundle list

다음 단계

알아보기 채널 다양한 배포 환경을 관리하는 데 사용
탐색 업데이트 동작 업데이트가 적용되는 방법을 커스터마이즈하는 데 사용
설정 CI/CD 통합 __CAPGO_KEEP_0__ 보관 저장 자동화 workflow를 자동화하세요.

Keep going from Custom Storage

Section titled “Custom Storage에서 계속하세요.” __CAPGO_KEEP_0__를 사용 중이라면 Custom Storage 보관 저장 저장소와 __CAPGO_KEEP_1__를 연결하세요. Encryption __CAPGO_KEEP_2__ 보안 구현 세부 정보 Compliance Capgo Security Scanner Capgo 보안 스캐너 Capgo 보안 Capgo 보안을 위한 제품 워크플로우에서 Capgo 신뢰 센터 Capgo 신뢰 센터를 위한 제품 워크플로우에서.