Bagikan melalui


Penyiapan ID Terverifikasi Microsoft Entra tingkat lanjut

Penyiapan ID Terverifikasi Tingkat Lanjut adalah cara klasik untuk menyiapkan ID Terverifikasi tempat Anda, sebagai admin, mengonfigurasi berbagai komponen secara manual. Ini termasuk menyiapkan Azure Key Vault, mendaftarkan ID terdesentralisasi Anda, dan memverifikasi domain Anda. Penyiapan tingkat lanjut memberi Anda kontrol penuh atas proses konfigurasi, memastikan bahwa setiap detail memenuhi persyaratan spesifik organisasi Anda. Ini sangat cocok untuk perusahaan yang membutuhkan pengaturan khusus.

Penyiapan tingkat lanjut melibatkan langkah-langkah berikut:

  1. Mengonfigurasi azure Key Vault: Menyimpan dan mengelola kunci yang digunakan untuk menandatangani dan memverifikasi kredensial dengan aman.
  2. Daftarkan ID Terdesentralisasi: Buat dan daftarkan pengidentifikasi terdesentralisasi (DID) Anda untuk menetapkan identitas tepercaya.
  3. VerifikasiDomain : Pastikan domain Anda ditautkan dengan benar ke DID Anda, menyediakan sumber tepercaya untuk kredensial Anda.

Dalam tutorial ini, Anda mempelajari cara:

  • Membuat instans Azure Key Vault.
  • Konfigurasikan Anda adalah layanan ID Terverifikasi menggunakan penyiapan tingkat lanjut.
  • Mendaftarkan aplikasi Klien di Microsoft Entra ID.

Bagan berikut mengilustrasikan arsitektur ID Terverifikasi dan komponen yang Anda konfigurasikan.

Diagram yang menggambarkan arsitektur ID Terverifikasi Microsoft Entra.

Prasyarat

Buat brankas kunci

Catatan

Azure Key Vault yang Anda gunakan untuk menyiapkan layanan ID Terverifikasi harus memiliki Kebijakan Akses Key Vault untuk model Izinnya. Saat ini ada batasan jika Key Vault memiliki kontrol akses berbasis peran Azure

Azure Key Vault adalah layanan cloud yang memungkinkan penyimpanan yang aman dan manajemen akses rahasia dan kunci. Layanan ID Terverifikasi menyimpan kunci publik dan privat di Azure Key Vault. Kunci ini digunakan untuk menandatangani dan memverifikasi kredensial.

Jika Anda tidak memiliki instans Azure Key Vault yang tersedia, ikuti langkah-langkah ini untuk membuat brankas kunci menggunakan portal Microsoft Azure. Azure Key Vault yang Anda gunakan untuk menyiapkan layanan ID Terverifikasi harus memiliki Kebijakan Akses Key Vault sebagai model Izin, bukan kontrol akses berbasis peran Azure.

Catatan

Secara default, akun pembuat vault adalah satu-satunya yang memiliki akses. Layanan ID Terverifikasi memerlukan akses ke brankas kunci. Anda harus mengautentikasi brankas kunci Anda, yang memungkinkan akun yang digunakan selama konfigurasi untuk membuat dan menghapus kunci. Akun yang digunakan selama konfigurasi juga memerlukan izin untuk menandatangani sehingga dapat membuat pengikatan domain untuk ID Terverifikasi. Jika Anda menggunakan akun yang sama saat pengujian, ubah kebijakan default untuk memberikan izin Masuk akun selain izin default yang diberikan kepada pembuat brankas.

Mengelola akses ke brankas kunci

Sebelum Anda dapat menyiapkan ID Terverifikasi, Anda memerlukan akses ke Key Vault . Berikan izin akses ke brankas kunci Anda untuk akun administrator ID Terverifikasi, dan untuk perwakilan API Layanan Permintaan yang Anda buat.

Setelah Anda membuat kubah utama, Kredensial yang Dapat Diverifikasi menghasilkan satu set kunci yang digunakan untuk memberikan keamanan pesan. Kunci ini disimpan dalam brankas kunci. Anda menggunakan set kunci untuk menandatangani kredensial yang dapat diverifikasi.

Menyiapkan ID Terverifikasi

Cuplikan layar yang memperlihatkan cara menyiapkan Kredensial yang Dapat Diverifikasi.

Untuk menyiapkan ID Terverifikasi, ikuti langkah-langkah berikut:

  1. Masuk ke pusat admin Microsoft Entra dengan peran Administrator Kebijakan Autentikasi.

  2. Dari menu sebelah kiri, pilih Gambaran Umum di bawah ID Terverifikasi.

  3. Dari menu tengah, pilih tab Penyetelan lalu pilih Penyiapan Tingkat Lanjut.

  4. Pilih Konfigurasikan pengaturan organisasi

  5. Menyiapkan organisasi Anda dengan memberikan informasi berikut:

    1. Nama organisasi: Masukkan nama untuk mereferensikan bisnis Anda dalam ID Terverifikasi. Pelanggan Anda tidak melihat nama ini.

    2. Domain tepercaya: Masukkan nama domain. Nama yang Anda tentukan ditambahkan ke titik akhir layanan dalam dokumen identitas terdesentralisasi (DID) Anda. Domain inilah yang mengikat DID Anda dengan sesuatu yang nyata sehingga pengguna mungkin tahu tentang bisnis Anda. Microsoft Authenticator dan dompet digital lainnya menggunakan informasi ini untuk memvalidasi bahwa DID ditautkan ke domain Anda. Jika dompet dapat memverifikasi DID, maka akan menampilkan simbol terverifikasi. Jika dompet tidak dapat memverifikasi DID, dompet memberi tahu pengguna bahwa penerbit kredensial adalah organisasi yang tidak dapat divalidasi.

      Penting

      Domain tidak dapat menjadi pengalihan. Jika tidak, DID dan domain tidak dapat ditautkan. Pastikan untuk menggunakan HTTPS untuk domain misalnya . Misalnya: https://did.woodgrove.com. Pastikan juga bahwa Model Izin Key Vault diatur ke Kebijakan Akses Vault.

    3. Brankas kunci: Pilih brankas kunci yang Anda buat sebelumnya.

  6. Pilih Simpan.

    Cuplikan layar yang memperlihatkan cara menyiapkan Kredensial yang Dapat Diverifikasi langkah pertama.

Mendaftarkan aplikasi di ID Microsoft Entra

Aplikasi Anda perlu mendapatkan token akses saat ingin memanggil ID Terverifikasi Microsoft Entra sehingga bisa mengeluarkan atau memverifikasi kredensial. Untuk mendapatkan token akses, Anda harus mendaftarkan aplikasi dan memberikan izin API untuk Layanan Permintaan ID Terverifikasi. Misalnya, gunakan langkah berikut ini untuk aplikasi web:

  1. Masuk ke pusat admin Microsoft Entra dengan izin administrator yang sesuai.

  2. Pilih Microsoft Entra ID.

  3. Di bawah Aplikasi, pilih >.

    Cuplikan layar yang menunjukkan cara memilih pendaftaran aplikasi baru.

  4. Masukkan Nama tampilan aplikasi Anda. Misalnya, verifiable-credentials-app.

  5. Jenis akun yang didukung: Pilih Akun hanya dalam direktori organisasi ini (hanya Direktori Default - Penyewa tunggal)

  6. Pilih Daftar untuk membuat aplikasi.

    Cuplikan layar yang menunjukkan cara mendaftarkan aplikasi kredensial yang dapat diverifikasi.

3.1 Memberikan izin untuk mendapatkan token akses

Pada langkah ini, Anda memberikan izin kepada prinsipal Layanan Permintaan Layanan Kredensial yang Dapat Diverifikasi.

Untuk menambahkan izin yang diperlukan, ikuti langkah berikut:

  1. Tetap berada di halaman detail aplikasi verifiable-credentials-app. Pilih Izin API>Tambahkan izin.

    Cuplikan layar yang menunjukkan cara menambahkan izin ke aplikasi kredensial yang dapat diverifikasi.

  2. Pilih API yang digunakan organisasi saya.

  3. Cari perwakilan layanan Permintaan Layanan Kredensial yang Dapat Diverifikasi dan pilih.

    Cuplikan layar yang menunjukkan cara memilih perwakilan layanan.

  4. Pilih Izin Aplikasi dan perluas VerifiableCredential.Create.Alll.

    Cuplikan layar yang menunjukkan cara memilih izin yang diperlukan.

  5. Pilih Tambahkan izin.

  6. Pilih Beri persetujuan admin untuk <nama penyewa Anda>.

Anda dapat memilih untuk memberikan izin penerbitan dan presentasi secara terpisah jika Anda lebih suka memisahkan cakupan ke aplikasi yang berbeda.

Cuplikan layar yang memperlihatkan cara memilih izin terperinci untuk penerbitan atau presentasi.

Mendaftarkan ID terdesentralisasi dan memverifikasi kepemilikan domain

Setelah Azure Key Vault disiapkan, dan layanan memiliki kunci penandatanganan, Anda harus menyelesaikan langkah 2 dan 3 dalam penyiapan.

Cuplikan layar yang memperlihatkan cara menyiapkan Kredensial yang Dapat Diverifikasi langkah 2 dan 3.

  1. Masuk ke pusat admin Microsoft Entra dengan peran Administrator Kebijakan Autentikasi.
  2. Pilih ID Terverifikasi.
  3. Dari menu kiri, pilih Ringkasan.
  4. Dari menu tengah, pilih Daftarkan ID terdesentralisasi untuk mendaftarkan dokumen DID Anda, sesuai instruksi dalam artikel Cara mendaftarkan ID terdesentralisasi Anda untuk did:web. Anda harus menyelesaikan langkah ini sebelum dapat terus memverifikasi domain Anda.
  5. Dari menu tengah, pilih Verifikasi kepemilikan domain untuk memverifikasi domain Anda, sesuai instruksi dalam artikel Memverifikasi kepemilikan domain ke Pengidentifikasi Terdesentralisasi (DID) Anda

Setelah Anda berhasil menyelesaikan langkah-langkah verifikasi, dan memiliki tanda centang hijau pada ketiga langkah tersebut, Anda siap untuk melanjutkan ke tutorial berikutnya.

Langkah berikutnya