adjust-icon

보안 저장소 엔드포인트

/vault 엔드포인트를 사용하여 클라우드 스토리지 인증 정보 또는 Play Store 키와 같은 계정 인증 정보를 저장합니다. App Automation은 템플릿 앱에서 다른 앱으로 설정을 마이그레이션 할 때 이러한 인증 정보를 사용하므로 요청 때마다 인증 정보를 전송할 필요가 없습니다.

저장하는 데이터는 암호화됩니다. API는 절대 이를 일반 텍스트로 반환하지 않습니다.

작동 방식

  • 보안 저장소 기록은 계정에 속합니다. 계정 내 모든 앱이 이를 사용할 수 있으며, 다른 계정은 이를 읽을 수 없습니다.
  • 기록은 section 및 store로 식별됩니다. 기존의 section 및 store 조합에 대한 데이터를 저장하면 해당 기록의 데이터가 교체됩니다.
  • API는 각 기록의 data를 암호화된 형식으로만 반환합니다. 나중에 확인해야 하는 경우에 대비하여 인증 정보의 사본을 보관하시기 바랍니다.

보안 저장소를 사용하는 섹션

다음의 앱 섹션은 마이그레이션 중에 보안 저장소의 인증 정보를 읽습니다.

섹션store저장 대상 data사용 시기
csv_upload_settings생략클라우드 스토리지의 인증 정보가 포함된 JSON string. CSV 업로드 인증 정보를 참조하시기 바랍니다.타겟 앱에 아직 클라우드 스토리지 인증 정보가 없습니다. 이 섹션에 대한 기록을 정확히 1개 저장합니다.
purchase_verificationgooglePlay Store 키(string).타겟 앱이 Android 앱입니다.

app_info 및 signature 섹션에 대한 데이터는 저장할 수 없습니다.

CSV 업로드 인증 정보

csv_upload_settings의 경우 data는 JSON string입니다. 내용은 스토리지 유형에 따라 달라집니다.

Amazon S3

파라미터데이터 유형필수설명
typeString예반드시 S3
bucketString예버킷 이름
keyString예액세스 키 ID
secretString예시크릿 액세스 키
regionString아니요버킷의 AWS 리전

Google Cloud Storage

파라미터데이터 유형필수설명
typeString예반드시 GCS
bucketString예버킷 이름
secretObject예서비스 계정 키(JSON 객체)

보안 저장소 기록 생성 또는 업데이트

섹션에 대한 인증 정보를 저장합니다. 동일한 section 및 store에 대한 기록이 있는 경우, 해당 데이터는 교체됩니다.

API 프로토콜

엔드포인트: https://automate.adjust.com/app-automation/vault

메서드: POST

요청 본문: 보안 저장소 생성 요청

응답: 보안 저장소 기록

예시

CSV 업로드를 위해 Amazon S3 인증 정보 저장

요청 - cURL
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
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
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는 지원되지 않습니다.
storeString인증 정보를 위한 스토어로, google, itunes 중 하나입니다. 인증 정보가 스토어별로 고유하지 않은 경우 생략합니다.
data*String저장할 인증 정보입니다. API는 해당 값을 저장하기 전에 암호화합니다.

보안 저장소 기록

파라미터데이터 유형설명
id*Integer기록 ID입니다.
account_id*Integer해당 기록이 속한 계정의 ID입니다.
section*String해당 인증 정보에 관한 앱 섹션입니다.
storeString인증 정보를 위한 스토어로, google 또는 itunes입니다. 설정되지 않은 경우 null입니다.
data*String암호화된 형식으로 저장된 인증 정보입니다. API는 절대 일반 텍스트로 반환하지 않습니다.
created_at*String기록이 생성된 ISO 날짜/시간입니다.