Bagikan melalui


Autentikasi klien menggunakan rantai sertifikat CA

Gunakan rantai sertifikat CA di Azure Event Grid untuk mengautentikasi klien saat menyambungkan ke layanan.

Dalam panduan ini, Anda melakukan tugas-tugas berikut:

  1. Unggah sertifikat CA, sertifikat induk langsung sertifikat klien, ke namespace layanan.
  2. Mengonfigurasi pengaturan autentikasi klien.
  3. Koneksi klien menggunakan sertifikat klien yang ditandatangani oleh sertifikat CA yang diunggah sebelumnya.

Prasyarat

  • Anda memerlukan Namespace Layanan Event Grid yang sudah dibuat.
  • Anda memerlukan rantai sertifikat CA: Sertifikat klien dan sertifikat induk (biasanya sertifikat perantara) yang digunakan untuk menandatangani sertifikat klien.

Membuat sampel sertifikat klien dan thumbprint

Jika Anda belum memiliki sertifikat, Anda dapat membuat sertifikat sampel menggunakan langkah CLI. Pertimbangkan untuk menginstal secara manual untuk Windows.

Setelah Anda menginstal Langkah, di Windows PowerShell, jalankan perintah untuk membuat sertifikat akar dan menengah.

.\step ca init --deployment-type standalone --name MqttAppSamplesCA --dns localhost --address 127.0.0.1:443 --provisioner MqttAppSamplesCAProvisioner

Menggunakan file CA yang dihasilkan untuk membuat sertifikat untuk klien.

.\step certificate create client1-authnID client1-authnID.pem client1-authnID.key --ca .step/certs/intermediate_ca.crt --ca-key .step/secrets/intermediate_ca_key --no-password --insecure --not-after 2400h

Mengunggah sertifikat CA ke namespace layanan

  1. Di portal Azure, navigasikan ke namespace Layanan Event Grid Anda.
  2. Di bawah bagian broker MQTT di rel kiri, navigasikan ke menu sertifikat CA.
  3. Pilih + Sertifikat untuk meluncurkan halaman Unggah sertifikat.
  4. Tambahkan nama sertifikat dan telusuri untuk menemukan sertifikat perantara (.step/certs/intermediate_ca.crt) dan pilih Unggah. Anda dapat mengunggah file jenis .pem, .cer, atau .crt.

Screenshot showing the added CA certificate listed in the CA certificates page.

Catatan

  • Panjang nama sertifikat CA bisa 3-50 karakter.
  • Nama sertifikat CA dapat mencakup alfanumerik, tanda hubung(-) dan, tanpa spasi.
  • Nama harus unik per namespace.

Mengonfigurasi pengaturan autentikasi klien

  1. Navigasi ke halaman Klien.
  2. Pilih + Klien untuk menambahkan klien baru. Jika Anda ingin memperbarui klien yang sudah ada, Anda dapat memilih nama klien dan membuka halaman Perbarui klien.
  3. Di halaman Buat klien, tambahkan nama klien, nama autentikasi klien, dan skema validasi autentikasi sertifikat klien. Biasanya nama autentikasi klien akan berada di bidang nama subjek untuk sertifikat klien.

Screenshot showing the client metadata using the subject matches the authentication name option.

  1. Pilih tombol Buat untuk membuat klien.

Contoh skema objek sertifikat

{
    "properties": {
        "description": "CA certificate description",
        "encodedCertificate": "-----BEGIN CERTIFICATE-----`Base64 encoded Certificate`-----END CERTIFICATE-----"
    }
}

Konfigurasi CLI Azure

Gunakan perintah berikut untuk mengunggah/menampilkan/menghapus sertifikat otoritas sertifikat (CA) ke layanan

Mengunggah akar otoritas sertifikat atau sertifikat perantara

az eventgrid namespace ca-certificate create -g myRG --namespace-name myNS -n myCertName --certificate @./resources/ca-cert.json

Perlihatkan informasi sertifikat

az eventgrid namespace ca-certificate show -g myRG --namespace-name myNS -n myCertName

Menghapus sertifikat

az eventgrid namespace ca-certificate delete -g myRG --namespace-name myNS -n myCertName

Langkah berikutnya