将第三方证书迁移到证书管理器

控制台

您可以在创建证书时创建 DNS 授权或附加现有 DNS 授权。如需了解详情，请参阅创建引用 DNS 授权的 Google 管理的证书。

gcloud

您可以创建两种类型的 DNS 授权：FIXED_RECORD 或 PER_PROJECT_RECORD。如需了解详情，请参阅 DNS 授权。

FIXED_RECORD DNS 授权

如需创建 FIXED_RECORD DNS 授权，请使用以下 gcloud certificate-manager dns-authorizations create 命令：

gcloud certificate-manager dns-authorizations create AUTHORIZATION_NAME \
    --domain="DOMAIN_NAME" \
    --type=[FIXED_RECORD]

替换以下内容：

• AUTHORIZATION_NAME：DNS 授权的名称。
• DOMAIN_NAME：您要为其创建此 DNS 授权的目标网域的名称。域名必须是完全限定域名，例如 myorg.example.com。

创建 FIXED_RECORD DNS 授权后，请使用 gcloud certificate-manager dns-authorizations describe 命令对其进行验证：

gcloud certificate-manager dns-authorizations describe AUTHORIZATION_NAME

输出类似于以下内容：在输出中找到 dnsResourceRecord 部分。找到 CNAME 记录，并将该记录的详细信息（data、name 和 type）添加到您的 DNS 配置中。

createTime: '2022-01-14T13:35:00.258409106Z'
dnsResourceRecord:
  data: 0e40fc77-a37d-4eb8-8fe1-eea2e18d12d9.4.authorize.certificatemanager.goog.
  name: _acme-challenge.myorg.example.com.
  type: CNAME
domain: myorg.example.com
name: projects/myProject/locations/global/dnsAuthorizations/myAuthorization
updateTime: '2022-01-14T13:35:01.571086137Z'

PER_PROJECT_RECORD DNS 授权

如需创建 PER_PROJECT_RECORD DNS 授权，请使用以下 gcloud certificate-manager dns-authorizations create 命令：

gcloud certificate-manager dns-authorizations create AUTHORIZATION_NAME \
    --domain="DOMAIN_NAME" \
    --type=PER_PROJECT_RECORD

替换以下内容：

• AUTHORIZATION_NAME：DNS 授权的名称。
• DOMAIN_NAME：您要为其创建此 DNS 授权的目标网域的名称。域名必须是完全限定域名，例如 myorg.example.com。

创建 PER_PROJECT_RECORD DNS 授权后，请使用 gcloud certificate-manager dns-authorizations describe 命令对其进行验证：

gcloud certificate-manager dns-authorizations describe AUTHORIZATION_NAME

输出类似于以下内容：在输出中找到 dnsResourceRecord 部分。找到 CNAME 记录，并将该记录的详细信息（data、name 和 type）添加到您的 DNS 配置中。

createTime: '2022-01-14T13:35:00.258409106Z'
dnsResourceRecord:
  data: 0e40fc77-a37d-4eb8-8fe1-eea2e18d12d9.4.authorize.certificatemanager.goog.
  name: _acme-challenge_ujmmovf2vn55tgye.myorg.example.com
  type: CNAME
domain: myorg.example.com
name: projects/myProject/locations/global/dnsAuthorizations/myAuthorization
updateTime: '2022-01-14T13:35:01.571086137Z'

Terraform

如需创建 DNS 授权，您可以使用 google_certificate_manager_dns_authorization 资源。

resource "google_certificate_manager_dns_authorization" "default" {
  name        = "${local.name}-dnsauth-${random_id.tf_prefix.hex}"
  description = "The default dns auth"
  domain      = local.domain
  labels = {
    "terraform" : true
  }
}

如需了解如何应用或移除 Terraform 配置，请参阅基本 Terraform 命令。

API

如需创建 DNS 授权，请向 dnsAuthorizations.create 方法发出 POST 请求：

POST /v1/projects/PROJECT_ID/locations/global/dnsAuthorizations?dns_authorization_id=AUTHORIZATION_NAME"
{
  "domain": "DOMAIN_NAME",
  "type": "PER_PROJECT_RECORD" //optional
}

替换以下内容：

• PROJECT_ID： Google Cloud 项目的 ID。
• AUTHORIZATION_NAME：DNS 授权的名称。
• DOMAIN_NAME：您要为其创建此 DNS 授权的目标网域的名称。 域名必须是完全限定域名，例如 myorg.example.com。

控制台

1. 在 Google Cloud 控制台中，前往 Certificate Manager 页面。

   前往 Certificate Manager

2. 在证书标签页上，点击添加证书。

3. 在证书名称字段中，输入证书的唯一名称。

4. 可选：在说明字段中，输入证书的说明。通过说明，您可以识别证书。

5. 在位置部分，选择全球。

6. 对于范围，选择默认。

7. 在证书类型部分，选择创建 Google 管理的证书。

8. 对于证书授权机构类型，请选择公开。

9. 在域名字段中，指定以英文逗号分隔的证书域名列表。每个域名都必须是完全限定域名，例如 myorg.example.com。域名也可以是通配符域名，例如 *.example.com。

10. 对于授权类型，请选择 DNS 授权。

    该页面会列出网域名的 DNS 授权。如果某个域名没有关联的 DNS 授权，请按以下步骤创建：

    1. 点击创建缺少的 DNS 授权。
    2. 在 DNS 授权名称字段中，指定 DNS 授权的名称。 默认 DNS 授权类型为 FIXED_RECORD。如需在多个项目中独立管理证书，请选中按项目授权复选框。
    3. 点击创建 DNS 授权。

11. 在标签字段中，指定要与证书关联的标签。如需添加标签，请点击add_box添加标签，并为标签指定键和值。

12. 点击创建。

    新证书会显示在证书列表中。

gcloud

如需创建具有 DNS 授权的 Google 管理的全球证书，请运行带有 dns-authorizations 标志的 certificate-manager certificates create 命令：

gcloud certificate-manager certificates create CERTIFICATE_NAME \
    --domains="DOMAIN_NAME,*.DOMAIN_NAME" \
    --dns-authorizations="AUTHORIZATION_NAMES"

替换以下内容：

• CERTIFICATE_NAME：证书的名称。
• DOMAIN_NAME：目标网域的名称。域名必须是完全限定域名，例如 myorg.example.com，或通配符域名，例如 *.myorg.example.com。星号点前缀 (*.) 表示通配符证书。
• AUTHORIZATION_NAMES：您为证书创建的 DNS 授权的名称列表（以英文逗号分隔）。

Terraform

使用 google_certificate_manager_certificate 资源。

resource "google_certificate_manager_certificate" "root_cert" {
  name        = "${local.name}-rootcert-${random_id.tf_prefix.hex}"
  description = "The wildcard cert"
  managed {
    domains = [local.domain, "*.${local.domain}"]
    dns_authorizations = [
      google_certificate_manager_dns_authorization.default.id
    ]
  }
  labels = {
    "terraform" : true
  }
}

API

通过向 certificates.create 方法发出 POST 请求来创建证书，如下所示：

POST /v1/projects/PROJECT_ID/locations/global/certificates?certificate_id=CERTIFICATE_NAME
{
 "managed": {
  "domains": ["DOMAIN_NAME"],
  "dnsAuthorizations": [
   "projects/PROJECT_ID/locations/global/dnsAuthorizations/AUTHORIZATION_NAME",
  ],
 }
}

替换以下内容：

• PROJECT_ID： Google Cloud 项目的 ID。
• CERTIFICATE_NAME：证书的名称。
• DOMAIN_NAME：目标网域的名称。域名必须是完全限定域名，例如 myorg.example.com，或通配符域名，例如 *.myorg.example.com。星号英文句点前缀 (*.) 表示通配符证书。
• AUTHORIZATION_NAMES：以英文逗号分隔的 DNS 授权名称列表。

控制台

要创建记录集，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 DNS 区域页面。

   转到 Cloud DNS 可用区

2. 点击要添加记录的 DNS 区域的名称。

3. 在区域详情页面上，点击添加标准。

4. 在创建记录集页面的 DNS 名称字段中，输入 DNS 区域的子网域。

   输入子域名时，请确保子域名（包括 DNS 名称字段中显示的灰显文本）与 gcloud certificate-manager dns-authorizations describe 命令的输出中显示的 dnsResourceRecord.name 字段的完整值一致。

   请参见以下示例：

   • 如果 dnsResourceRecord.name 字段值为 _acme-challenge.myorg.example.com.，且“DNS 名称”字段中的灰显文本为 .example.com.，则输入 _acme-challenge.myorg。

   • 如果 dnsResourceRecord.name 字段值为 _acme-challenge.myorg.example.com.，并且“DNS 名称”字段中的灰显文本为 .myorg.example.com.，则输入 _acme-challenge。

   • 如果 dnsResourceRecord.name 字段的值为 _acme-challenge_ujmmovf2vn55tgye.myorg.example.com.，并且DNS 名称字段中的灰显文本为 .myorg.example.com.，则输入 _acme-challenge_ujmmovf2vn55tgye。

5. 在资源记录类型字段中，选择 CNAME。

6. 在 TTL 字段中，输入一个正数值表示资源记录的生存时间，即该资源记录可缓存的时间期限。

7. 从 TTL 单位列表中，选择时间单位，例如 30 minutes。

8. 在规范名称字段中，输入 dnsResourceRecord.data 字段的完整值，如 gcloud certificate-manager dns-authorizations describe 命令的输出中所示。

9. 要输入其他信息，请点击添加一项。

10. 点击创建。

gcloud

创建 DNS 授权后，gcloud CLI 命令会返回相应的 CNAME 记录。如需将 CNAME 记录添加到目标网域的 DNS 区域中的 DNS 配置，请按以下步骤操作：

1. 发起 DNS 记录事务：

   gcloud dns record-sets transaction start --zone="DNS_ZONE_NAME"
   

   将 DNS_ZONE_NAME 替换为目标 DNS 区域的名称。

2. 将 CNAME 记录添加到目标 DNS 区域：

   gcloud dns record-sets transaction add CNAME_RECORD \
       --name="VALIDATION_SUBDOMAIN_NAME.DOMAIN_NAME." \
       --ttl="30" \
       --type="CNAME" \
       --zone="DNS_ZONE_NAME"
   

   替换以下内容：

   • CNAME_RECORD：用于创建相应 DNS 授权的 Google Cloud CLI 命令所返回的 CNAME 记录的完整数据值。
   • VALIDATION_SUBDOMAIN_NAME：DNS 区域的前缀子网域，例如 _acme-challenge。您可以按照创建 DNS 授权中的说明，从 gcloud certificate-manager dns-authorizations describe 命令日志中复制该名称。
   • DOMAIN_NAME：目标网域的名称。网域名称必须是完全限定域名，例如 myorg.example.com。您还必须在目标域名后添加尾随英文句点。
   • DNS_ZONE_NAME：目标 DNS 区域的名称。

   如需详细了解 FIXED_RECORD 和 PER_PROJECT_RECORD DNS 授权之间的区别，请参阅以下示例。这两个示例的唯一区别在于 --name 标志的值。

   FIXED_RECORD DNS 授权

   gcloud dns record-sets transaction add 0e40fc77-a37d-4eb8-8fe1-eea2e18d12d9.4.authorize.certificatemanager.goog. \
       --name="_acme-challenge.myorg.example.com." \
       --ttl="30" \
       --type="CNAME" \
       --zone="myorg-example-com"
   

   PER_PROJECT_RECORD DNS 授权

   gcloud dns record-sets transaction add 0e40fc77-a37d-4eb8-8fe1-eea2e18d12d9.4.authorize.certificatemanager.goog. \
       --name="_acme-challenge_ujmmovf2vn55tgye.myorg.example.com." \
       --ttl="30" \
       --type="CNAME" \
       --zone="myorg-example-com"
   

3. 运行 DNS 记录事务以保存更改：

   gcloud dns record-sets transaction execute --zone="DNS_ZONE_NAME"
   

   将 DNS_ZONE_NAME 替换为目标 DNS 区域的名称。

Terraform

如需将 CNAME 记录添加到您的 DNS 配置，您可以使用 google_dns_record_set 资源。

resource "google_dns_record_set" "cname" {
  name         = google_certificate_manager_dns_authorization.default.dns_resource_record[0].name
  managed_zone = google_dns_managed_zone.default.name
  type         = google_certificate_manager_dns_authorization.default.dns_resource_record[0].type
  ttl          = 300
  rrdatas      = [google_certificate_manager_dns_authorization.default.dns_resource_record[0].data]
}

控制台

1. 在 Google Cloud 控制台中，前往 Certificate Manager 页面。

   前往 Certificate Manager

2. 在证书标签页上，查看证书的状态列。

gcloud

如需验证证书的状态，请运行以下命令：

gcloud certificate-manager certificates describe CERTIFICATE_NAME

将 CERTIFICATE_NAME 替换为目标 Google 管理的证书的名称。

输出类似于以下内容：

createTime: '2021-10-20T12:19:53.370778666Z'
expireTime: '2022-05-07T05:03:49Z'
managed:
  authorizationAttemptInfo:
  - domain: myorg.example.com
    state: AUTHORIZED
  dnsAuthorizations:
    - projects/myProject/locations/global/dnsAuthorizations/myCert
  domains:
  - myorg.example.com
  state: ACTIVE
name: projects/myProject/locations/global/certificates/myCert
pemCertificate: |
  -----BEGIN CERTIFICATE-----
  [...]
  -----END CERTIFICATE-----
sanDnsnames:
  -   myorg.example.com
updateTime: '2021-10-20T12:19:55.083385630Z'

gcloud

如需创建证书映射，请使用 gcloud certificate-manager maps create 命令：

gcloud certificate-manager maps create CERTIFICATE_MAP_NAME

将 CERTIFICATE_MAP_NAME 替换为目标证书映射的名称。

Terraform

如需创建证书映射，您可以使用 google_certificate_manager_certificate_map 资源。

resource "google_certificate_manager_certificate_map" "certificate_map" {
  name        = "${local.name}-certmap-${random_id.tf_prefix.hex}"
  description = "${local.domain} certificate map"
  labels = {
    "terraform" : true
  }
}

gcloud

如需创建证书映射条目，请使用 gcloud certificate-manager maps entries create 命令：

gcloud certificate-manager maps entries create CERTIFICATE_MAP_ENTRY_NAME \
    --map="CERTIFICATE_MAP_NAME" \
    --certificates="CERTIFICATE_NAME" \
    --hostname="HOSTNAME"

替换以下内容：

• CERTIFICATE_MAP_ENTRY_NAME：证书映射条目的名称。
• CERTIFICATE_MAP_NAME：证书映射条目所附加到的证书映射的名称。
• CERTIFICATE_NAME：要与证书映射条目关联的证书的名称。

• HOSTNAME：您要与证书映射条目相关联的主机名。

  如果您想创建涵盖通配符网域和根网域的证书，请指定包含根网域和通配符的 hostname，例如 example.com 和 *.example.com。此外，您还必须指定两个证书映射条目，一个用于 example.com，另一个用于 *.example.com。

Terraform

如需创建包含根网域的证书映射条目，请使用 google_certificate_manager_certificate_map_entry 资源。

resource "google_certificate_manager_certificate_map_entry" "first_entry" {
  name        = "${local.name}-first-entry-${random_id.tf_prefix.hex}"
  description = "example certificate map entry"
  map         = google_certificate_manager_certificate_map.certificate_map.name
  labels = {
    "terraform" : true
  }
  certificates = [google_certificate_manager_certificate.root_cert.id]
  hostname     = local.domain
}

如需创建包含通配符网域的证书映射条目，请使用 google_certificate_manager_certificate_map_entry 资源。

resource "google_certificate_manager_certificate_map_entry" "second_entry" {
  name        = "${local.name}-second-entity-${random_id.tf_prefix.hex}"
  description = "example certificate map entry"
  map         = google_certificate_manager_certificate_map.certificate_map.name
  labels = {
    "terraform" : true
  }
  certificates = [google_certificate_manager_certificate.root_cert.id]
  hostname     = "*.${local.domain}"
}

gcloud

如需将证书映射附加到新的目标代理，请使用 gcloud compute target-https-proxies create 命令：

gcloud compute target-https-proxies create PROXY_NAME \
    --certificate-map="CERTIFICATE_MAP_NAME" \
    --url-map="URL_MAP" \
    --global

替换以下内容：

• PROXY_NAME：目标代理的名称。
• CERTIFICATE_MAP_NAME：引用证书映射条目和关联证书的证书映射的名称。
• URL_MAP：网址映射的名称

如需将证书映射附加到现有目标 HTTPS 代理，请使用 gcloud compute target-https-proxies update 命令。如果您不知道现有目标代理的名称，请前往目标代理页面，并记下目标代理的名称。

gcloud compute target-https-proxies update PROXY_NAME \
    --certificate-map="CERTIFICATE_MAP_NAME" \
    --global

创建或更新目标代理后，运行以下命令进行验证：

gcloud compute target-https-proxies list

Terraform

如需将证书映射附加到目标代理，您可以使用 google_compute_target_https_proxy 资源。