Method: appsigning.rotateAppSigningKey

Rota la clave de firma de una app a una nueva clave de Google Cloud KMS autoalojada.

Advertencia: Este método solo se aplica a las apps inscritas con claves de Cloud KMS autoalojadas. En el caso de las apps que usan la firma de apps de Play estándar administrada por Google, las solicitudes de rotación de claves se deben iniciar a través de la IU de Google Play Console.

Consulta el Centro de ayuda: https://support.google.com/googleplay/android-developer/answer/9842756

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
name

string

Obligatorio. Es el nombre del paquete o el ID de la app que rota la clave de firma.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "rotatedCloudKmsKey": {
    object (RotatedCloudKmsKey)
  },
  "keyRotationReason": enum (KeyRotationReason)
}
Campos
rotatedCloudKmsKey

object (RotatedCloudKmsKey)

Obligatorio. Clave de Cloud KMS autoalojada.
keyRotationReason

enum (KeyRotationReason)

Obligatorio. Motivo de la rotación de la clave de la app.

Cuerpo de la respuesta

Respuesta para rotar la clave de firma de una app.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "rotatedKeyCertificate": {
    object (CertificateHashes)
  }
}
Campos
rotatedKeyCertificate

object (CertificateHashes)

Son los hashes del certificado de clave rotada para la app. Siempre se establece.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

KeyRotationReason

Son los motivos de la rotación de claves.

Enums
KEY_ROTATION_REASON_UNSPECIFIED No se especificó el motivo de la rotación de claves. No se puede usar.
COMPROMISED_KEY La clave está en riesgo.
USE_STRONGER_KEY Se requiere una clave más segura.
USE_SAME_KEY_FOR_MULTIPLE_APPS Se usa la misma clave para varias apps.
ROUTINE_KEY_UPGRADE Actualización de clave de rutina.
OTHER Otros motivos.

RotatedCloudKmsKey

Es un mensaje que representa la clave rotada de Cloud KMS. Consta de la clave de Cloud KMS y su prueba de rotación asociada.

Representación JSON 
{
  "cloudKmsKeyAndCert": {
    object (CloudKmsKeyAndCert)
  },
  "signingCertificateLineage": string
}
Campos
cloudKmsKeyAndCert

object (CloudKmsKeyAndCert)

Obligatorio. Es la clave de Cloud KMS y el certificado asociado a la clave.
signingCertificateLineage

string (bytes format)

Obligatorio. Prueba de rotación. Consulta cómo crear cadenas de certificados de firma.

String codificada en base64.