Method: appsigning.rotateAppSigningKey

앱의 서명 키를 새로운 자체 호스팅 Google Cloud KMS 키로 순환합니다.

경고: 이 메서드는 자체 호스팅 Cloud KMS 키로 등록된 앱에만 적용됩니다. 표준 Google 관리 Play 앱 서명을 사용하는 앱의 경우 Google Play Console UI를 통해 키 순환 요청을 시작해야 합니다.

고객센터: https://support.google.com/googleplay/android-developer/answer/9842756을 참고하세요.

HTTP 요청

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{name}/appSigning:rotateAppSigningKey

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 서명 키를 순환하는 앱의 패키지 이름 또는 앱 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "rotatedCloudKmsKey": {
    object (RotatedCloudKmsKey)
  },
  "keyRotationReason": enum (KeyRotationReason)
}
필드
rotatedCloudKmsKey

object (RotatedCloudKmsKey)

필수 항목입니다. 자체 호스팅 Cloud KMS 키입니다.
keyRotationReason

enum (KeyRotationReason)

필수 항목입니다. 앱 키를 순환하는 이유입니다.

응답 본문

앱의 서명 키를 순환하기 위한 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "rotatedKeyCertificate": {
    object (CertificateHashes)
  }
}
필드
rotatedKeyCertificate

object (CertificateHashes)

앱의 순환된 키 인증서 해시입니다. 항상 설정됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/androidpublisher

KeyRotationReason

키 순환 이유입니다.

열거형
KEY_ROTATION_REASON_UNSPECIFIED 지정되지 않은 키 순환 이유입니다. 사용할 수 없습니다.
COMPROMISED_KEY 키가 손상되었습니다.
USE_STRONGER_KEY 더 강력한 키가 필요합니다.
USE_SAME_KEY_FOR_MULTIPLE_APPS 여러 앱에 동일한 키가 사용됩니다.
ROUTINE_KEY_UPGRADE 정기 키 업그레이드입니다.
OTHER 기타 원인입니다.

RotatedCloudKmsKey

순환된 Cloud KMS 키를 나타내는 메시지입니다. Cloud KMS 키와 연결된 키 순환 증빙 자료로 구성됩니다.

JSON 표현 
{
  "cloudKmsKeyAndCert": {
    object (CloudKmsKeyAndCert)
  },
  "signingCertificateLineage": string
}
필드
cloudKmsKeyAndCert

object (CloudKmsKeyAndCert)

필수 항목입니다. Cloud KMS 키 및 해당 키와 연결된 인증서입니다.
signingCertificateLineage

string (bytes format)

필수 항목입니다. 키 순환 증빙 자료입니다. Creating signing certificate lineages(서명 인증서 계보 만들기)를 참고하세요.

base64 인코딩 문자열입니다.