Entri peta sertifikat mengaitkan sertifikat dengan nama host target dan peta sertifikat target. Halaman ini menjelaskan cara membuat dan mengelola entri peta sertifikat.
Untuk mengetahui informasi selengkapnya, lihat Entri peta sertifikat.
Membuat entri peta sertifikat
Anda dapat membuat entri peta sertifikat dan mengaitkan maksimal empat sertifikat dengannya. Sebaiknya gunakan algoritma kunci yang berbeda untuk setiap sertifikat saat menentukan beberapa sertifikat untuk nama host. Misalnya, Anda dapat menggunakan ECDSA untuk satu sertifikat dan RSA untuk sertifikat lainnya. Mengaitkan beberapa sertifikat dengan satu entri peta sertifikat juga membantu saat memigrasikan sertifikat yang dikelola sendiri ke sertifikat yang dikelola Google.
Untuk mengetahui informasi selengkapnya tentang cara load balancer memilih sertifikat selama handshake, lihat Logika pemilihan sertifikat.
Konsol
Di konsol Google Cloud , buka halaman Certificate Manager, lalu klik tab Certificate maps.
Untuk peta sertifikat baru, klik Buat peta sertifikat.
Untuk peta sertifikat yang ada, pilih peta sertifikat yang diperlukan dari daftar peta sertifikat.
Di halaman Buat peta sertifikat atau Edit peta sertifikat, klik Tambahkan entri peta. Jendela Tambahkan entri peta akan terbuka.
Di kolom Nama entri peta, masukkan nama untuk entri peta sertifikat, seperti
my-cert-map-entry-01.Di kolom Description, masukkan deskripsi untuk entri peta sertifikat, seperti
My new cert map entry.Untuk menjadikan entri peta sertifikat baru sebagai entri utama peta sertifikat Anda, pilih Entri utama. Untuk mengetahui informasi selengkapnya, lihat Membuat entri peta sertifikat utama.
Catatan: Anda hanya dapat mengaitkan satu entri peta sertifikat utama dengan peta sertifikat.
Di kolom Nama host, masukkan nama host yang ingin Anda kaitkan dengan entri peta sertifikat, seperti
www.example.com.Catatan: Untuk entri peta sertifikat utama, nama host ditentukan sebagai
<PRIMARY>secara default dan Anda tidak dapat mengubah nama hostnya.Untuk mengaitkan sertifikat dengan entri peta sertifikat, klik Pilih sertifikat. Anda dapat memilih sertifikat yang ada atau mengklik Tambahkan sertifikat untuk membuat sertifikat.
Catatan: Anda dapat mengaitkan maksimum empat sertifikat dengan entri peta sertifikat.
Untuk menambahkan label dan mengaitkannya dengan entri peta sertifikat, klik Tambahkan label, lalu masukkan kunci dan nilai untuk label Anda.
Klik Tambahkan. Entri peta sertifikat dengan sertifikat terkaitnya ditambahkan ke peta sertifikat.
gcloud
Untuk mengaitkan beberapa sertifikat dengan entri peta sertifikat, berikan daftar nama sertifikat yang dipisahkan koma. Untuk setiap subdomain, Anda harus membuat entri peta terpisah.
Untuk membuat entri peta sertifikat, gunakan
perintah gcloud certificate-manager maps entries create:
gcloud certificate-manager maps entries create CERTIFICATE_MAP_ENTRY_NAME \
--map="CERTIFICATE_MAP_NAME" \
--certificates="CERTIFICATE_NAMES" \
--hostname="HOSTNAME"
Ganti kode berikut:
CERTIFICATE_MAP_ENTRY_NAME: nama entri peta sertifikatCERTIFICATE_MAP_NAME: nama peta sertifikat yang terkait dengan entri peta sertifikatCERTIFICATE_NAMES: daftar nama sertifikat yang dipisahkan koma yang ingin Anda kaitkan dengan entri peta sertifikatHOSTNAME: nama host yang ingin Anda kaitkan dengan entri peta sertifikat
API
Untuk mengaitkan beberapa sertifikat dengan entri peta sertifikat, berikan daftar nama sertifikat yang dipisahkan koma. Untuk setiap subdomain, Anda harus membuat entri peta terpisah.
Untuk membuat entri peta sertifikat, buat permintaan POST ke
metode certificateMaps.certificateMapEntries.create:
POST /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries?certificate_map_entry_id=CERTIFICATE_MAP_ENTRY_NAME
{
hostname: "HOSTNAME"
certificates: ["projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME1","projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME2"]
}
Ganti kode berikut:
PROJECT_ID: ID Google Cloud project AndaCERTIFICATE_MAP_NAME: nama peta sertifikat yang terkait dengan entri peta sertifikatCERTIFICATE_MAP_ENTRY_NAME: nama entri peta sertifikatHOSTNAME: nama host yang ingin Anda kaitkan dengan entri peta sertifikatCERTIFICATE_NAME1: nama sertifikat pertama yang ingin Anda kaitkan dengan entri peta sertifikatCERTIFICATE_NAME2: nama sertifikat kedua yang ingin Anda kaitkan dengan entri peta sertifikat
Terraform
Untuk membuat entri peta sertifikat, gunakan
resource google_certificate_manager_certificate_map_entry.
Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.
Membuat entri peta sertifikat utama
Anda dapat menentukan entri peta sertifikat utama yang dapat ditayangkan load balancer jika klien tidak memberikan nama host atau load balancer tidak dapat mencocokkan nama host dengan entri peta sertifikat yang dikonfigurasi.
Konsol
Di konsol Google Cloud , buka halaman Certificate Manager, lalu klik tab Certificate maps.
Untuk peta sertifikat baru, klik Buat peta sertifikat.
Untuk peta sertifikat yang ada, pilih peta sertifikat yang diperlukan dari daftar peta sertifikat.
Saat menambahkan entri peta sertifikat baru, di halaman Buat peta sertifikat, klik Tambahkan entri peta.
Untuk mengedit entri peta sertifikat yang ada, di halaman Edit peta sertifikat, di bagian kolom Tindakan pada baris entri peta, klik ikon , lalu pilih Edit.
Untuk menjadikan entri peta sertifikat sebagai entri utama peta sertifikat Anda, di jendela Tambahkan entri peta, pilih Entri utama.
Catatan: Anda hanya dapat mengaitkan satu entri peta sertifikat utama dengan peta sertifikat.
Klik Simpan.
gcloud
Untuk membuat entri peta sertifikat utama, gunakan
perintah gcloud certificate-manager maps entries create
dengan flag set-primary:
gcloud certificate-manager maps entries create CERTIFICATE_MAP_ENTRY_NAME \
--map="CERTIFICATE_MAP_NAME" \
--certificates="CERTIFICATE_NAMES" \
--set-primary
Ganti kode berikut:
CERTIFICATE_MAP_ENTRY_NAME: nama entri peta sertifikatCERTIFICATE_MAP_NAME: nama peta sertifikat yang terkait dengan entri peta sertifikatCERTIFICATE_NAMES: daftar nama sertifikat yang dipisahkan koma yang ingin Anda kaitkan dengan entri peta sertifikat
API
Untuk membuat entri peta sertifikat, buat permintaan POST ke
metode certificateMaps.certificateMapEntries.create:
POST /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries?certificate_map_entry_id=CERTIFICATE_MAP_ENTRY_NAME
{
matcher: "PRIMARY",
certificates: ["projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME1","projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME2"]
}
Ganti kode berikut:
PROJECT_ID: ID Google Cloud project AndaCERTIFICATE_MAP_NAME: nama peta sertifikat yang terkait dengan entri peta sertifikatCERTIFICATE_MAP_ENTRY_NAME: nama entri peta sertifikatCERTIFICATE_NAME1: nama sertifikat pertama yang ingin Anda kaitkan dengan entri peta sertifikat utama.CERTIFICATE_NAME2: nama sertifikat kedua yang ingin Anda kaitkan dengan entri peta sertifikat utama.
Untuk mengetahui informasi selengkapnya tentang cara load balancer memilih sertifikat selama handshake, lihat Logika pemilihan sertifikat.
Memperbarui entri peta sertifikat
Saat memperbarui entri peta sertifikat yang ada, Anda dapat melakukan hal berikut:
- Menetapkan atau membatalkan penetapan sertifikat
- Mengubah deskripsi
- Mengubah label
Jika Anda menggunakan konsol Google Cloud untuk memperbarui entri peta sertifikat, Anda juga dapat melakukan hal berikut:
- Mengubah nama entri peta.
- Jika tidak ada entri peta lain yang ditetapkan sebagai entri utama, tetapkan entri peta sebagai entri peta utama dari peta sertifikat.
Konsol
Di konsol Google Cloud , buka halaman Certificate Manager, lalu klik tab Certificate maps.
Dari daftar peta sertifikat, klik peta sertifikat yang diperlukan. Halaman Certificate Map Details akan terbuka.
Klik Edit. Halaman Edit peta sertifikat akan terbuka.
Di kolom Tindakan pada baris entri peta, klik ikon , lalu pilih Edit. Jendela Edit entri peta akan terbuka.
Di kolom Nama entri peta, ubah nama untuk entri peta sertifikat.
Di kolom Deskripsi, ubah deskripsi untuk entri peta sertifikat.
Untuk menjadikan entri peta sertifikat sebagai entri utama peta sertifikat Anda, pilih Entri utama. Untuk mengetahui informasi selengkapnya, lihat Membuat entri peta sertifikat utama.
Catatan: Anda hanya dapat mengaitkan satu entri peta sertifikat utama dengan peta sertifikat.
Di kolom Nama host, ubah nama host yang ingin Anda kaitkan dengan entri peta sertifikat.
Catatan: Untuk entri peta sertifikat utama, nama host ditentukan sebagai
<PRIMARY>secara default dan Anda tidak dapat mengubah nama hostnya.Untuk mengaitkan sertifikat dengan entri peta sertifikat, klik Pilih sertifikat. Anda dapat memilih sertifikat yang ada atau mengklik Tambahkan sertifikat untuk membuat sertifikat.
Catatan: Anda dapat mengaitkan maksimum empat sertifikat dengan entri peta sertifikat.
Untuk memindahkan urutan sertifikat ke atas atau ke bawah, klik ikon atau ikon untuk sertifikat yang diperlukan.
Untuk menghapus sertifikat, klik Hapus item untuk sertifikat yang diperlukan.
Untuk menambahkan label dan mengaitkannya dengan entri peta sertifikat, klik Tambahkan label, lalu masukkan kunci dan nilai untuk label Anda.
Untuk menghapus label, klik Hapus item untuk label yang diperlukan.
Klik Simpan.
gcloud
Untuk memperbarui entri peta sertifikat, gunakan
perintah gcloud certificate-manager maps entries update:
gcloud certificate-manager maps entries update CERTIFICATE_MAP_ENTRY_NAME \
--map="CERTIFICATE_MAP_NAME" \
--certificates="CERTIFICATE_NAME,CERTIFICATE_NAME" \
--description="DESCRIPTION" \
--update-labels="LABELS"
Ganti kode berikut:
CERTIFICATE_MAP_ENTRY_NAME: nama entri peta sertifikatCERTIFICATE_MAP_NAME: nama peta sertifikat yang terkait dengan entri peta sertifikatCERTIFICATE_NAME: nama sertifikat yang ingin Anda kaitkan dengan entri peta sertifikatDESCRIPTION: deskripsi untuk entri peta sertifikatLABELS: daftar label yang diterapkan ke entri peta sertifikat
API
Untuk memperbarui entri peta sertifikat, buat permintaan PATCH ke
metode certificateMaps.certificateMapEntries.patch:
PATCH /v1/projects/example-project/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries/CERTIFICATE_MAP_ENTRY_NAME?updateMask=labels,description,certificates
{
"certificates": ["projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME"],
"description": "DESCRIPTION",
"labels": { "LABEL_KEY": "LABEL_VALUE" }
}
Ganti kode berikut:
CERTIFICATE_MAP_NAME: nama peta sertifikat yang terkait dengan entri peta sertifikatCERTIFICATE_MAP_ENTRY_NAME: nama entri peta sertifikatPROJECT_ID: ID Google Cloud project AndaCERTIFICATE_NAME: nama sertifikatDESCRIPTION: deskripsi untuk entri peta sertifikatLABEL_KEY: kunci label yang diterapkan ke entri peta sertifikatLABEL_VALUE: nilai label yang diterapkan ke entri peta sertifikat
Mencantumkan entri peta sertifikat
Anda dapat melihat, memfilter, dan mengurutkan daftar semua entri peta sertifikat yang telah Anda kaitkan dengan peta sertifikat.
Konsol
Di konsol Google Cloud , buka halaman Certificate Manager, lalu klik tab Certificate maps.
Dari daftar peta sertifikat, klik peta sertifikat yang diperlukan. Halaman Detail Peta Sertifikat akan terbuka dengan informasi mendetail tentang peta sertifikat yang dipilih dan daftar entri peta yang terkait.
gcloud
Untuk mencantumkan entri peta sertifikat yang terkait dengan peta sertifikat, gunakan
perintah gcloud certificate-manager maps entries list
gcloud certificate-manager maps entries list --map=CERTIFICATE_MAP_NAME \
--filter="FILTER" \
--page-size="PAGE_SIZE" \
--limit="LIMIT" \
--sort-by="SORT_BY"
Ganti kode berikut:
CERTIFICATE_MAP_NAME: nama peta sertifikat yang terkait dengan entri peta sertifikatFILTER: ekspresi yang membatasi hasil yang ditampilkan ke nilai tertentu.Misalnya, Anda dapat memfilter hasil menurut kriteria berikut:
- Status penayangan:
--filter='state=ACTIVE' - Pencocok (ditetapkan sebagai utama):
--filter='-matcher=PRIMARY' - Nama host:
--filter='hostname=example.com' - Sertifikat yang ditetapkan:
--filter='certificates:my-cert' - Label dan waktu pembuatan:
--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.
- Status penayangan:
PAGE_SIZE: jumlah hasil yang ingin Anda tampilkan per halamanLIMIT: jumlah maksimum hasil yang ingin Anda tampilkanSORT_BY: daftar kolomnameyang dipisahkan koma yang digunakan untuk mengurutkan hasil yang ditampilkan. Urutan pengurutan default adalah menaik; untuk urutan pengurutan menurun, awali kolom dengan tanda gelombang (~).
API
Untuk mencantumkan entri peta sertifikat yang terkait dengan peta sertifikat, buat permintaan GET ke metode certificateMaps.certificateMapEntries.list:
GET /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries?filter=FILTER&pageSize=PAGE_SIZE&sortBy=SORT_BY
Ganti kode berikut:
PROJECT_ID: ID Google Cloud project AndaCERTIFICATE_MAP_NAME: nama peta sertifikat targetFILTER: ekspresi yang membatasi hasil yang ditampilkan ke nilai tertentu.Misalnya, Anda dapat memfilter hasil menurut kriteria berikut:
- Status penayangan:
--filter='state=ACTIVE' - Pencocok (ditetapkan sebagai utama):
--filter='-matcher=PRIMARY' - Nama host:
--filter='hostname=example.com' - Sertifikat yang ditetapkan:
--filter='certificates:my-cert' - Label dan waktu pembuatan:
--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.
- Status penayangan:
PAGE_SIZE: jumlah hasil yang ingin Anda tampilkan per halamanSORT_BY: daftar kolomnameyang dipisahkan koma yang digunakan untuk mengurutkan hasil yang ditampilkan. Urutan pengurutan default adalah menaik; untuk urutan pengurutan menurun, awali kolom dengan tanda gelombang (~).
Melihat status entri peta sertifikat
Anda dapat melihat detail dan status entri peta sertifikat yang terkait dengan peta sertifikat.
Konsol
Di konsol Google Cloud , buka halaman Certificate Manager, lalu klik tab Certificate maps.
Dari daftar peta sertifikat, klik peta sertifikat yang diperlukan. Halaman Detail Peta Sertifikat akan terbuka dengan informasi mendetail tentang peta sertifikat yang dipilih dan daftar entri peta yang terkait.
Di bagian Entri peta, klik nama entri peta yang ingin Anda lihat. Halaman Map entry details akan terbuka dengan informasi mendetail tentang entri peta yang dipilih.
gcloud
Untuk melihat status entri peta sertifikat yang terkait dengan peta sertifikat, gunakan
perintah gcloud certificate-manager maps entries describe:
gcloud certificate-manager maps entries describe CERTIFICATE_MAP_ENTRY_NAME \
--map="CERTIFICATE_MAP_NAME"
Ganti kode berikut:
CERTIFICATE_MAP_ENTRY_NAME: nama entri peta sertifikatCERTIFICATE_MAP_NAME: nama peta sertifikat yang terkait dengan entri peta sertifikat
Outputnya mirip dengan hal berikut ini:
certificates: createTime: '2021-09-06T10:01:56.229472109Z' hostname: example.com name: projects/my-project/locations/global/certificateMaps/myCertMap/certificateMapEntries/myCertMapEntry state: ACTIVE updateTime: '2021-09-06T10:01:58.277031787Z'
API
Untuk melihat status entri peta sertifikat yang terkait dengan
peta sertifikat, buat permintaan GET ke
metode certificateMaps.certificateMapEntries.get:
GET /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries/CERTIFICATE_MAP_ENTRY_NAME
Ganti kode berikut:
PROJECT_ID: ID Google Cloud project AndaCERTIFICATE_MAP_NAME: nama peta sertifikat yang terkait dengan entri peta sertifikatCERTIFICATE_MAP_ENTRY_NAME: nama entri peta sertifikat
Menghapus entri peta sertifikat
Saat Anda menghapus entri peta sertifikat, sertifikat yang terkait dengan entri peta sertifikat akan dilepas dari proxy target.
Menghapus entri peta sertifikat tidak akan menghapus sertifikat terkait dari Google Cloud. Anda harus menghapus sertifikat tersebut secara manual.
Konsol
Di konsol Google Cloud , buka halaman Certificate Manager, lalu klik tab Certificate maps.
Dari daftar peta sertifikat, klik peta sertifikat yang diperlukan. Halaman Certificate Map Details akan terbuka.
Klik Edit. Halaman Edit certificate map akan terbuka.
Di kolom Tindakan pada baris entri peta, klik ikon , pilih Hapus, lalu klik Hapus.
gcloud
Untuk menghapus entri peta sertifikat yang terkait dengan
peta sertifikat, gunakan
perintah gcloud certificate-manager maps entries delete:
gcloud certificate-manager maps entries delete CERTIFICATE_MAP_ENTRY_NAME \
--map="CERTIFICATE_MAP_NAME"
Ganti kode berikut:
CERTIFICATE_MAP_ENTRY_NAME: nama entri peta sertifikatCERTIFICATE_MAP_NAME: nama peta sertifikat yang terkait dengan entri peta sertifikat
API
Untuk menghapus entri peta sertifikat yang terkait dengan peta sertifikat,
buat permintaan DELETE ke
metode certificateMaps.certificateMapEntries.delete:
DELETE /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries/CERTIFICATE_MAP_ENTRY_NAME
Ganti kode berikut:
PROJECT_ID: ID Google Cloud project AndaCERTIFICATE_MAP_NAME: nama peta sertifikat yang terkait dengan entri peta sertifikatCERTIFICATE_MAP_ENTRY_NAME: nama entri peta sertifikat
Langkah berikutnya
- Mengelola sertifikat
- Mengelola peta sertifikat
- Mengelola otorisasi DNS
- Mengelola resource konfigurasi penerbitan sertifikat