Mengelola peta sertifikat

Peta sertifikat merujuk ke satu atau beberapa entri peta sertifikat yang menetapkan sertifikat tertentu ke nama host tertentu. Halaman ini menjelaskan cara membuat dan mengelola peta sertifikat.

Untuk mengetahui informasi selengkapnya, lihat Peta sertifikat.

Catatan: Petunjuk Google Cloud CLI di halaman ini mengasumsikan bahwa Anda menggunakan Cloud Shell atau lingkungan lain dengan bash yang telah diinstal. Untuk mengetahui informasi selengkapnya tentang perintah gcloud CLI yang digunakan di halaman ini, lihat referensi CLI Certificate Manager.

Buat peta sertifikat

Anda dapat membuat peta sertifikat untuk merujuk ke entri peta sertifikat yang terkait dengan sertifikat Anda.

Peran yang diperlukan untuk tugas ini

Untuk melakukan tugas ini, Anda harus memiliki salah satu peran IAM berikut di project Google Cloud target.

• Peran Certificate Manager Editor (roles/certificatemanager.editor)
• Peran Certificate Manager Owner (roles/certificatemanager.owner)

Untuk mengetahui informasi selengkapnya, lihat Peran dan izin.

Catatan: Jika Anda tidak diberi peran yang diperlukan, hubungi Administrator IAM yang memiliki peran Project IAM Admin (roles/resourcemanager.projectIamAdmin) untuk memberi Anda peran yang tidak ada.

Konsol

1. Di konsol Google Cloud , buka halaman Certificate Manager, lalu klik tab peta sertifikat.

   Buka Certificate Manager

2. Klik Create certificate map.

3. Di kolom Name, masukkan nama untuk peta sertifikat, seperti cert-map-8.

4. Di kolom Description, masukkan deskripsi untuk peta sertifikat, seperti My new certificate map.

5. Untuk membuat entri peta sertifikat dan menambahkannya ke peta sertifikat, klik Add map entry dan ikuti langkah-langkah yang disebutkan di bagian berikutnya.

6. Untuk menambahkan label dan mengaitkannya dengan peta sertifikat, klik Tambahkan label, lalu masukkan kunci dan nilai untuk label Anda.

7. Klik Create.

gcloud

Untuk membuat peta sertifikat, gunakan perintah gcloud certificate-manager maps create:

gcloud certificate-manager maps create CERTIFICATE_MAP_NAME

Ganti kode berikut:

• CERTIFICATE_MAP_NAME: nama peta sertifikat

API

Untuk membuat peta sertifikat, buat permintaan POST ke metode certificateMaps.create:

POST /v1/projects/PROJECT_ID/locations/global/certificateMaps?certificate_map_id=CERTIFICATE_MAP_NAME

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda
• CERTIFICATE_MAP_NAME: nama peta sertifikat

Terraform

Untuk membuat peta sertifikat, gunakan resource google_certificate_manager_certificate_map:

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

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

Melampirkan peta sertifikat ke proxy

Setelah membuat dan mengonfigurasi peta sertifikat dengan entri peta sertifikat, lampirkan peta sertifikat ke proxy target. Certificate Manager mendukung proxy HTTPS target dan proxy SSL target dengan cakupan global. Untuk mengetahui informasi selengkapnya tentang perbedaan antara jenis proxy ini, lihat Menggunakan proxy target.

Jika Anda melampirkan sertifikat TLS (SSL) ke proxy target dan juga melampirkan sertifikat melalui peta sertifikat, proxy akan menggunakan sertifikat yang direferensikan dalam peta sertifikat dan mengabaikan sertifikat yang dilampirkan secara langsung.

Peran yang diperlukan untuk tugas ini

Untuk melakukan tugas ini, Anda harus memiliki salah satu peran IAM berikut di project Google Cloud target.

• Peran Certificate Manager Editor (roles/certificatemanager.editor)

Untuk mengetahui informasi selengkapnya, lihat Peran dan izin.

Catatan: Jika Anda tidak diberi peran yang diperlukan, hubungi Administrator IAM yang memiliki peran Project IAM Admin (roles/resourcemanager.projectIamAdmin) untuk memberi Anda peran yang tidak ada.

Konsol

Catatan: Jika proxy target bukan bagian dari load balancer, Anda tidak dapat menggunakan konsol Google Cloud untuk melampirkan peta sertifikat ke proxy tersebut. Untuk melakukan langkah ini, gunakan gcloud CLI atau API.

Jika proxy target adalah bagian dari load balancer yang ada, Anda dapat melampirkan peta sertifikat dengan mengedit konfigurasi frontend load balancer.

1. Di konsol Google Cloud , buka halaman Load balancing.

   Buka Load balancing

2. Klik nama load balancer yang ingin Anda perbarui, lalu klik Edit.

3. Klik Frontend configuration, lalu pilih konfigurasi alamat IP dan port frontend yang ingin Anda edit.

4. Jika Choose certificate repository muncul, pilih Use certificate map.

5. Dalam daftar Select a certificate map, pilih peta sertifikat Anda.

6. Klik Done, lalu klik Update.

gcloud

Untuk melampirkan peta sertifikat ke proxy HTTPS target, gunakan perintah gcloud compute target-https-proxies update:

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

Untuk melampirkan peta sertifikat ke proxy SSL target, gunakan perintah gcloud compute target-ssl-proxies update:

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

Ganti kode berikut:

• PROXY_NAME: nama proxy target
• CERTIFICATE_MAP_NAME: nama peta sertifikat yang berisi entri peta yang merujuk ke sertifikat target

API

Untuk melampirkan peta sertifikat ke proxy HTTPS target, buat permintaan POST ke metode targetHttpsProxies:

POST /projects/PROJECT_ID/global/targetHttpsProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "//certificatemanager.googleapis.com/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME",
}

Untuk melampirkan peta sertifikat ke proxy SSL target, buat permintaan POST ke metode targetSslProxies:

POST /projects/PROJECT_ID/global/targetSslProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "//certificatemanager.googleapis.com/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME",
}

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda
• PROXY_NAME: nama proxy target
• CERTIFICATE_MAP_NAME: nama peta sertifikat yang berisi entri peta yang merujuk ke sertifikat target

Melepaskan peta sertifikat dari proxy

Sebelum melepaskan peta sertifikat dari proxy, perhatikan hal-hal berikut:

• Jika ada sertifikat TLS (SSL) yang terpasang langsung ke proxy, melepaskan peta sertifikat akan menyebabkan proxy kembali menggunakannya.

• Jika tidak ada sertifikat TLS (SSL) yang dilampirkan langsung ke proxy, peta sertifikat tidak dapat dilepas. Lampirkan setidaknya satu sertifikat TLS langsung ke proxy sebelum melepaskan peta sertifikat.

Peran yang diperlukan untuk tugas ini

Untuk melakukan tugas ini, Anda harus memiliki salah satu peran IAM berikut di project Google Cloud target.

• Peran Compute Load Balancer Admin (roles/compute.loadBalancerAdmin)

Untuk mengetahui informasi selengkapnya, lihat Peran dan izin.

Catatan: Jika Anda tidak diberi peran yang diperlukan, hubungi Administrator IAM yang memiliki peran Project IAM Admin (roles/resourcemanager.projectIamAdmin) untuk memberi Anda peran yang tidak ada.

gcloud

Untuk melepaskan peta sertifikat yang terpasang dari proxy HTTPS target, gunakan perintah gcloud compute target-https-proxies update:

gcloud compute target-https-proxies update PROXY_NAME \
    --clear-certificate-map

Untuk melepaskan peta sertifikat yang terlampir dari proxy SSL target, gunakan perintah gcloud compute target-ssl-proxies update:

gcloud compute target-ssl-proxies update PROXY_NAME \
    --clear-certificate-map

Ganti kode berikut:

• PROXY_NAME: nama proxy target

API

Untuk melepaskan peta sertifikat yang terpasang dari proxy HTTPS target, buat permintaan POST ke metode targetHttpsProxies:

POST /projects/PROJECT_ID/global/targetHttpsProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "",
}

Untuk melepaskan peta sertifikat yang terpasang dari proxy SSL target, buat permintaan POST ke metode targetSslProxies:

POST /projects/PROJECT_ID/global/targetSslProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "",
}

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda
• PROXY_NAME: nama proxy target

Memperbarui peta sertifikat

Anda dapat memperbarui deskripsi dan label peta sertifikat. Jika menggunakan konsolGoogle Cloud , Anda dapat menambahkan entri peta baru ke peta sertifikat atau mengedit atau menghapus entri peta yang terkait dengan peta sertifikat.

Peran yang diperlukan untuk tugas ini

Untuk melakukan tugas ini, Anda harus memiliki salah satu peran IAM berikut di project Google Cloud target.

• Peran Certificate Manager Editor (roles/certificatemanager.editor)
• Peran Certificate Manager Owner (roles/certificatemanager.owner)

Untuk mengetahui informasi selengkapnya, lihat Peran dan izin.

Catatan: Jika Anda tidak diberi peran yang diperlukan, hubungi Administrator IAM yang memiliki peran Project IAM Admin (roles/resourcemanager.projectIamAdmin) untuk memberi Anda peran yang tidak ada.

Konsol

1. Di konsol Google Cloud , buka halaman Certificate Manager, lalu klik tab peta sertifikat.

   Buka Certificate Manager

2. Dari daftar peta sertifikat, klik peta sertifikat yang diperlukan. Halaman Detail Peta Sertifikat akan terbuka.

3. Klik Edit. Halaman Edit certificate map akan terbuka.

4. Di kolom Description, masukkan deskripsi baru untuk peta sertifikat.

5. Untuk menambahkan entri peta baru ke peta sertifikat, klik Add map entry dan ikuti langkah-langkah yang disebutkan di bagian Membuat entri peta sertifikat.

   Untuk mengedit entri peta, di kolom Actions pada baris entri peta, klik ikon , pilih Edit, lalu ikuti langkah-langkah yang disebutkan di bagian Memperbarui entri peta sertifikat.

   Untuk menghapus entri peta, di kolom Actions pada baris entri peta, klik ikon , pilih Delete, lalu ikuti langkah-langkah yang disebutkan di bagian Menghapus entri peta sertifikat.

6. Anda dapat menambahkan, menghapus, atau memperbarui label yang terkait dengan peta sertifikat.

   Untuk menambahkan label, klik Tambahkan label, lalu tentukan kunci dan nilai untuk label Anda.

   Untuk menghapus label, klik Hapus item untuk label yang diperlukan.

7. Klik Simpan.

gcloud

Untuk memperbarui peta sertifikat, gunakan perintah gcloud certificate-manager maps update:

gcloud certificate-manager maps update CERTIFICATE_MAP_NAME \
    --description="DESCRIPTION"
    --update-labels="LABELS"

Ganti kode berikut:

• CERTIFICATE_MAP_NAME: nama peta sertifikat
• DESCRIPTION: deskripsi baru untuk peta sertifikat ini
• LABELS: daftar label yang dipisahkan koma yang diterapkan ke peta sertifikat ini

API

Untuk memperbarui peta sertifikat, buat permintaan PATCH ke metode certificateMaps.patch:

PATCH /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME?updateMask=labels,description
{
  "description": "DESCRIPTION",
  "labels": {
    "LABEL_KEY": "LABEL_VALUE",
  }
}

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda
• CERTIFICATE_MAP_NAME: nama peta sertifikat
• DESCRIPTION: deskripsi baru untuk peta sertifikat ini
• LABEL_KEY: kunci label yang diterapkan ke peta sertifikat ini
• LABEL_VALUE: label yang diterapkan ke peta sertifikat ini

Mencantumkan peta sertifikat

Anda dapat melihat, memfilter, dan mengurutkan daftar semua peta sertifikat yang telah Anda buat.

Peran yang diperlukan untuk tugas ini

Untuk melakukan tugas ini, Anda harus memiliki salah satu peran IAM berikut di project Google Cloud target.

• Peran Certificate Manager Viewer (roles/certificatemanager.viewer)
• Peran Certificate Manager Editor (roles/certificatemanager.editor)
• Peran Certificate Manager Owner (roles/certificatemanager.owner)

Untuk mengetahui informasi selengkapnya, lihat Peran dan izin.

Catatan: Jika Anda tidak diberi peran yang diperlukan, hubungi Administrator IAM yang memiliki peran Project IAM Admin (roles/resourcemanager.projectIamAdmin) untuk memberi Anda peran yang tidak ada.

Konsol

1. Di konsol Google Cloud , buka halaman Certificate Manager.

   Buka Certificate Manager

2. Klik tab Peta Sertifikat. Anda dapat melihat, memfilter, dan mengonfigurasi kolom tampilan semua peta sertifikat dalam project yang dipilih.

gcloud

Untuk mencantumkan peta sertifikat, gunakan perintah gcloud certificate-manager maps list:

gcloud certificate-manager maps list \
    --filter="FILTER" \
    --page-size="PAGE_SIZE" \
    --limit="LIMIT" \
    --sort-by="SORT_BY"

Ganti kode berikut:

• FILTER: ekspresi yang membatasi hasil yang ditampilkan ke nilai tertentu.

  Misalnya, untuk memfilter hasil berdasarkan label dan waktu pembuatan, Anda dapat menentukan: --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'.

  Untuk contoh pemfilteran lainnya yang dapat Anda gunakan dengan Certificate Manager, lihat Mengurutkan dan memfilter hasil daftar dalam dokumentasi Cloud Key Management Service.

• PAGE_SIZE: jumlah hasil yang ingin Anda tampilkan per halaman

• LIMIT: jumlah maksimum hasil yang ingin Anda tampilkan

• SORT_BY: daftar kolom name yang dipisahkan koma yang digunakan untuk mengurutkan hasil yang ditampilkan. Tata urutan default adalah menaik; untuk tata urutan menurun, beri awalan tilde (~) pada kolom.

API

Untuk mencantumkan peta sertifikat yang dikonfigurasi, buat permintaan LIST ke metode certificateMaps.list:

GET /v1/projects/PROJECT_ID/locations/global/certificateMaps?filter=FILTER&pageSize=PAGE_SIZE&sortBy=SORT_BY

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda

• FILTER: ekspresi yang membatasi hasil yang ditampilkan ke nilai tertentu.

  Misalnya, untuk memfilter hasil berdasarkan label dan waktu pembuatan, Anda dapat menentukan: --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'

  Untuk contoh pemfilteran lainnya yang dapat Anda gunakan dengan Certificate Manager, lihat Mengurutkan dan memfilter hasil daftar dalam dokumentasi Cloud Key Management Service.

• PAGE_SIZE: jumlah hasil yang ingin Anda tampilkan per halaman

• SORT_BY: daftar kolom name yang dipisahkan koma yang digunakan untuk mengurutkan hasil yang ditampilkan. Tata urutan default adalah menaik; untuk tata urutan menurun, beri awalan tilde (~) pada kolom.

Melihat detail peta sertifikat

Anda dapat melihat detail peta sertifikat yang ada, seperti tanggal-waktu pembuatan, tanggal-waktu update terakhir, dan deskripsi.

Peran yang diperlukan untuk tugas ini

Untuk melakukan tugas ini, Anda harus memiliki salah satu peran IAM berikut di project Google Cloud target.

• Peran Certificate Manager Viewer (roles/certificatemanager.viewer)
• Peran Certificate Manager Editor (roles/certificatemanager.editor)
• Peran Certificate Manager Owner (roles/certificatemanager.owner)

Untuk mengetahui informasi selengkapnya, lihat Peran dan izin.

Catatan: Jika Anda tidak diberi peran yang diperlukan, hubungi Administrator IAM yang memiliki peran Project IAM Admin (roles/resourcemanager.projectIamAdmin) untuk memberi Anda peran yang tidak ada.

Konsol

1. Di konsol Google Cloud , buka halaman Certificate Manager, lalu klik tab peta sertifikat.

   Buka Certificate Manager

2. Dari daftar peta sertifikat, klik peta sertifikat yang diperlukan. Halaman Certificate Map Details akan terbuka dengan informasi mendetail tentang peta sertifikat yang dipilih.

gcloud

Untuk melihat detail peta sertifikat, gunakan perintah gcloud certificate-manager maps describe:

gcloud certificate-manager maps describe CERTIFICATE_MAP_NAME

Ganti kode berikut:

• CERTIFICATE_MAP_NAME: nama peta sertifikat

API

Untuk melihat detail peta sertifikat, buat permintaan GET ke metode certificateMaps.get:

GET /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda
• CERTIFICATE_MAP_NAME: nama peta sertifikat

Menghapus peta sertifikat

Sebelum menghapus peta sertifikat, lakukan hal berikut:

• Lepaskan peta sertifikat dari proxy target.
• Jika ada entri peta sertifikat yang ditetapkan ke peta, hapus entri peta sertifikat yang ditetapkan ke peta sertifikat.

Peran yang diperlukan untuk tugas ini

Untuk melakukan tugas ini, Anda harus memiliki salah satu peran IAM berikut di project Google Cloud target.

• Peran Certificate Manager Owner (roles/certificatemanager.owner)

Untuk mengetahui informasi selengkapnya, lihat Peran dan izin.

Catatan: Jika Anda tidak diberi peran yang diperlukan, hubungi Administrator IAM yang memiliki peran Project IAM Admin (roles/resourcemanager.projectIamAdmin) untuk memberi Anda peran yang tidak ada.

Konsol

1. Di konsol Google Cloud , buka halaman Certificate Manager, lalu klik tab peta sertifikat.

   Buka Certificate Manager

2. Dari daftar peta sertifikat, klik peta sertifikat yang diperlukan. Halaman Detail Peta Sertifikat akan terbuka.

3. Klik Delete, lalu klik Delete.

gcloud

Untuk menghapus peta sertifikat, gunakan perintah gcloud certificate-manager maps delete:

gcloud certificate-manager maps delete CERTIFICATE_MAP_NAME

Ganti kode berikut:

• CERTIFICATE_MAP_NAME: nama peta sertifikat

API

Untuk menghapus peta sertifikat, buat permintaan DELETE ke metode certificateMaps.delete:

DELETE /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda
• CERTIFICATE_MAP_NAME: nama peta sertifikat

Langkah berikutnya

• Mengelola sertifikat
• Mengelola entri peta sertifikat
• Mengelola otorisasi DNS
• Mengelola resource konfigurasi penerbitan sertifikat