/vault 엔드포인트를 사용하여 클라우드 스토리지 인증 정보 또는 Play Store 키와 같은 계정 인증 정보를 저장합니다. App Automation은 템플릿 앱에서 다른 앱으로 설정을 마이그레이션 할 때 이러한 인증 정보를 사용하므로 요청 때마다 인증 정보를 전송할 필요가 없습니다.
저장하는 데이터는 암호화됩니다. API는 절대 이를 일반 텍스트로 반환하지 않습니다.
작동 방식
- 보안 저장소 기록은 계정에 속합니다. 계정 내 모든 앱이 이를 사용할 수 있으며, 다른 계정은 이를 읽을 수 없습니다.
- 기록은
section및store로 식별됩니다. 기존의section및store조합에 대한 데이터를 저장하면 해당 기록의 데이터가 교체됩니다. - API는 각 기록의
data를 암호화된 형식으로만 반환합니다. 나중에 확인해야 하는 경우에 대비하여 인증 정보의 사본을 보관하시기 바랍니다.
보안 저장소를 사용하는 섹션
다음의 앱 섹션은 마이그레이션 중에 보안 저장소의 인증 정보를 읽습니다.
| 섹션 | store | 저장 대상 data | 사용 시기 |
|---|---|---|---|
csv_upload_settings | 생략 | 클라우드 스토리지의 인증 정보가 포함된 JSON string. CSV 업로드 인증 정보를 참조하시기 바랍니다. | 타겟 앱에 아직 클라우드 스토리지 인증 정보가 없습니다. 이 섹션에 대한 기록을 정확히 1개 저장합니다. |
purchase_verification | google | Play Store 키(string). | 타겟 앱이 Android 앱입니다. |
app_info 및 signature 섹션에 대한 데이터는 저장할 수 없습니다.
CSV 업로드 인증 정보
csv_upload_settings의 경우 data는 JSON string입니다. 내용은 스토리지 유형에 따라 달라집니다.
Amazon S3
| 파라미터 | 데이터 유형 | 필수 | 설명 |
|---|---|---|---|
type | String | 예 | 반드시 S3 |
bucket | String | 예 | 버킷 이름 |
key | String | 예 | 액세스 키 ID |
secret | String | 예 | 시크릿 액세스 키 |
region | String | 아니요 | 버킷의 AWS 리전 |
Google Cloud Storage
| 파라미터 | 데이터 유형 | 필수 | 설명 |
|---|---|---|---|
type | String | 예 | 반드시 GCS |
bucket | String | 예 | 버킷 이름 |
secret | Object | 예 | 서비스 계정 키(JSON 객체) |
보안 저장소 기록 생성 또는 업데이트
섹션에 대한 인증 정보를 저장합니다. 동일한 section 및 store에 대한 기록이 있는 경우, 해당 데이터는 교체됩니다.
API 프로토콜
엔드포인트: https://automate.adjust.com/app-automation/vault
메서드: POST
요청 본문: 보안 저장소 생성 요청
응답: 보안 저장소 기록
예시
CSV 업로드를 위해 Amazon S3 인증 정보 저장
curl --location 'https://automate.adjust.com/app-automation/vault' \--header 'Authorization: Bearer {your-adjust-api-token}' \--header 'Content-Type: application/json' \--data '{ "section": "csv_upload_settings", "data": "{\"type\": \"S3\", \"bucket\": \"my-export-bucket\", \"key\": \"{access-key-id}\", \"secret\": \"{secret-access-key}\", \"region\": \"eu-central-1\"}"}'{ "id": 1, "account_id": 12345, "section": "csv_upload_settings", "store": null, "data": "{encrypted-data}", "created_at": "2026-10-01T09:30:00"}결제 검증을 위해 Play Store 키 저장
curl --location 'https://automate.adjust.com/app-automation/vault' \--header 'Authorization: Bearer {your-adjust-api-token}' \--header 'Content-Type: application/json' \--data '{ "section": "purchase_verification", "store": "google", "data": "{play-store-key}"}'오류
| 상태 코드 | 설명 |
|---|---|
400 | 지원되지 않는 섹션입니다. app_info 또는 signature에 대한 데이터를 저장할 수 없습니다. |
422 | 요청 본문이 유효하지 않습니다. 예: section 또는 store에 알 수 없는 값이 있거나 data가 누락되었습니다. |
보안 저장소 기록 가져오기
계정의 모든 보안 저장소 기록을 조회합니다. 각 기록의 data는 암호화됩니다.
API 프로토콜
엔드포인트: https://automate.adjust.com/app-automation/vault
메서드: GET
응답: 보안 저장소 기록의 배열
예시
curl --location 'https://automate.adjust.com/app-automation/vault' \--header 'Authorization: Bearer {your-adjust-api-token}'[ { "id": 1, "account_id": 12345, "section": "csv_upload_settings", "store": null, "data": "{encrypted-data}", "created_at": "2026-10-01T09:30:00" }, { "id": 2, "account_id": 12345, "section": "purchase_verification", "store": "google", "data": "{encrypted-data}", "created_at": "2026-10-01T09:32:00" }]데이터 모델
보안 저장소 생성 요청
| 파라미터 | 데이터 유형 | 설명 |
|---|---|---|
section* | String | 해당 인증 정보에 관한 앱 섹션입니다. app_info 및 signature는 지원되지 않습니다. |
store | String | 인증 정보를 위한 스토어로, google, itunes 중 하나입니다. 인증 정보가 스토어별로 고유하지 않은 경우 생략합니다. |
data* | String | 저장할 인증 정보입니다. API는 해당 값을 저장하기 전에 암호화합니다. |
보안 저장소 기록
| 파라미터 | 데이터 유형 | 설명 |
|---|---|---|
id* | Integer | 기록 ID입니다. |
account_id* | Integer | 해당 기록이 속한 계정의 ID입니다. |
section* | String | 해당 인증 정보에 관한 앱 섹션입니다. |
store | String | 인증 정보를 위한 스토어로, google 또는 itunes입니다. 설정되지 않은 경우 null입니다. |
data* | String | 암호화된 형식으로 저장된 인증 정보입니다. API는 절대 일반 텍스트로 반환하지 않습니다. |
created_at* | String | 기록이 생성된 ISO 날짜/시간입니다. |