Mulai Cepat: Mengatur dan mengambil sertifikat dari Azure Key Vault menggunakan Azure CLI

Dalam mulai cepat ini, Anda membuat brankas kunci di Azure Key Vault dengan Azure CLI. Azure Key Vault adalah layanan awan yang berfungsi sebagai penyimpanan rahasia yang aman. Anda dapat menyimpan kunci, kata sandi, sertifikat, dan rahasia lainnya dengan aman. Untuk informasi lebih lanjut tentang Key Vault, Anda dapat meninjau Gambaran Umum. Azure CLI digunakan untuk membuat dan mengelola sumber daya Azure menggunakan perintah atau skrip. Setelah menyelesaikannya, Anda akan menyimpan sertifikat.

Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.

Prasyarat

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.

  

• Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.

  • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.

  • Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.

  • Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

• Mulai cepat ini memerlukan Azure CLI versi 2.0.4 atau yang lebih baru. Jika menggunakan Azure Cloud Shell, versi terbaru sudah terinstal.

Buat grup sumber daya

Grup sumber daya adalah kontainer logis yang disebarkan dan dikelola oleh sumber daya Azure. Gunakan perintah az group create untuk membuat grup sumber daya bernama myResourceGroup di lokasi eastus.

az group create --name "myResourceGroup" --location "EastUS"

Buat brankas kunci

Gunakan perintah Azure CLI az keyvault create untuk membuat Key Vault di grup sumber daya dari langkah sebelumnya. Anda perlu memberikan beberapa informasi:

• Nama brankas kunci: String yang terdiri dari 3 hingga 24 karakter yang hanya dapat berisi angka (0-9), huruf (a-z, A-Z), dan tanda hubung (-)

  Penting

  Setiap key vault harus memiliki nama yang unik. Ganti <your-unique-keyvault-name> dengan nama brankas kunci Anda dalam contoh berikut.

• Nama grup sumber daya: myResourceGroup.

• Lokasi: EastUS.

az keyvault create --name "<your-unique-keyvault-name>" --resource-group "myResourceGroup"

Keluaran dari perintah ini menunjukkan properti key vault yang baru dibuat. Perhatikan dua properti ini:

• Nama Vault: Nama yang Anda berikan ke --name parameter .
• URI vault: Dalam contoh ini, URI Vault https://< your-unique-keyvault-name.vault.azure.net/>. Aplikasi yang menggunakan brankas Anda melalui REST API-nya harus menggunakan URI ini.

Berikan izin akun pengguna Anda untuk mengelola sertifikat di Key Vault

Untuk mendapatkan izin ke brankas kunci Anda melalui Kontrol Akses Berbasis Peran (RBAC), tetapkan peran ke "Nama Prinsipal Pengguna" (UPN) Anda menggunakan perintah Azure CLI az role assignment create.

az role assignment create --role "Key Vault Certificate Officer" --assignee "<upn>" --scope "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.KeyVault/vaults/<your-unique-keyvault-name>"

Ganti <upn>, <subscription-id>, <resource-group-name> , dan <your-unique-keyvault-name> dengan nilai aktual Anda. UPN Anda biasanya akan dalam format alamat email (misalnya, username@domain.com).

Unggah sertifikat ke Key Vault

Untuk menambahkan sertifikat ke brankas, Anda hanya perlu mengambil beberapa langkah tambahan. Sertifikat ini bisa digunakan oleh aplikasi.

Ketik perintah di bawah ini untuk membuat sertifikat yang ditandatangani sendiri dengan kebijakan default yang disebut ExampleCertificate :

az keyvault certificate create --vault-name "<your-unique-keyvault-name>" -n ExampleCertificate -p "$(az keyvault certificate get-default-policy)"

Sekarang Anda dapat mereferensikan sertifikat yang Anda tambahkan ke Azure Key Vault dengan menggunakan URI-nya. Gunakan https://<your-unique-keyvault-name>.vault.azure.net/certificates/ExampleCertificate untuk mendapatkan versi saat ini.

Untuk melihat sertifikat yang disimpan sebelumnya:

az keyvault certificate show --name "ExampleCertificate" --vault-name "<your-unique-keyvault-name>"

Sekarang, Anda telah membuat Key Vault, menyimpan sertifikat, dan mengambilnya.

Membersihkan sumber daya

Mulai cepat dan tutorial lain dalam koleksi ini dibentuk berdasarkan mulai cepat ini. Jika berencana untuk melanjutkan bekerja dengan mulai cepat dan tutorial berikutnya, Anda mungkin ingin membiarkan sumber daya ini tetap di tempatnya.

Jika tidak lagi dibutuhkan, gunakan perintah az group delete Azure CLI untuk menghapus grup sumber daya, dan semua sumber daya terkait:

az group delete --name "myResourceGroup"

Langkah berikutnya

Dalam mulai cepat ini, Anda membuat Key Vault dan menyimpan sertifikat di dalamnya. Untuk mempelajari selengkapnya tentang Key Vault dan cara mengintegrasikannya dengan aplikasi Anda, lihat artikel di bawah ini.

• Baca Gambaran Umum Azure Key Vault
• Lihat referensi untuk perintah az keyvault Azure CLI
• Tinjau Ringkasan keamanan Azure Key Vault