SDK 시크릿 엔드포인트

SDK 시크릿 엔드포인트를 사용하여 앱의 SDK 시크릿을 관리합니다. 오래된 시크릿을 취소하거나, 특정 시크릿을 취소하거나, 이전에 취소된 시크릿을 재활성화할 수 있습니다.

오래된 시크릿 취소

지정된 버전보다 오래된 SDK 시크릿을 모두 취소합니다. 이는 새로운 SDK Signature(SDK 서명) 버전으로 마이그레이션한 후에 오래된 시크릿을 정리할 때 유용합니다.

API 프로토콜

엔드포인트: https://automate.adjust.com/app-automation/app/{app_token}/secrets/revoke_outdated

호출하여 트래킹할 수 있습니다: POST

요청 본문: 오래된 요청 취소

응답: 오래된 응답 취소

파라미터

파라미터	데이터 유형	In	필수	설명
`app_token`	`String`	Path	O	Adjust 앱 토큰.
`min_active_version`	`Integer`	Body	아니요	활성 상태를 유지하기 위한 최소 버전. 이 버전보다 오래된 시크릿은 취소됩니다. 기본값은 `3`입니다.
`force`	`Boolean`	Body	아니요	`true`로 설정하면 활성 시크릿이 하나도 남지 않게 되더라도 시크릿을 취소합니다. 기본값은 `false`입니다.

행동

버전이 min_active_version 미만 인 시크릿은 취소됩니다.
취소 시 남은 활성 시크릿이 없는 경우, force: true로 설정된 경우를 제외하고 작업이 실패합니다.
기본 min_active_version 값인 3은 v1 및 v2 시크릿이 취소되고 v3 시크릿만 활성 상태로 유지됨을 의미합니다.

예시

v3 이전 버전의 모든 시크릿 취소

curl --location 'https://automate.adjust.com/app-automation/app/abc123xyz/secrets/revoke_outdated' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
    "min_active_version": 3
}'

{
   "combined_secrets": {
      "enforce_install_signing": true,
      "secrets": [
         {
            "id": 1001,
            "name": "Legacy Secret",
            "active": false,
            "value": ["secret1", "secret2", "info1", "info2"],
            "internal_version": 3,
            "version": 2,
            "created_at": "2023-01-15T10:30:00Z",
            "updated_at": "2024-06-15T14:00:00Z"
         },
         {
            "id": 2001,
            "platform": "android",
            "label": "Android SDK Secret",
            "active": true,
            "algorithm": "adj1",
            "internal_version": "3.47.0",
            "version": 3,
            "created_at": "2024-06-01T12:00:00Z",
            "updated_at": "2024-06-01T12:00:00Z"
         }
      ]
   },
   "revoked": 1
}

남는 활성 시크릿이 없는 경우에도 강제 취소

curl --location 'https://automate.adjust.com/app-automation/app/abc123xyz/secrets/revoke_outdated' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
    "min_active_version": 3,
    "force": true
}'

특정 시크릿 취소

해당 ID로 특정 SDK 시크릿을 취소합니다. 시크릿은 즉시 비활성화됩니다.

API 프로토콜

엔드포인트: https://automate.adjust.com/app-automation/app/{app_token}/secrets/{secret_id}/revoke

호출하여 트래킹할 수 있습니다: POST

응답: HTTP 202 Accepted(성공 시)

파라미터

파라미터	데이터 유형	In	필수	설명
`app_token`	`String`	Path	O	Adjust 앱 토큰.
`secret_id`	`Integer`	Path	O	취소할 시크릿의 ID.

예시

curl --location --request POST 'https://automate.adjust.com/app-automation/app/abc123xyz/secrets/1001/revoke' \
--header 'Authorization: Bearer {your-adjust-api-token}'

HTTP/1.1 202 Accepted

시크릿 재활성화

이전에 취소된 SDK 시크릿을 재활성화합니다. 그러면 시크릿이 다시 활성화됩니다.

API 프로토콜

엔드포인트: https://automate.adjust.com/app-automation/app/{app_token}/secrets/{secret_id}/reactivate

호출하여 트래킹할 수 있습니다: POST

응답: HTTP 202 Accepted(성공 시)

파라미터

파라미터	데이터 유형	In	필수	설명
`app_token`	`String`	Path	O	Adjust 앱 토큰.
`secret_id`	`Integer`	Path	O	재활성화할 시크릿의 ID.

예시

curl --location --request POST 'https://automate.adjust.com/app-automation/app/abc123xyz/secrets/1001/reactivate' \
--header 'Authorization: Bearer {your-adjust-api-token}'

HTTP/1.1 202 Accepted

모든 시크릿 보기

앱의 모든 SDK 시크릿을 확인하려면 앱 설정 엔드포인트를 combined_secrets 섹션과 함께 사용합니다.

curl --location 'https://automate.adjust.com/app-automation/app/abc123xyz/settings?sections=combined_secrets' \
--header 'Authorization: Bearer {your-adjust-api-token}'

{
   "combined_secrets": {
      "enforce_install_signing": true,
      "secrets": [
         {
            "id": 1001,
            "name": "Legacy Secret v2",
            "active": true,
            "value": ["secret1", "secret2", "info1", "info2"],
            "internal_version": 3,
            "version": 2,
            "created_at": "2023-01-15T10:30:00Z",
            "updated_at": "2023-01-15T10:30:00Z"
         },
         {
            "id": 2001,
            "platform": "android",
            "label": "Android SDK Secret",
            "active": true,
            "algorithm": "adj1",
            "internal_version": "3.47.0",
            "version": 3,
            "created_at": "2024-06-01T12:00:00Z",
            "updated_at": "2024-06-01T12:00:00Z"
         },
         {
            "id": 2002,
            "platform": "ios",
            "label": "iOS SDK Secret",
            "active": true,
            "algorithm": "adj1",
            "internal_version": "3.47.0",
            "version": 3,
            "created_at": "2024-06-01T12:00:00Z",
            "updated_at": "2024-06-01T12:00:00Z"
         }
      ]
   }
}

데이터 모델

오래된 요청 취소

파라미터	데이터 유형	설명
`min_active_version`	`Integer`	활성 상태를 유지하기 위한 최소 버전. 이보다 오래된 시크릿은 취소됩니다. 기본값은 `3`입니다.
`force`	`Boolean`	활성 시크릿이 하나도 남지 않게 되더라도 시크릿을 취소합니다. 기본값은 `false`입니다.

오래된 응답 취소

파라미터	데이터 유형	설명
`combined_secrets`*	`Object`	취소 후 업데이트된 시크릿 상태.
`revoked`*	`Integer`	취소된 시크릿 수.

결합된 시크릿

파라미터	데이터 유형	설명
`enforce_install_signing`*	`Boolean`	서명되지 않은 설치 거부 여부.
`secrets`*	`Array[Object]`	레거시 시크릿을 포함한 모든 SDK 시크릿 목록.

레거시 시크릿

파라미터	데이터 유형	설명
`id`*	`Integer`	시크릿 ID.
`name`	`String`	시크릿 이름/라벨.
`active`*	`Boolean`	시크릿의 활성화 여부.
`value`*	`Array[String]`	시크릿 값(4개 요소).
`internal_version`*	`Integer`	SDK Signature(SDK 서명) 라이브러리 버전.
`version`*	`Integer`	SDK 시크릿 버전(`1` 또는 `2`).
`created_at`*	`String`	시크릿이 생성된 ISO 날짜/시간.
`updated_at`*	`String`	시크릿이 마지막으로 업데이트된 ISO 날짜/시간.

SDK 시크릿

파라미터	데이터 유형	설명
`id`*	`Integer`	시크릿 ID.
`platform`*	`String`	타겟 플랫폼(`android` 또는 `ios`).
`label`*	`String`	시크릿에 대한 읽을 수 있는 라벨.
`active`*	`Boolean`	시크릿의 활성화 여부.
`algorithm`*	`String`	사용된 서명 알고리즘.
`internal_version`*	`String`	SDK Signature(SDK 서명) 라이브러리 버전.
`version`*	`Integer`	SDK 시크릿 버전(3 이상).
`created_at`*	`String`	시크릿이 생성된 ISO 날짜/시간.
`updated_at`*	`String`	시크릿이 마지막으로 업데이트된 ISO 날짜/시간.