Method: appsigning.rotateAppSigningKey

Esegue la rotazione della chiave di firma di un'app in una nuova chiave Cloud KMS auto-ospitata di Google Cloud.

Avviso: questo metodo si applica solo alle app registrate con chiavi Cloud KMS auto-ospitate. Per le app che utilizzano la firma dell'app di Google Play standard gestita da Google, le richieste di rotazione della chiave devono essere avviate tramite l'interfaccia utente di Google Play Console.

Consulta il Centro assistenza: https://support.google.com/googleplay/android-developer/answer/9842756

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Nome del pacchetto o ID app dell'app che esegue la rotazione della chiave di firma.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "rotatedCloudKmsKey": {
    object (RotatedCloudKmsKey)
  },
  "keyRotationReason": enum (KeyRotationReason)
}
Campi
rotatedCloudKmsKey

object (RotatedCloudKmsKey)

Obbligatorio. Chiave Cloud KMS auto-ospitata.
keyRotationReason

enum (KeyRotationReason)

Obbligatorio. Motivo della rotazione della chiave dell'app.

Corpo della risposta

Risposta alla rotazione della chiave di firma di un'app.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "rotatedKeyCertificate": {
    object (CertificateHashes)
  }
}
Campi
rotatedKeyCertificate

object (CertificateHashes)

Gli hash dei certificati delle chiavi ruotate per l'app. Imposta sempre.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

KeyRotationReason

Motivi della rotazione della chiave.

Enum
KEY_ROTATION_REASON_UNSPECIFIED Motivo della rotazione della chiave non specificato. Non può essere utilizzato.
COMPROMISED_KEY La chiave è compromessa.
USE_STRONGER_KEY È necessaria una chiave più sicura.
USE_SAME_KEY_FOR_MULTIPLE_APPS La stessa chiave viene utilizzata per più app.
ROUTINE_KEY_UPGRADE Upgrade della chiave di routine.
OTHER Altro motivo.

RotatedCloudKmsKey

Messaggio che rappresenta la chiave Cloud KMS ruotata. È costituita dalla chiave Cloud KMS e dalla relativa prova di rotazione.

Rappresentazione JSON 
{
  "cloudKmsKeyAndCert": {
    object (CloudKmsKeyAndCert)
  },
  "signingCertificateLineage": string
}
Campi
cloudKmsKeyAndCert

object (CloudKmsKeyAndCert)

Obbligatorio. Chiave Cloud KMS e certificato associato alla chiave.
signingCertificateLineage

string (bytes format)

Obbligatorio. Prova di rotazione. Consulta la sezione Creare lignaggi dei certificati di firma.

Una stringa con codifica in base64.