Mengeluarkan sertifikat menggunakan Google Cloud CLI

Mengeluarkan sertifikat menggunakan Google Cloud CLI

Halaman ini menjelaskan cara membuat kumpulan certificate authority (CA) dan menerbitkan sertifikat menggunakan Google Cloud CLI.

CA Service memungkinkan Anda men-deploy dan mengelola CA pribadi tanpa mengelola infrastruktur.

Sebelum memulai

• Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

  Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.

• Create or select a Google Cloud project.

  Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

  • Create a Google Cloud project:

    gcloud projects create PROJECT_ID

    Replace PROJECT_ID with a name for the Google Cloud project you are creating.

  • Select the Google Cloud project that you created:

    gcloud config set project PROJECT_ID

    Replace PROJECT_ID with your Google Cloud project name.

• Enable the Certificate Authority Service API:

  gcloud services enable privateca.googleapis.com

• Make sure that billing is enabled for your Google Cloud project.

• Konfigurasikan lokasi default untuk digunakan dalam perintah gcloud dalam panduan memulai ini.

  gcloud config set privateca/location LOCATION
  

  Resource Layanan CA, seperti kumpulan CA dan CA, berada di satu lokasi Google Cloud yang tidak dapat Anda ubah setelah membuat resource ini.

  Catatan: Jika Anda melewati langkah ini, Anda harus menambahkan tanda --location ke beberapa perintah berikut.

Membuat kumpulan CA

Kumpulan certificate authority (CA) adalah kumpulan beberapa CA. Kumpulan CA memberikan kemampuan untuk merotasi rantai kepercayaan tanpa gangguan atau periode nonaktif untuk beban kerja.

Untuk membuat kumpulan CA di tingkat Enterprise, jalankan perintah berikut:

gcloud privateca pools create POOL_ID --tier "enterprise"

Ganti POOL_ID dengan nama kumpulan CA.

Nama semua resource Layanan CA hanya boleh berisi karakter yang diizinkan, yaitu semua huruf, angka, tanda hubung, dan garis bawah. Panjang maksimum nama yang diizinkan adalah 63 karakter.

Membuat CA root

Kumpulan CA kosong saat dibuat. Untuk meminta sertifikat dari kumpulan CA, Anda harus menambahkan CA di dalamnya.

Untuk membuat root CA dan menambahkannya di kumpulan CA yang Anda buat, jalankan perintah berikut:

gcloud privateca roots create CA_ID --pool POOL_ID --subject "CN=Example Prod Root CA, O=Google"

Ganti kode berikut:

• CA_ID: Nama CA root.
• POOL_ID: Nama kumpulan CA.

Layanan CA menampilkan perintah berikut saat membuat root CA:

Created Certificate Authority [projects/PROJECT_ID/locations/LOCATION/caPools/POOL_ID/certificateAuthorities/CA_ID]

Aktifkan root CA dengan memasukkan y saat diminta oleh gcloud CLI.

Setelah memiliki kumpulan CA dengan root CA, Anda dapat melanjutkan untuk membuat sertifikat.

Membuat sertifikat

Untuk menggunakan CA yang baru dibuat guna membuat sertifikat, lakukan hal berikut:

1. Instal library kriptografi Pyca menggunakan perintah pip.

     pip install --user "cryptography>=2.2.0"
   

   Layanan CA menggunakan library kriptografi Pyca untuk membuat dan menyimpan pasangan kunci asimetris baru di komputer lokal Anda. Kunci ini tidak pernah dikirim ke Layanan CA.

2. Agar Google Cloud SDK dapat menggunakan library kriptografi Pyca, Anda harus mengaktifkan paket situs.

   macOS atau Linux

   export CLOUDSDK_PYTHON_SITEPACKAGES=1
   

   Windows

   set CLOUDSDK_PYTHON_SITEPACKAGES=1
   

3. Buat sertifikat.

     gcloud privateca certificates create \
         --issuer-pool POOL_ID \
         --subject "CN=Example Prod,O=Google" \
         --generate-key \
         --key-output-file=./key \
         --cert-output-file=./cert.pem
   

   Ganti POOL_ID dengan ID resource kumpulan CA yang Anda buat.

   Layanan CA menampilkan respons berikut:

     Created Certificate [projects/PROJECT_ID/locations/LOCATION/caPools/POOL_ID/certificates/CERTIFICATE_ID]
   

Pembersihan

Bersihkan dengan menghapus kumpulan CA, CA, dan project yang Anda buat untuk panduan memulai ini.

1. Cabut sertifikat.

   Untuk mencabut sertifikat, jalankan perintah berikut:

     gcloud privateca certificates revoke --certificate CERT_NAME --issuer-pool POOL_ID
     

   Ganti kode berikut:

   • CERT_NAME: Nama sertifikat yang ingin Anda cabut.
   • POOL_ID: Nama kumpulan CA yang menerbitkan sertifikat.

2. Hapus CA.

   Anda hanya dapat menghapus CA setelah mencabut semua sertifikat yang diterbitkan olehnya.

   1. Nonaktifkan CA.

      gcloud privateca roots disable CA_ID --pool=POOL_ID
      

      Ganti kode berikut:

      • CA_ID: ID resource CA.
      • POOL_ID: ID resource kumpulan CA.

   2. Hapus CA.

      gcloud privateca roots delete CA_ID --pool=POOL_ID
      

   Status CA berubah menjadi Deleted. Layanan CA akan menghapus CA secara permanen 30 hari setelah Anda memulai penghapusan.

3. Hapus kumpulan CA.

   Anda hanya dapat menghapus kumpulan CA setelah CA di dalamnya dihapus secara permanen.

   gcloud privateca pools delete POOL_ID
   

4. Menghapus project.

   Perhatian: Menghapus project memiliki efek berikut:

   • Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain yang telah Anda lakukan dalam project tersebut juga akan terhapus.
   • Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

   Jika Anda berencana mempelajari beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

   Delete a Google Cloud project:

   gcloud projects delete PROJECT_ID

Langkah selanjutnya

• Pelajari kumpulan CA lebih lanjut.
• Pelajari lebih lanjut cara membuat kumpulan CA.
• Pelajari lebih lanjut cara membuat CA.
• Pelajari lebih lanjut cara meminta sertifikat.
• Pelajari cara mengontrol jenis sertifikat yang dapat diterbitkan oleh kumpulan CA.