Method: appsigning.rotateAppSigningKey

Xoay vòng khoá ký của ứng dụng sang một khoá Google Cloud KMS tự lưu trữ mới.

Cảnh báo: Phương thức này chỉ áp dụng cho các ứng dụng đã đăng ký bằng khoá Cloud KMS tự lưu trữ. Đối với các ứng dụng sử dụng tính năng Ký ứng dụng của Play do Google quản lý theo tiêu chuẩn, bạn phải bắt đầu yêu cầu xoay vòng khoá thông qua giao diện người dùng Google Play Console.

Xem Trung tâm trợ giúp: https://support.google.com/googleplay/android-developer/answer/9842756

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
name

string

Bắt buộc. Tên gói hoặc mã nhận dạng ứng dụng của ứng dụng thay đổi khoá ký.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "rotatedCloudKmsKey": {
    object (RotatedCloudKmsKey)
  },
  "keyRotationReason": enum (KeyRotationReason)
}
Trường
rotatedCloudKmsKey

object (RotatedCloudKmsKey)

Bắt buộc. Khoá Cloud KMS tự lưu trữ.
keyRotationReason

enum (KeyRotationReason)

Bắt buộc. Lý do thay khoá ứng dụng.

Nội dung phản hồi

Phản hồi để xoay vòng khoá ký của ứng dụng.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "rotatedKeyCertificate": {
    object (CertificateHashes)
  }
}
Trường
rotatedKeyCertificate

object (CertificateHashes)

Các hàm băm chứng chỉ khoá đã xoay cho ứng dụng. Luôn đặt.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

KeyRotationReason

Lý do xoay vòng khoá.

Enum
KEY_ROTATION_REASON_UNSPECIFIED Lý do xoay vòng khoá không xác định. Không thể sử dụng.
COMPROMISED_KEY Khoá bị xâm phạm.
USE_STRONGER_KEY Bạn phải sử dụng khoá mạnh hơn.
USE_SAME_KEY_FOR_MULTIPLE_APPS Cùng một khoá được dùng cho nhiều ứng dụng.
ROUTINE_KEY_UPGRADE Nâng cấp khoá định kỳ.
OTHER Lý do khác.

RotatedCloudKmsKey

Thông báo đại diện cho khoá Cloud KMS đã xoay vòng. Bao gồm khoá Cloud KMS và bằng chứng xoay vòng được liên kết.

Biểu diễn dưới dạng JSON 
{
  "cloudKmsKeyAndCert": {
    object (CloudKmsKeyAndCert)
  },
  "signingCertificateLineage": string
}
Trường
cloudKmsKeyAndCert

object (CloudKmsKeyAndCert)

Bắt buộc. Khoá Cloud KMS và chứng chỉ được liên kết với khoá.
signingCertificateLineage

string (bytes format)

Bắt buộc. Proof-of-rotation. Xem phần tạo dòng dõi chứng chỉ ký.

Một chuỗi được mã hoá base64.