| page_type | اللغات | منتجات | وصف | urlFragment |
|---|
عينة | | أزور | خرائط أزور | com.aspnetcore | إعلان أزوري |
| مجموعة من العينات توضح كيفية تكامل Azure Active Directory مع خرائط Azure. | AzureMapsAADSamples |
خرائط Azure وعينات Azure Active Directory
هذه 4 نماذج مختلفة تستخدم AspNetCore C# لبدء مصادقة Azure AD بسرعة على خرائط Azure. تستخدم كل عينة بروتوكولات مصادقة مختلفة بناءً على حاجة التطبيق والتي يدعمها Azure AD والتحكم في الوصول المستند إلى دور Azure (RBAC).
محتويات
الخطوط العريضة لمحتويات الملف من المستودع. فهو يساعد المستخدمين على التنقل في قاعدة التعليمات البرمجية وإنشاء التكوين وأي أصول ذات صلة.
| ملف/مجلد | وصف |
|---|
src/ImplicitGrant | العينات المستخدمة لإظهار مصادقة المستخدم بدون مكون الخادم. |
src/OpenIdConnect | عينات تستخدم البروتوكول الموصى به من Microsoft لتطبيقات الويب الآمنة |
src/ClientGrant | نماذج توضح مصادقة التطبيق دون تدخل المستخدم. |
.gitignore | حدد ما يجب تجاهله في وقت الالتزام. |
CONTRIBUTING.md | المبادئ التوجيهية للمساهمة في العينة. |
README.md | التمهيدي البداية. |
LICENSE | الترخيص للعينة. |
المتطلبات الأساسية
قبل تنزيل هذه العينات
- Visual Studio 2019 أو Visual Studio Code مع ASP.NET وعبء عمل تطوير الويب .
- ستحتاج إلى اشتراك Azure، قم بالتسجيل للحصول على حساب مجاني إذا لزم الأمر.
- SKU مجاني لـ Azure Active Directory المرتبط باشتراك Azure.
يثبت
في Azure Active Directory، قم بإنشاء تسجيل تطبيق جديد
- سيمثل تسجيل التطبيق هذا تطبيق (تطبيقات) الويب.
- ستصف كل عينة محددة الخطوات اللازمة لبروتوكولات المصادقة المختلفة.
- من أجل مستودع العينات هذا، يمكن استخدام نفس تسجيل التطبيق .
- بالنسبة للإنتاج، نوصي بتسجيل تطبيق منفصل لكل تطبيق ويب. بالإضافة إلى ذلك، نوصي بشدة باستخدام Azure Managed Identity لأي مصادقة غير تفاعلية لخرائط Azure. سيؤدي هذا إلى توفير تكاليف إدارة بيانات الاعتماد.
- بالنسبة لاسم العرض، يمكننا تسميته "WebApp" وترك معرف إعادة التوجيه فارغًا في الوقت الحالي واتباع عينات الأفراد
README.md .
في Azure Portal، قم بإنشاء حساب Azure Maps
- ابحث عن "Azure Maps" عند إنشاء مورد جديد واتبع البوابة الإلكترونية لإنشاء حساب جديد.
- بمجرد إنشاء الحساب، استرجع معرف عميل Azure Maps واحتفظ بالعينة المحددة التي ترغب في تشغيلها.
- يجب استخدام هذه القيمة في معرف x-ms-client-id مع جميع طلبات HTTP.
- في حالة استخدام أي SDK، قم بإضافته إلى خيارات المصادقة (JS).
تشغيل العينة
- يعتمد تشغيل نماذج Web Applicaton على وثائق AspNetCore MVC v2.2
- بمجرد تكوين كافة نماذج README.md الفردية، يجب أن يقوم Debug (مفتاح F5) بإنشاء التطبيق وبدء تشغيله.
- تأكد من تشغيل تطبيق الويب مع تكوين HTTPS.
- إذا طُلب منك تطوير شهادة HTTPS عبر IIS أو AspNetCore، فاقبل المطالبة بالوثوق في الشهادة.
المفاهيم الأساسية
- يدعم استخدام Azure Maps Web SDK طريقتين للرموز المميزة للوصول إلى Azure AD.
- إذا كان مكون الخادم مثل AspNetCore MVC متاحًا لتطبيقك، فإننا نوصي باستخدام OpenID Connect.
- في حالة عدم وجود مكون خادم، يجب عليك استخدام المنحة الضمنية لتجربة تسجيل الدخول التفاعلية للمستخدم. ومع ذلك، في حالة عدم تسجيل الدخول التفاعلي، يجب أن يكون بعض مكونات الخادم موجودًا لاسترداد رمز الوصول وتوفيره إلى Azure Maps Web SDK.
- سيساعد استخدام مكتبة مصادقة خدمة Azure على تقليل تعقيد وتكلفة إدارة بيانات الاعتماد والسماح باستخدام هويات Azure المُدارة على النظام الأساسي المستضاف مثل Azure Virtual Machines أو Azure App Service.
المساهمة
يرحب هذا المشروع بالمساهمات والاقتراحات. تتطلب معظم المساهمات منك الموافقة على اتفاقية ترخيص المساهم (CLA) التي تعلن أن لديك الحق في منحنا حقوق استخدام مساهمتك، بل وتفعل ذلك بالفعل. للحصول على التفاصيل، تفضل بزيارة https://cla.opensource.microsoft.com.
عند إرسال طلب سحب، سيحدد روبوت CLA تلقائيًا ما إذا كنت بحاجة إلى تقديم CLA وتزيين العلاقات العامة بشكل مناسب (على سبيل المثال، التحقق من الحالة، التعليق). ما عليك سوى اتباع التعليمات التي يقدمها لك الروبوت. سوف تحتاج إلى القيام بذلك مرة واحدة فقط عبر جميع اتفاقيات إعادة الشراء باستخدام CLA الخاصة بنا.
اعتمد هذا المشروع قواعد السلوك الخاصة بشركة Microsoft مفتوحة المصدر. لمزيد من المعلومات، راجع الأسئلة الشائعة حول قواعد السلوك أو اتصل بـ [email protected] لطرح أي أسئلة أو تعليقات إضافية.
