撤消证书

本页面介绍如何撤消证书。

Certificate Authority Service 通过定期发布证书吊销列表 (CRL) 来支持证书吊销。您只能撤消企业层级中的 CA 池颁发的证书。

注意 ：虽然 CA Service 确实支持在 Enterprise 层级发布 CRL，但若要有效撤消，客户端必须定期下载这些 CRL 并拒绝其中有序列号的证书。

准备工作

确保您拥有 Certificate Authority Service Operation Manager (roles/privateca.caManager) 或 CA Service Admin (roles/privateca.admin) Identity and Access Management (IAM) 角色。如需详细了解 CA Service 的预定义 IAM 角色，请参阅使用 IAM 进行访问权限控制。

如需了解如何授予 IAM 角色，请参阅授予单个角色。

启用 CRL 发布

如需撤消由 CA 池颁发的证书，您必须在 CA 池上启用 CRL 发布。您可以在创建 CA 池时启用 CRL 发布。如果最初已停用，您可以稍后启用 CRL 发布。

启用 CRL 发布功能后，系统会每天发布一个新的 CRL，有效期为 7 天。系统还会在撤消任何新证书后的 15 分钟内发布新的 CRL。

注意 ：在停用 CRL 发布时颁发的任何证书都没有执行撤消检查所需的扩展。我们建议您在颁发任何长期证书之前确保已启用 CRL 发布。

如需在 CA 池中启用 CRL 发布，请执行以下操作：

控制台

1. 转到 Google Cloud 控制台中的 Certificate Authority Service 页面。

   证书授权机构服务

2. 点击要修改的 CA 池中 CA 的名称。

3. 在证书授权机构页面上，点击修改政策。

4. 在出现的左侧面板中，点击发布选项下方的在已颁发的证书中发布证书吊销列表的访问网址切换开关。

   注意 ：如果切换此开关，系统会为 CA 所在 CA 池中的所有 CA 启用 CRL 发布。

gcloud

运行以下命令：

gcloud privateca pools update POOL_ID \
  --publish-crl

将 POOL_ID 替换为 CA 池的名称。

如需详细了解 gcloud privateca pools update 命令，请参阅 gcloud privatecapool update。

CA Service 对每个 CRL 施加的未过期已吊销证书数量上限为 50 万个。

注意 ：只有最后 100 个 CRL（按时间顺序）会保留为 CertificateRevocationList 资源，并且较旧的 CRL 会被自动删除。在由客户管理的 Cloud Storage 存储分区中保留旧 CRL 时，须遵循客户配置的对象版本控制和保留政策。
请注意，除非 CA 被删除，否则仍然可以从服务管理的 Cloud Storage 存储分区访问已从 CA Service 删除的 CRL。即使 CA 被删除，CRL 也永远不会从客户管理的 Cloud Storage 存储分区中删除。

撤消证书

CA Service 允许按序列号或资源名称撤消证书，也接受可选原因。证书吊销后，其序列号和吊销原因将显示在以后的所有 CRL 中，直到证书到期。系统还会在撤消后的 15 分钟内生成带外 CRL。

如需撤消证书，请按以下步骤操作：

控制台

1. 转到 Google Cloud 控制台中的 Certificate Authority Service 页面。

   前往 Certificate Authority Service

2. 点击专用证书管理器标签页。
3. 在证书列表中，点击要删除的证书所在行中的 查看更多。
4. 点击撤消。
5. 在随即打开的对话框中，点击确认。

注意 ：Google Cloud 控制台不支持使用序列号撤消证书。如果要使用序列号撤消证书，请使用 Google Cloud CLI。

gcloud

• 如需使用资源名称撤消证书，请运行以下命令：

  gcloud privateca certificates revoke \
    --certificate CERT_ID \
    --issuer-pool POOL_ID \
    --reason REVOCATION_REASON
  

  替换以下内容：

  • CERT_ID：您要撤消的证书的唯一标识符。
  • POOL_ID：颁发证书的 CA 池的名称。
  • REVOCATION_REASON：撤消证书的原因。

  --reason 标志是可选的。如需详细了解此标志，请参阅 --reason，或使用以下带 --help 标志的 gcloud 命令：

  gcloud privateca certificates revoke --help
  

  如需详细了解 gcloud privateca certificates revoke 命令，请参阅 gcloud privateca 证书撤消。

• 如需使用序列号撤消证书，请运行以下命令：

  gcloud privateca certificates revoke \
    --serial-number SERIAL_NUMBER \
    --issuer-pool POOL_ID \
    --reason REVOCATION_REASON
  

  替换以下内容：

  • SERIAL_NUMBER：证书的序列号。
  • POOL_ID：颁发证书的 CA 池的名称。
  • REVOCATION_REASON：撤消证书的原因。

  如需详细了解 gcloud privateca certificates revoke 命令，请参阅 gcloud privateca 证书撤消。

  当系统提示您确认时，您可以输入“Y”来进行确认：

  You are about to revoke Certificate [projects/PROJECT_ID/locations/CA_POOL_REGION/caPools/POOL_ID/certificates/CERT_ID]
  
  Do you want to continue? (Y/n) Y
  Revoked certificate [projects/PROJECT_ID/locations/CA_POOL_REGION/caPools/POOL_ID/certificates/CERT_ID] at DATE_TIME.
  
  

Go

如需向 CA Service 进行身份验证，请设置应用默认凭据。如需了解详情，请参阅为本地开发环境设置身份验证。

import (
	"context"
	"fmt"
	"io"

	privateca "cloud.google.com/go/security/privateca/apiv1"
	"cloud.google.com/go/security/privateca/apiv1/privatecapb"
)

// Revoke an issued certificate. Once revoked, the certificate will become invalid
// and will expire post its lifetime.
func revokeCertificate(
	w io.Writer,
	projectId string,
	location string,
	caPoolId string,
	certId string) error {
	// projectId := "your_project_id"
	// location := "us-central1"		// For a list of locations, see: https://cloud.google.com/certificate-authority-service/docs/locations.
	// caPoolId := "ca-pool-id"			// The CA Pool id in which the certificate exists.
	// certId := "certificate"			// A unique name for the certificate.

	ctx := context.Background()
	caClient, err := privateca.NewCertificateAuthorityClient(ctx)
	if err != nil {
		return fmt.Errorf("NewCertificateAuthorityClient creation failed: %w", err)
	}
	defer caClient.Close()

	fullCertName := fmt.Sprintf("projects/%s/locations/%s/caPools/%s/certificates/%s", projectId, location,
		caPoolId, certId)

	// Create the RevokeCertificateRequest and specify the appropriate revocation reason.
	// See https://pkg.go.dev/cloud.google.com/go/security/privateca/apiv1/privatecapb#RevokeCertificateRequest.
	req := &privatecapb.RevokeCertificateRequest{
		Name:   fullCertName,
		Reason: privatecapb.RevocationReason_PRIVILEGE_WITHDRAWN,
	}

	_, err = caClient.RevokeCertificate(ctx, req)
	if err != nil {
		return fmt.Errorf("RevokeCertificate failed: %w", err)
	}

	fmt.Fprintf(w, "Certificate %s revoked", certId)

	return nil
}

Java

如需向 CA Service 进行身份验证，请设置应用默认凭据。如需了解详情，请参阅为本地开发环境设置身份验证。

import com.google.api.core.ApiFuture;
import com.google.cloud.security.privateca.v1.Certificate;
import com.google.cloud.security.privateca.v1.CertificateAuthorityServiceClient;
import com.google.cloud.security.privateca.v1.CertificateName;
import com.google.cloud.security.privateca.v1.RevocationReason;
import com.google.cloud.security.privateca.v1.RevokeCertificateRequest;
import java.io.IOException;
import java.util.concurrent.ExecutionException;

public class RevokeCertificate {

  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException {
    // TODO(developer): Replace these variables before running the sample.
    // location: For a list of locations, see:
    // https://cloud.google.com/certificate-authority-service/docs/locations
    // poolId: Id for the CA pool which contains the certificate.
    // certificateName: Name of the certificate to be revoked.
    String project = "your-project-id";
    String location = "ca-location";
    String poolId = "ca-pool-id";
    String certificateName = "certificate-name";
    revokeCertificate(project, location, poolId, certificateName);
  }

  // Revoke an issued certificate. Once revoked, the certificate will become invalid and will expire
  // post its lifetime.
  public static void revokeCertificate(
      String project, String location, String poolId, String certificateName)
      throws IOException, ExecutionException, InterruptedException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `certificateAuthorityServiceClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
        CertificateAuthorityServiceClient.create()) {

      // Create Certificate Name.
      CertificateName certificateNameParent =
          CertificateName.newBuilder()
              .setProject(project)
              .setLocation(location)
              .setCaPool(poolId)
              .setCertificate(certificateName)
              .build();

      // Create Revoke Certificate Request and specify the appropriate revocation reason.
      RevokeCertificateRequest revokeCertificateRequest =
          RevokeCertificateRequest.newBuilder()
              .setName(certificateNameParent.toString())
              .setReason(RevocationReason.PRIVILEGE_WITHDRAWN)
              .build();

      // Revoke certificate.
      ApiFuture<Certificate> response =
          certificateAuthorityServiceClient
              .revokeCertificateCallable()
              .futureCall(revokeCertificateRequest);
      Certificate certificateResponse = response.get();

      System.out.println("Certificate Revoked: " + certificateResponse.getName());
    }
  }
}

Python

如需向 CA Service 进行身份验证，请设置应用默认凭据。如需了解详情，请参阅为本地开发环境设置身份验证。

import google.cloud.security.privateca_v1 as privateca_v1

def revoke_certificate(
    project_id: str,
    location: str,
    ca_pool_name: str,
    certificate_name: str,
) -> None:
    """
    Revoke an issued certificate. Once revoked, the certificate will become invalid and will expire post its lifetime.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        location: location you want to use. For a list of locations, see: https://cloud.google.com/certificate-authority-service/docs/locations.
        ca_pool_name: name for the CA pool which contains the certificate.
        certificate_name: name of the certificate to be revoked.
    """

    caServiceClient = privateca_v1.CertificateAuthorityServiceClient()

    # Create Certificate Path.
    certificate_path = caServiceClient.certificate_path(
        project_id, location, ca_pool_name, certificate_name
    )

    # Create Revoke Certificate Request and specify the appropriate revocation reason.
    request = privateca_v1.RevokeCertificateRequest(
        name=certificate_path, reason=privateca_v1.RevocationReason.PRIVILEGE_WITHDRAWN
    )
    result = caServiceClient.revoke_certificate(request=request)

    print("Certificate revoke result:", result)

注意 ：我们安排每天重新创建 CRL。但是，如果撤消证书，系统将在 15 分钟内创建新的 CRL。如果次日之前有必要重新创建 CRL，请颁发虚拟证书，然后将其撤消以强制重新创建 CRL。

后续步骤

• 了解如何对证书进行排序和过滤。
• 了解如何实现委托 OCSP 响应程序。