En este documento se describe cómo revocar un certificado con el Servicio de Autoridades de Certificación. Al revocar un certificado, este se invalida antes de su fecha de vencimiento, lo que impide que se use para la autenticación. Puedes revocar un certificado si la clave privada se ha visto comprometida, si se ha sustituido por un certificado nuevo o si ya no se necesita (por ejemplo, si se ha retirado el servicio para el que se emitió el certificado).
Este documento está dirigido a audiencias del grupo de operadores de aplicaciones, como desarrolladores de aplicaciones o científicos de datos, que gestionan los ciclos de vida de los certificados en sus proyectos. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.
Acerca de la revocación de certificados
El servicio de autoridades de certificación permite revocar certificados publicando listas de revocación de certificados (CRLs). Una CRL es una lista de números de serie de certificados que se han revocado y en los que ya no se confía. De forma predeterminada, se publica una nueva CRL cada 15 minutos. Además, cada vez que se revoca un certificado correctamente, se genera automáticamente una nueva CRL.
Los certificados emitidos por CA Service incluyen una extensión llamada punto de distribución de CRL (CDP). Esta extensión contiene la URL donde puedes encontrar y descargar la CRL de ese certificado. Las aplicaciones cliente usan esta URL para obtener la CRL y comprobar si el número de serie de un certificado está presente. Si el número de serie aparece en la lista, el certificado se considera no válido y la conexión debe rechazarse.
Antes de empezar
Para poder revocar un certificado, debes solicitar los permisos necesarios y preparar tu entorno.
Solicitar roles de gestión de identidades y accesos
Para revocar certificados y ver solicitudes de revocación, ponte en contacto con el admin. de la org. de gestión de identidades y accesos para solicitar el rol de gestor de operaciones de servicio de CA (certificate-authority-service-operation-manager) en el espacio de nombres del proyecto de la autoridad de certificación.
Prepara tu entorno
Genera un archivo kubeconfig para configurar el acceso de
kubectl.
Revocar un certificado
El método para revocar un certificado depende de si la autoridad de certificación (CA) emisora tiene habilitado el modo ACME. Después de revocar un certificado, su número de serie aparece en todas las CRL futuras de esa CA hasta que el certificado caduque.
Revocar un certificado de una AC con ACME habilitado
Cada ACME habilitada para ACME expone una URL de servidor ACME única en su estado una vez que está lista. Para revocar un certificado de una AC con ACME habilitado, debes usar una herramienta de cliente de ACME para interactuar con esta URL mediante el protocolo ACME.
Revocar un certificado de una AC con ACME habilitado:
Obtén la URL del servidor ACME de tu CA:
kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \ get certificateauthorities CA_NAME \ -n USER_PROJECT_NAMESPACE \ -ojson | jq -r '.status.acme.uri'Haz los cambios siguientes:
MANAGEMENT_API_SERVER_KUBECONFIG: la ruta al archivo kubeconfig del servidor de la API Management.CA_NAME: el nombre de la AC con ACME habilitado (raíz o subordinada).USER_PROJECT_NAMESPACE: el espacio de nombres del proyecto.
Usa la URL obtenida con la herramienta de cliente de ACME que prefieras para emitir una solicitud de revocación. Consulta la documentación de tu cliente de ACME específico para obtener más información.
Revocar un certificado de una AC con ACME inhabilitado
Si el modo ACME está inhabilitado en la AC, revoca un certificado creando y aplicando un recurso personalizado RevokeCertificateRequest:
Crea un archivo YAML de recurso personalizado de
RevokeCertificateRequest(comorevoke-cert-request.yaml):apiVersion: pki.security.gdc.goog/v1 kind: RevokeCertificateRequest metadata: name: REVOKE_CERT_REQ_NAME namespace: USER_PROJECT_NAMESPACE spec: certificateRequestRef: name: CERT_REQ_NAME namespace: USER_PROJECT_NAMESPACE reason: REASONHaz los cambios siguientes:
REVOKE_CERT_REQ_NAME: el nombre definido por el usuario para la solicitud de revocación.USER_PROJECT_NAMESPACE: el espacio de nombres del proyecto.CERT_REQ_NAME: el nombre del recursoCertificateRequestasociado al certificado que quieres revocar.REASON: motivo de la revocación. Los siguientes son motivos válidos:Unspecified,KeyCompromise,CaCompromise,AffiliationChanged,Superseded,CessationOfOperation,CertificateHold,RemoveFromCrl,PrivilegeWithdrawnyAaCompromise.
Aplica el recurso personalizado:
kubectl apply -f revoke-cert-request.yaml --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIGSustituye MANAGEMENT_API_SERVER_KUBECONFIG por la ruta al archivo kubeconfig del servidor de la API Management.
Verifica que la solicitud de revocación del certificado esté lista:
kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \ -n USER_PROJECT_NAMESPACE \ get revokecertificaterequest.pki.security.gdc.goog/REVOKE_CERT_REQ_NAME \ -ojson | jq -r ' .status.conditions[] | select( .type as $id | "Ready" | index($id))'Haz los cambios siguientes:
MANAGEMENT_API_SERVER_KUBECONFIG: la ruta al archivo kubeconfig del servidor de la API Management.USER_PROJECT_NAMESPACE: el espacio de nombres del proyecto.REVOKE_CERT_REQ_NAME: el nombre de la solicitud de revocación.
El resultado es similar al siguiente:
{ "lastTransitionTime": "2025-08-19T23:20:22Z", "message": "RevokeCertificateRequest reconciled", "observedGeneration": 1, "reason": "Ready", "status": "True", "type": "Ready" }El proceso se ha completado y el número de serie del certificado se ha añadido a la siguiente CRL generada.
Mostrar solicitudes de certificados revocados
Muestra todos los recursos de RevokeCertificateRequest de un espacio de nombres de proyecto:
kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \
-n USER_PROJECT_NAMESPACE \
get revokecertificaterequests
Haz los cambios siguientes:
MANAGEMENT_API_SERVER_KUBECONFIG: la ruta al archivo kubeconfig del servidor de la API Management.USER_PROJECT_NAMESPACE: el espacio de nombres del proyecto.
El resultado es similar al siguiente:
NAMESPACE NAME READY AGE
foo revoke-cert-req True 30s