| tipe_halaman | bahasa | produk | keterangan | urlFragment |
|---|
mencicipi | | biru langit | peta biru | aspnetcore | iklan biru |
| Kumpulan sampel yang memperlihatkan cara mengintegrasikan Azure Active Directory dengan Azure Maps. | Sampel AzureMapsAADS |
Sampel Azure Maps & Azure Active Directory
Ini adalah 4 sampel berbeda yang menggunakan AspNetCore C# untuk memulai dengan cepat autentikasi Azure Active Directory ke Azure Maps. Setiap sampel menggunakan protokol autentikasi yang berbeda bergantung pada kebutuhan aplikasi yang didukung oleh Azure AD dan Kontrol Akses Berbasis Peran Azure (RBAC).
Isi
Garis besar isi file repositori. Ini membantu pengguna menavigasi basis kode, membangun konfigurasi, dan aset terkait lainnya.
| Berkas/folder | Keterangan |
|---|
src/ImplicitGrant | Sampel yang digunakan untuk menunjukkan otentikasi pengguna tanpa komponen server. |
src/OpenIdConnect | Sampel menggunakan protokol yang direkomendasikan Microsoft untuk aplikasi web yang aman |
src/ClientGrant | Sampel menunjukkan otentikasi aplikasi tanpa interaksi pengguna. |
.gitignore | Tentukan apa yang harus diabaikan pada waktu penerapan. |
CONTRIBUTING.md | Pedoman untuk berkontribusi pada sampel. |
README.md | Readme awal. |
LICENSE | Lisensi untuk sampel. |
Prasyarat
Sebelum mengunduh sampel ini
- Visual Studio 2019 atau Visual Studio Code dengan ASP.NET dan beban kerja pengembangan web .
- Anda memerlukan Langganan Azure, daftar untuk mendapatkan akun gratis jika perlu.
- SKU gratis untuk Azure Active Directory yang terkait dengan Langganan Azure.
Pengaturan
Di Azure Active Directory, buat pendaftaran aplikasi baru
- Pendaftaran aplikasi ini akan mewakili aplikasi web.
- Setiap sampel spesifik akan menjelaskan langkah-langkah yang diperlukan untuk protokol otentikasi yang berbeda.
- Demi repositori sampel ini, pendaftaran aplikasi yang sama dapat digunakan.
- Untuk produksi, kami merekomendasikan pendaftaran aplikasi yang berbeda untuk setiap aplikasi web. Selain itu, kami sangat menyarankan penggunaan Azure Managed Identity untuk autentikasi non-interaktif apa pun ke Azure Maps. Ini akan menghemat biaya manajemen kredensial.
- Untuk nama tampilan, kita dapat menamainya "WebApp" dan biarkan uri pengalihan kosong untuk saat ini dan ikuti contoh individu
README.md .
Di Portal Azure, buat akun Azure Maps
- Cari "Azure Maps" saat membuat sumber daya baru dan ikuti portal untuk membuat akun baru.
- Setelah akun dibuat, ambil ID Klien Azure Maps dan siapkan sampel spesifik yang ingin Anda jalankan.
- Nilai ini harus digunakan di x-ms-client-id dengan semua permintaan HTTP.
- Jika menggunakan SDK apa pun, tambahkan ke opsi autentikasi (JS).
Menjalankan sampel
- Menjalankan sampel Aplikasi Web didasarkan pada dokumentasi AspNetCore MVC v2.2
- Setelah semua sampel README.md telah dikonfigurasi, Debug (kunci F5) harus membangun dan memulai aplikasi.
- Pastikan untuk menjalankan aplikasi web dengan HTTPS yang dikonfigurasi.
- Jika diminta untuk mengembangkan sertifikat HTTPS melalui IIS atau AspNetCore, terima perintah untuk memercayai sertifikat tersebut.
Konsep-konsep kunci
- Penggunaan Azure Maps Web SDK mendukung 2 pendekatan untuk token akses Azure Active Directory.
- Jika komponen server seperti AspNetCore MVC tersedia untuk aplikasi Anda, kami merekomendasikan OpenID Connect.
- Jika tidak ada komponen server, Anda harus menggunakan pemberian implisit untuk pengalaman masuk interaktif pengguna. Namun, jika tidak ada proses masuk interaktif, beberapa komponen server harus ada untuk mengambil token akses dan menyediakannya ke Azure Maps Web SDK.
- Menggunakan Azure Service Authentication Library akan membantu mengurangi kompleksitas dan biaya manajemen kredensial dan memungkinkan Azure Managed Identities digunakan pada platform yang dihosting seperti Azure Virtual Machines atau Azure App Service.
Berkontribusi
Proyek ini menyambut baik kontribusi dan saran. Sebagian besar kontribusi mengharuskan Anda menyetujui Perjanjian Lisensi Kontributor (CLA) yang menyatakan bahwa Anda berhak, dan memang benar, memberi kami hak untuk menggunakan kontribusi Anda. Untuk detailnya, kunjungi https://cla.opensource.microsoft.com.
Saat Anda mengirimkan permintaan tarik, bot CLA akan secara otomatis menentukan apakah Anda perlu memberikan CLA dan menghiasi PR dengan tepat (misalnya, pemeriksaan status, komentar). Cukup ikuti instruksi yang diberikan oleh bot. Anda hanya perlu melakukan ini sekali di seluruh repo menggunakan CLA kami.
Proyek ini telah mengadopsi Kode Etik Sumber Terbuka Microsoft. Untuk informasi lebih lanjut lihat FAQ Pedoman Perilaku atau hubungi [email protected] jika ada pertanyaan atau komentar tambahan.
