تسريع سير العمل: لماذا تتفوق أنفاق التطوير في Visual Studio على النشر التقليدي

By Mirko Peters · 2026-08-12

أهلاً بكم مجدداً في البودكاست! إذا سبق أن انتظرتم خمس عشرة دقيقة حتى يكتمل نشر على السحابة فقط لاختبار سطر واحد من التعديلات البرمجية، فأنتم تعرفون مقدار الإعاقة التي يسببها ذلك لإنتاجيتكم.

Automatically translated with AI from the original post. Read the English original

أهلاً بكم مجدداً في البودكاست! إذا سبق أن انتظرتم خمس عشرة دقيقة حتى يكتمل نشر على السحابة فقط لاختبار سطر واحد من التعديلات البرمجية، فأنتم تعرفون تماماً مقدار الإعاقة التي يسببها ذلك لإنتاجيتكم. اليوم نتوسع في موضوع غيّر بالكامل طريقة فرق الهندسة لدينا في الاختبار المحلي والتصحيح والتكاملات. لا تفوتوا الحلقة ذات الصلة، Test Microsoft 365 Apps with Visual Studio Dev Tunnels، حيث نفصّل هذه المسارات العملية أثناء التطبيق.

في هذا الدليل الشامل سنستعرض لماذا تفقد أساليب النشر التقليدية أرضها أمام حلول الأنفاق الحديثة، وكيف تعمل أنفاق التطوير في Visual Studio من الداخل، وكيف يمكنكم دمجها بسلاسة في مشاريعكم في Microsoft 365 وTeams وASP.NET Core.

الاختبار المحلي باستخدام أنفاق التطوير في Visual Studio

لماذا يهم الاختبار المحلي

تريدون أن تعمل تطبيقات Microsoft 365 الخاصة بكم بشكل مثالي قبل مشاركتها مع المستخدمين. يمنحكم الاختبار المحلي القدرة على اكتشاف الأخطاء مبكراً ورؤية سلوك الشيفرة في بيئة آمنة. عند الاختبار محلياً يمكنكم إجراء التعديلات بسرعة ورؤية النتائج فوراً. تختصر هذه العملية الوقت وتساعد على تجنب الأخطاء التي قد تظهر في بيئة الإنتاج.

للاختبار التقليدي على localhost حدود واضحة. فجهازكم المحلي لا يستقبل اتصالات من الإنترنت. ولذلك يصعب اختبار الميزات التي تحتاج إلى وصول حقيقي من العالم الخارجي، مثل خطافات الويب (Webhooks) وتدفقات المصادقة والتكامل مع خدمات Microsoft 365. قد تجدون أنفسكم عالقين، غير قادرين على محاكاة سلوك تطبيقكم مع المستخدمين الفعليين.

Dev Tunnels قد غيّر طريقة تطوير تطبيقات الويب واختبارها، خاصةً بالنسبة إلى مطوّري التطبيقات المحمولة الذين غالبًا ما يواجهون تحديات في إعداد الخوادم المحلية للاختبار. إنها ميزة تُحدث فرقًا حقيقيًا، إذ تعزّز التعاون وتبسّط عملية التطوير.

مع الأدوات المناسبة يمكنكم تجاوز هذه التحديات. يمكنكم إنشاء بيئة واقعية لتطبيقكم حتى وأنتم تعملون من حاسوبكم الشخصي.

كيف تتيح Dev Tunnels الاختبار المحلي

يمكنكم اختبار تطبيقات Microsoft 365 من localhost باستخدام أنفاق التطوير في Visual Studio. توفر لكم هذه الأداة طريقة آمنة لإتاحة خدماتكم المحلية للإنترنت. ولا حاجة إلى نشر شيفرتكم على Azure أو أي منصة سحابية أخرى فقط لمعرفة كيفية عملها مع Microsoft 365.

تعزز أنفاق التطوير في Visual Studio اختبار localhost التقليدي من خلال تمكينكم من إتاحة تطبيقاتكم المحلية للإنترنت بشكل آمن. تسمح هذه القدرة بالاتصالات الواردة، وهي ضرورية لاختبار تطبيقات Microsoft 365 في بيئة أقرب إلى الواقع، متجاوزة قيود الاقتصار على الاختبار المحلي.

إليكم كيف تحسّن أنفاق التطوير سرعة الاختبار المحلي وأمانه:

• تمكّن أنفاق التطوير الخدمات المحلية من العمل كـ نقاط نهاية سحابية آمنة في أقل من 3 دقائق.
• كما تتيح وصولاً آمناً عبر الإنترنت لاختبار تطبيقات Microsoft 365 محلياً.
• الإعداد الصحيح أمر بالغ الأهمية لتجنب كشف بيئة التطوير.

يمكنكم إعداد الأنفاق بنقرات أو أوامر قليلة. تختارون اسم النفق ومستوى ظهوره، فتتحكمون في من يمكنه الوصول إلى تطبيقكم. ويمكنكم استخدام المصادقة للحفاظ على أمان عملكم. تتيح هذه المرونة التعاون مع زملائكم أو دعوة المختبرين دون مشاركة حاسوبكم بالكامل.

تتيح لكم Dev Tunnels اختبار ميزات مثل مصادقة OAuth وروبوتات Teams أو أجزاء صفحات SharePoint كما لو كانت تعمل في السحابة. تحصلون على ملاحظات فورية ويمكنكم تصحيح المشكلات في الحال. تجعل هذه العملية دورة التطوير لديكم أسرع وأكثر موثوقية.

عندما تستخدم أنفاق التطوير (dev tunnels)، تبني ثقةً أكبر في الشيفرة قبل النشر. تتأكد من أن تطبيقك يعمل في البيئة الفعلية، لا على جهازك فقط.

نظرة عامة على أنفاق التطوير في Visual Studio

الميزات الرئيسية

تمنحك أنفاق التطوير في Visual Studio طريقةً قوية لاختبار تطبيقات Microsoft 365 وتصحيح أخطائها من جهازك المحلي. يمكنك إتاحة خدمات ASP.NET Core للإنترنت بخطوات قليلة فقط. تساعدك هذه الأداة على إنشاء بيئة تطوير آمنة ومرنة.

إليك أهم الميزات التي ستجدها مفيدة:

• يمكنك كشف واجهات برمجة التطبيقات المحلية باستخدام عناوين URL بعيدة، مما يسهّل اختبار مشاريع ASP.NET Core وتصحيح أخطائها.
• يصبح التكامل مع الخدمات الخارجية أمرًا بسيطًا لأن لديك عناوين URL متاحة للعامة لتطبيقاتك المحلية.
• يمكنك تعيين نقاط توقف على localhost ومراقبة استجابة شيفرة ASP.NET Core عند الوصول إلى عناوين URL البعيدة.
• تساعدك الأنفاق المسماة على مشاركة مشاريع أو خدمات محددة دون لبس.
• تتيح لك الأنفاق الدائمة الحفاظ على الوصول عبر الزمن، وهو أمر مهم للمشاريع المستمرة في ASP.NET Core.
• يمكنك اختيار مستويات الوصول للأنفاق: خاصة أو تنظيمية أو عامة. يجعل ذلك التحكم في من يرى عملك أمرًا سهلًا.
• تقصر المصادقة عبر Entra ID الوصول على المستخدمين الذين يملكون بيانات اعتماد صالحة، فتبقى بياناتك آمنة.
• تتيح لك واجهة سطر الأوامر (CLI) إدارة الأنفاق وأتمتتها، بما في ذلك إنشاؤها وضبطها. يمكنك استخدام الأوامر لإنشاء الأنفاق وعرضها ووضع وسوم عليها لتسهيل إدارتها.

نصيحة: تساعدك الأنفاق الدائمة والمسماة على تجنب إعادة إنشاء الأنفاق في كل مرة تعيد فيها تشغيل مشروع ASP.NET Core. هذا يوفر وقتك ويقلل الأخطاء.

كيف تعمل أنفاق التطوير

تنشئ أنفاق التطوير جسرًا آمنًا بين خادم ASP.NET Core المحلي والإنترنت. يمكنك اختبار تطبيقات Microsoft 365 وكأنها تعمل في بيئة إنتاجية فعلية.

نقاط نهاية عامة آمنة

تبدأ بتنزيل واجهة devtunnel لسطر الأوامر وتثبيتها. بعد تسجيل الدخول باستخدام حسابك في Entra ID أو Microsoft أو GitHub، تشغّل خادم ASP.NET Core المحلي. ثم تستضيف نفقًا أو تنشئه باستخدام الأمر devtunnel host –p PORT. إذا أردت عنوان URL دائمًا، فاستخدم الأمر devtunnel create لإنشاء نفق دائم.

تمنحك هذه العملية نقطة نهاية آمنة وقابلة للوصول عبر الإنترنت لخدمة ASP.NET Core المحلية. يمكنك الآن اختبار webhooks وتدفقات المصادقة والتكاملات التي تتطلب عناوين URL عامة. تضمن المصادقة عبر Entra ID أن المستخدمين المعتمدين فقط يمكنهم الوصول إلى أنفاقك، مما يقلل من خطر كشف البيانات عن طريق الخطأ.

التكامل مع Visual Studio وواجهة سطر الأوامر

يجعل Visual Studio إنشاء أنفاق التطوire وإدارتها أمرًا سهلًا. يمكنك إعداد نفق بنقرات قليلة داخل بيئة التطوير المتكاملة (IDE). تقدم واجهة سطر الأوامر خيارات أكثر، مثل الأنفاق ذات العمر الثابت والوسوم لتنظيم أفضل. يمكنك أتمتة إنشاء الأنفاق لمشاريع ASP.NET Core، مما يجعل سير عملك أسرع وأكثر موثوقية.

يمكنك أيضًا عرض جميع أنفاقك، والاطلاع على تفاصيلها، وإدارة أذونات الوصول. تساعدك هذه المرونة على التعاون مع فريقك والحفاظ على أمان بيئة التطوير لديك.

ملاحظة: صُممت أنفاق التطوير لكشف نقاط نهاية ASP.NET Core المحلية بأمان للإنترنت، مما يجعل الاختبار وتصحيح الأخطاء آمنين وفعّالين.

استضافة نفق أو إنشاؤه في Visual Studio

المتطلبات الأساسية والإعداد

قبل أن تستضيف نفقًا أو تنشئه لاختبار تطبيقات Microsoft 365، تحتاج إلى تجهيز بيئتك. يوفر لك Visual Studio الأدوات اللازمة، لكن عليك استيفاء بعض المتطلبات أولًا. يعرض الجدول التالي ما تحتاجه للبدء:

ينبغي أن تتحقق من امتلاك الإصدار الصحيح من Visual Studio. افتح برنامج التثبيت وتأكّد من أن حِمل العمل ASP.NET and web development مفعّل. سجّل الدخول بحسابك في Microsoft للوصول إلى نافذة أداة أنفاق التطوير. إذا كنت تخطط لربط مشروع ASP.NET Core بـ Power Platform، فتأكّد من أن لديك حق الوصول إلى Power Automate أو Power Apps.

نصيحة: إبقاء أدواتك محدَّثة يساعدك على تجنب مشكلات الإعداد، ويضمن لك استخدام أحدث الميزات في نافذة أداة أنفاق التطوير.

إنشاء النفق وتسميته

يمكنك إنشاء نفق مباشرةً من نافذة أداة أنفاق التطوير في Visual Studio. تتيح لك هذه العملية كشف خدمة ASP.NET Core الخاصة بك للإنترنت لاختبار تطبيق Microsoft 365. اتبع الخطوات التالية لإنشاء النفق وتسميته:

1. في القائمة المنسدلة Debug، اختر Dev Tunnels > Create A Tunnel.
2. تفتح نافذة أداة أنفاق التطوير مربع حوار. اختر الحساب الذي تريد استخدامه.
3. أدخل اسمًا للنفق. يساعدك هذا الاسم على تمييزه في نافذة أداة أنفاق التطوير.
4. اختر نوع النفق. حدّد Persistent إذا أردت العنوان نفسه في كل مرة، أو Temporary للحصول على عنوان جديد في كل جلسة.
5. اختر نوع المصادقة: Private أو Organization أو Public.
6. انقر OK لإنشاء النفق.

عند إنشاء النفق، تسهّل على نفسك ربط مشروع ASP.NET Core بخدمات Microsoft 365. تحافظ نافذة أداة أنفاق التطوير على تنظيم أنفاقك وظهورها. يمكنك دائمًا العثور على أنفاقك النشطة وإدارتها من هذه النافذة.

ملاحظة: تسمية النفق تساعدك وفريقك على متابعة خدمة ASP.NET Core المكشوفة. استخدم أسماءً واضحة لكل نفق في نافذة أداة أنفاق التطوير.

تحديد ظهور النفق

تحدد ضوابط ظهور النفق مَن يمكنه الوصول إلى أنفاق التطوير الخاصة بك. تضبط هذا الخيار في نافذة أداة أنفاق التطوير عند إنشاء النفق. ومستوى الظهور المناسب يحمي عملك ويدعم التعاون.

إليك خيارات الظهور الرئيسية:

يمكنك أيضًا الاطلاع على هذه الخيارات بوصفها:

• Private: أنت وحدك من يمكنه استخدام النفق.
• Organization: يمكن لفريقك أو شركتك استخدام النفق.
• Public: يمكن لأي شخص استخدام النفق.

تتيح لك نافذة أداة أنفاق التطوير تغيير الظهور عند إنشاء أنفاق التطوير وإدارتها. اختيار الظهور المناسب يساعدك على مراقبة حركة المرور والحفاظ على أمان تطبيق Microsoft 365 الخاص بك. تعمل الأنفاق Private بشكل أفضل في التطوير الفردي. وتساعد أنفاق Organization الفرق على الاختبار معًا. أما أنفاق Public فتتيح للمختبرين من خارج المؤسسة الوصول، لكنها تتطلب عناية إضافية.

تنبيه: لا تتطلب الأنفاق Public مصادقة. استخدمها فقط عندما تحتاج إلى مشاركة تطبيقك مع مستخدمين من خارج مؤسستك، وراقب الوصول دائمًا في نافذة أداة أنفاق التطوير.

يؤثر ظهور النفق في كلٍّ من الأمان والتعاون. فعندما تختار المستوى المناسب، تتأكد من أن الأشخاص الصحيحين فقط يمكنهم الوصول إلى تطبيقك. هذا يقلل المخاطر ويساعد فريقك على العمل معًا بسلاسة.

استخدام واجهة سطر الأوامر لأنفاق التطوير (Dev Tunnels CLI)

يمكنك إدارة أنفاق التطوير مباشرةً من سطر الأوامر باستخدام Dev Tunnels CLI. توفّر لك هذه الأداة مرونة وسرعة، خاصةً عندما تريد أتمتة سير عملك أو العمل خارج واجهة Visual Studio. تعمل واجهة سطر الأوامر جيدًا سواء للاختبارات السريعة أو للإعدادات الأكثر تقدمًا.

للبدء، تحتاج إلى تثبيت Dev Tunnels CLI. يمكنك ذلك بتشغيل الأمر التالي في الطرفية:

dotnet tool install -g Microsoft.DevTunnels.Cli

بعد التثبيت، يجب عليك تسجيل الدخول. استخدم حسابك في Microsoft أو Entra ID أو حساب GitHub. تربط هذه الخطوة جلسة واجهة سطر الأوامر ببيئة Visual Studio وتضمن وصولًا آمنًا.

devtunnel login

بعد تسجيل الدخول، يمكنك إنشاء الأنفاق وإدارتها. إليك طريقة بسيطة لإنشاء نفق لمشروعك المحلي:

devtunnel host -p 5000

يكشف هذا الأمر الخدمة المحلية التي تعمل على المنفذ 5000 للإنترنت. ستعرض واجهة سطر الأوامر عنوان URL عامًا يمكنك استخدامه لاختبار تطبيق Microsoft 365 الخاص بك. يمكنك مشاركة هذا العنوان مع فريقك أو استخدامه لاختبار التكامل.

إذا كنت تريد نفقًا دائمًا باسم مخصص، فاستخدم الأمر التالي:

devtunnel create my-tunnel --persistent
devtunnel host my-tunnel -p 5000

يساعدك هذا الأسلوب على الاحتفاظ بالعنوان نفسه عبر الجلسات، وهو أمر مهم لمعاملات إعادة توجيه OAuth ولإجراء اختبارات متسقة. كما يمكنك ضبط رؤية النفق مباشرةً من سطر الأوامر. على سبيل المثال، لجعل النفق متاحًا لمؤسستك فقط، أضف العلامة --access organization:

devtunnel create my-tunnel --persistent --access organization

نصيحة: استخدم أسماء واضحة ووصفية لأنفاقك. فهذا يسهّل إدارة عدة مشاريع في Visual Studio ويتجنب الالتباس.

يمكنك عرض جميع الأنفاق النشطة لديك في أي وقت:

devtunnel list

لإيقاف نفق، استخدم الأمر التالي:

devtunnel close my-tunnel

تتيح لك واجهة سطر الأوامر أيضًا أتمتة إنشاء الأنفاق في النصوص البرمجية. هذه الميزة مفيدة عندما تريد إعداد Dev Tunnels ضمن عملية البناء أو النشر. كما يمكنك مشاركة أوامر سطر الأوامر مع فريقك ليستخدم الجميع الإعدادات نفسها، مما يحسّن الاتساق ويقلل الأخطاء.

ملاحظة: تعمل Dev Tunnels CLI بسلاسة مع Visual Studio. يمكنك التبديل بين سطر الأوامر وواجهة Visual Studio دون فقدان إعدادات النفق.

بإتقان Dev Tunnels CLI، تكتسب مزيدًا من التحكم في بيئة التطوير لديك. يمكنك إنشاء الأنفاق وإدارتها وتأمينها بسرعة لأي مشروع تطبيقات Microsoft 365. تمنحك هذه المرونة القدرة على اختبار التطبيقات وتصحيح أخطائها بكفاءة، سواء عملت بمفردك أو ضمن فريق.

تهيئة تطبيقات Microsoft 365 لاستخدام Dev Tunnels

تحديث تسجيل التطبيق وعناوين إعادة التوجيه URI

تحتاج إلى تحديث تسجيل التطبيق وعناوين إعادة التوجيه URI لربط مشروع ASP.NET Core المحلي بخدمات Microsoft 365 عبر Visual Studio. تساعد هذه العملية تطبيقك على استخدام نقطة النهاية الآمنة التي توفرها Dev Tunnels. إليك طريقة مبسطة لإعداد تسجيل التطبيق:

1. افتح بوابة Microsoft Entra ID – App Registrations.
2. اختر "New Registration" وأدخل اسم التطبيق.
3. اختر أنواع الحسابات المدعومة لتطبيقك.
4. اترك حقل Redirect URI فارغًا في الوقت الحالي.
5. انقر على "Register" لإنشاء التطبيق.
6. في صفحة النظرة العامة، انسخ معرّف التطبيق (client) ID ومعرّف الدليل (tenant) ID.
7. ضمن "Manage"، اختر "Expose an API".
8. انقر على الرابط "Set" لإنشاء معرّف URI للتطبيق (Application ID URI).
9. أضف نطاقًا باسم "access_as_user".
10. اضبط خيار "من يمكنه الموافقة؟" على "المسؤولون والمستخدمون."
11. املأ مطالبات الموافقة للمسؤول والمستخدم.
12. تأكد من أن الحالة مضبوطة على "Enabled".
13. اختر "Add scope" لإنهاء العملية.

بعد إنشاء النفق في Visual Studio، تحتاج إلى تحديث Redirect URI في تسجيل التطبيق. استخدم عنوان URL العام من نفق ASP.NET Core كعنوان Redirect URI. تُخبر هذه الخطوة Microsoft 365 إلى أين ترسل استجابات المصادقة أثناء الاختبار.

نصيحة: احفظ دائمًا معرّف العميل (client ID) ومعرّف المستأجر (tenant ID). ستحتاج إليهما للمصادقة وإعداد OAuth.

الاتصال بـ Teams وSharePoint وتطبيقات Power Platform

يمكنك استخدام Visual Studio لربط خدمات ASP.NET Core بـ Teams وSharePoint وتطبيقات Power Platform. تجعل Dev Tunnels هذه العملية آمنة وبسيطة. عند استخدام الأنفاق، تتلقى تنبيهات إذا اتصلت بنقطة نهاية نفق. تساعدك هذه التنبيهات على تجنب هجمات التصيد واحتمال مشاركة عناوين URL حساسة عن غير قصد.

• تستخدم روبوتات Teams وإضافات الرسائل أنفاق Dev Tunnels افتراضيًا للتطوير المحلي. يوفر لك هذا الإعداد طريقة آمنة لاختبار الميزات قبل نشرها.
• تستفيد أدوات Web Parts في SharePoint والموصلات في Power Platform أيضًا من نقاط النهاية الآمنة. يمكنك اختبار Webhooks والمصادقة وتدفقات البيانات في سيناريو واقعي.
• تضيف مصادقة الهوية في Microsoft 365 طبقة أمان إضافية. يجب أن تسجّل الدخول بحساب Microsoft 365 الخاص بك لإنشاء الأنفاق وإدارتها في Visual Studio.

ملاحظة: يساعدك الوعي المعزز بالأمان أنت وفريقك على البقاء آمنين أثناء اختبار تطبيقات ASP.NET Core.

معالجة المصادقة وOAuth

يجب عليك تهيئة المصادقة وOAuth لتمكين تطبيقات Microsoft 365 من العمل مع Dev Tunnels. إليك دليل خطوة بخطوة:

1. سجّل تطبيقك في بوابة Microsoft Entra ID.
2. اضبط معرّف URI للتطبيق ليطابق نقطة نهاية النفق من Visual Studio.
3. أنشئ سرًا للعميل (client secret) لتبادل الرموز المميزة.
4. أضف أذونات واجهة برمجة التطبيقات للوصول إلى Microsoft Graph.
5. حدّث Redirect URIs لاستخدام عنوان نفق ASP.NET Core الخاص بك.
6. أعدّ Dev Tunnels لاستضافة خدمتك المحلية.
7. استنسخ مستودع مشروعك وحدّث ملفات الإعداد ببيانات التطبيق الخاص بك: معرّف العميل (client ID) ومعرّف المستأجر (tenant ID) والسر (secret).
8. افتح Visual Studio وشغّل مشروع ASP.NET Core الخاص بك.

يتيح لك هذا الإعداد أن يتولى تطبيقك تسجيل الدخول وتبادل الرموز المميزة (token) واستدعاءات واجهات برمجة التطبيقات بشكل آمن. يمكنك اختبار تدفقات المصادقة، مثل OAuth، في بيئة آمنة قبل الانتقال إلى الإنتاج.

تحقّق دائمًا مرتين من عناوين إعادة التوجيه (Redirect URIs) والأذونات. تمنع هذه الخطوة أخطاء المصادقة الشائعة وتحافظ على أمان اختباراتك.

الأمان وأفضل الممارسات

خيارات رؤية النفق

أنت تتحكم في من يمكنه الوصول إلى بيئة التطوير الخاصة بك من خلال ضبط رؤية النفق. عند إنشاء نفق، تختار بين الوصول الخاص أو التنظيمي أو العام. تسمح الأنفاق الخاصة بالاتصال بك وحدك. تتيح الأنفاق التنظيمية لأي شخص في شركتك استخدام النفق. تفتح الأنفاق العامة الوصول لأي شخص يملك الرابط. اختر دائمًا أدنى مستوى رؤية يحتاجه مشروعك.

لتعظيم الأمان أثناء اختبار تطبيق Microsoft 365، اتبع أفضل الممارسات التالية:

• اضبط الأنفاق على الخاص أو التنظيمي كلما أمكن ذلك.
• طبّق التقسيم النفقي (split tunneling) لتطبيقات Office 365. تحسّن هذه الطريقة الأداء وتحافظ على أمان بياناتك.
• استخدم نطاقات عناوين IP التي توفرها Microsoft للتقسيم النفقي. وتجنّب استخدام أسماء النطاقات المؤهلة بالكامل (FQDN).
• عطّل اعتراض SSL لحركة مرور Office 365. تساعدك هذه الخطوة على الالتزام بتوصيات Microsoft الأمنية.
• تأكد من أن سياسة التقسيم النفقي تعمل بشكل صحيح باستخدام أداة اختبار الاتصال بـ Microsoft 365.
• أوقف ميزة SSL Break and Inspect لنطاقات Office 365.

نصيحة: راجع إعدادات رؤية النفق قبل مشاركة أي عناوين URL. تساعد هذه العادة على منع الكشف غير المقصود عن بيئة التطوير الخاصة بك.

تأمين الوصول باستخدام Entra ID

يمكنك تأمين الأنفاق بفرض المصادقة عبر Entra ID. تضمن هذه الميزة أن يتمكن المستخدمون المعتمدون فقط من الوصول إلى خدماتك المحلية. عند تفعيل مصادقة Entra ID، فإنك تضيف طبقة حماية قوية إلى أنفاق التطوير الخاصة بك. لا يمكن إلا للمستخدمين الذين يملكون بيانات اعتماد صالحة الاتصال، مما يساعد على حماية بياناتك.

يدعم Entra ID أيضًا الوصول التنظيمي. يمكنك السماح لفريقك بأكمله باختبار التطبيقات وتصحيح أخطائها دون فتح النفق للعامة. يحقق هذا النهج توازنًا بين الأمان والتعاون. استخدم مصادقة Entra ID دائمًا في المشاريع الحساسة أو عند التعامل مع معلومات سرية.

ملاحظة: تعمل مصادقة Entra ID بسلاسة مع واجهة Visual Studio وأدوات سطر الأوامر على حد سواء.

مراقبة الأنفاق وإدارتها

تحتاج إلى مراقبة أنفاقك وإدارتها للحفاظ على سير عمل آمن وفعّال. يوفّر Visual Studio ميزات مدمجة لإدارة أنفاق التطوير. يمكنك عرض الأنفاق النشطة والتحقق من حالتها وتعديل إعدادات الوصول من داخل بيئة التطوير المتكاملة (IDE). كما تتيح واجهة سطر الأوامر إنشاء الأنفاق وعرضها وإغلاقها بسرعة.

تشمل أفضل الممارسات لإدارة الأنفاق ما يلي:

• راجع قائمة الأنفاق النشطة لديك بشكل منتظم.
• أغلق الأنفاق عند الانتهاء من الاختبار لتقليل المخاطر الأمنية.
• استخدم أسماءً وصفية لكل نفق لتجنب الالتباس.
• اختر بين الأنفاق المؤقتة أو الدائمة وفقًا لاحتياجات مشروعك.
• اضبط ضوابط الوصول بما يتوافق مع متطلباتك الأمنية.

يمكن للجدول التالي أن يساعدك في مقارنة خيارات إدارة الأنفاق:

تذكير: تحافظ الإدارة الجيدة للأنفاق على تنظيم بيئة التطوير الخاصة بك وأمانها.

الأخطاء الشائعة التي ينبغي تجنّبها

عند استخدام Visual Studio Dev Tunnels لاختبار تطبيق Microsoft 365، ينبغي تجنّب الأخطاء التي قد تبطئ عملك أو تعرّض مشروعك للخطر. يقع كثير من المطورين في المشكلات نفسها. فإذا عرفت ما يجب الانتباه إليه، يمكنك توفير الوقت والحفاظ على أمان بيئتك.

1. اختيار رؤية نفق خاطئة

قد تختار نفقًا عامًا لتسهيل الأمر، لكن هذا الخيار قد يُعرّض تطبيقك لكل من يملك الرابط. تحقّق دائمًا من مستوى الظهور لنفق التوجيه قبل أن تبدأ الاختبار. استخدم الأنفاق الخاصة أو الخاصة بالمؤسسة في معظم المشاريع. لا تستخدم الأنفاق العامة إلا عندما تحتاج إلى مختبرين من خارج المؤسسة، ويجب أن تراقب الوصول دائمًا في هذه الحالة.

نصيحة: راجع إعدادات النفق قبل مشاركة الروابط مع فريقك أو المختبرين.

2. نسيان تحديث معرّفات URI لإعادة التوجيه

إذا غيّرت عنوان URL للنفق، فيجب عليك تحديث معرّفات URI لإعادة التوجيه في تسجيل التطبيق الخاص بك. إذا تجاهلت هذه الخطوة، فستفشل المصادقة. تأكد دائمًا من أن تسجيل التطبيق يطابق نقطة نهاية النفق الحالية لديك.

3. تجاهل إعدادات المصادقة

قد تنسى تفعيل مصادقة Entra ID للنفق الخاص بك. بدون ذلك، يمكن لأي شخص يملك الرابط الوصول إلى الخدمة المحلية لديك. اشترط دائمًا المصادقة للمشاريع الحساسة. تحمي هذه الخطوة بياناتك ومستخدميك.

4. ترك الأنفاق مفتوحة بعد الاختبار

إذا تركت الأنفاق تعمل بعد الانتهاء، فأنت تزيد من مخاطر الأمان. يمكن أن تتحول الأنفاق غير المستخدمة إلى أهداف للوصول غير المرغوب فيه. أغلق الأنفاق دائمًا عندما لا تحتاج إليها.

5. استخدام أسماء أنفاق عامة أو مربكة

إذا استخدمت أسماء غير واضحة للأنفاق، فقد تحدث حالة من الالتباس لك ولفريقك. استخدم أسماءً وصفية تطابق المشروع أو الخدمة لديك. تساعدك هذه العادة على إدارة الأنفاق المتعددة وتجنّب الأخطاء.

6. إغفال مراقبة السجلات

قد لا تراجع سجلات الأنفاق الخاصة بك. تساعدك السجلات على رصد النشاط غير المعتاد أو الوصول غير المصرّح به. اجعل مراجعة السجلات بانتظام عادة ثابتة لديك.

ملاحظة: يمكنك تجنّب معظم المشكلات باتباع قائمة تحقق قبل كل جلسة اختبار وبعدها.

بالبقاء منتبهًا لهذه الأخطاء الشائعة، تحافظ على سلاسة عملية التطوير وعلى أمان تطبيقات Microsoft 365 لديك. تبني عادات أفضل وتساعد فريقك على تفادي مشكلات غير ضرورية.

استكشاف الأخطاء وإصلاحها ونصائح متقدمة

تشخيص مشكلات الاتصال

قد تواجه أحيانًا مشكلات في الاتصال عند العمل مع الأنفاق. ابدأ بالتحقق من أن الخدمة المحلية تعمل وتستمع على المنفذ الصحيح. استخدم سطر الأوامر للتأكد من أن الخدمة تستجيب للطلبات. إذا ظهرت أخطاء، فأعد تشغيل الخدمة وحاول مرة أخرى.

ثم تحقّق من إعدادات جدار الحماية. قد يحظر جدار الحماية الاتصالات الواردة. اسمح بحركة المرور على المنفذ الذي تستخدمه للنفق. إذا كنت تستخدم شبكة افتراضية خاصة (VPN)، فافصلها واختبر مرة أخرى، لأن شبكات VPN قد تغيّر إعدادات الشبكة وتسبب مشكلات.

إذا استمرت المشكلة، فاستخدم الأمر devtunnel list لعرض جميع الأنفاق النشطة. تأكد من استخدام عنوان URL الصحيح للنفق في تطبيق Microsoft 365 الخاص بك. في بعض الأحيان، يؤدي نسخ عنوان URL خاطئ إلى فشل الاتصال.

نصيحة: اختبر دائمًا عنوان URL للنفق في المتصفح قبل بدء الاختبار وتصحيح الأخطاء. تساعدك هذه الخطوة على اكتشاف الأخطاء البسيطة مبكرًا.

التعامل مع أخطاء المصادقة

قد تمنع أخطاء المصادقة تطبيقك من العمل مع خدمات Microsoft 365. أولًا، تحقّق من تسجيل التطبيق في بوابة Microsoft Entra ID. تأكد من أن معرّفات URI لإعادة التوجيه تطابق عنوان URL للنفق تمامًا. حتى الخطأ المطبعي البسيط قد يسبب الفشل.

راجع معرّف العميل (client ID) والسر (secret). يجب أن تطابق هذه القيم ما ضبطته في إعدادات تطبيقك. وإذا غيّرت النفق أو أنشأت نفقًا جديدًا، فحدّث معرّفات URI لإعادة التوجيه في تسجيل التطبيق.

إذا ظهرت لك رسالة "unauthorized"، فتحقّق من مستوى ظهور النفق وإعدادات المصادقة. في المشاريع الحساسة، استخدم مصادقة Entra ID دائمًا. تحافظ هذه الخطوة على أمان بياناتك وتمنع الوصول غير المرغوب فيه.

ملاحظة: تنتج معظم أخطاء المصادقة عن عدم تطابق عناوين URL أو غياب الأذونات. راجع هذه الإعدادات جيدًا أثناء تصحيح الأخطاء.

واجهة سطر الأوامر والأتمتة المتقدمة

يمكنك استخدام واجهة سطر الأوامر Dev Tunnels CLI لأتمتة سير عملك. تُوفّر الأتمتة الوقت وتقلّل الأخطاء. على سبيل المثال، يمكنك كتابة نص برمجي ينشئ نفقًا، ويشغّل الخدمة المحلية، ويفتح صفحة الاختبار في المتصفح.

إليك نموذج لنص برمجي لـ Windows PowerShell:

devtunnel create my-automation-tunnel --persistent --access organization
devtunnel host my-automation-tunnel -p 5000
Start-Process "https://my-automation-tunnel.devtunnels.ms"

يمكنك مشاركة نصوص برمجية كهذه مع فريقك. يستطيع الجميع استخدام الإعداد نفسه للاختبار وتصحيح الأخطاء. يساعدك هذا النهج على العمل بشكل تعاوني وتجنّب أخطاء الإعداد.

إذا أردت إغلاق جميع الأنفاق دفعة واحدة، فاستخدم:

devtunnel close --all

تجعل أتمتة إدارة الأنفاق عملية التطوير لديك أكثر سلاسة وموثوقية. جرّب استخدام النصوص البرمجية للمهام المتكررة.

يمكنك تعزيز تطوير تطبيقات Microsoft 365 باستخدام Visual Studio Dev Tunnels. تجعل هذه الأداة الاختبار أسرع وأكثر أمانًا. ابدأ بإعداد أول نفق لك، واتبع أفضل الممارسات المتعلقة بالرؤية والمصادقة. استكشف الميزات المتقدمة لتحسين سير عملك. وتذكّر التركيز على الأمان والعمل الجماعي وأنت تواصل اختبار التطبيقات وبناء تطبيقات أفضل.

قائمة مراجعة Visual Studio Dev Tunnels

قائمة مراجعة سريعة لإعداد Visual Studio Dev Tunnels واستخدامها واستكشاف أخطائها وإصلاحها.

• تحقّق من أن إصدار Visual Studio يدعم Visual Studio Dev Tunnels (Visual Studio 2022 أو أحدث / وتثبيت مكوّن الأدوات المطلوب)
• ثبّت امتداد dev tunnels أو مكوّن CLI أو حدّثه عند الحاجة
• سجّل الدخول إلى حساب Microsoft الخاص بك أو إلى المستأجر في AAD المستخدم للوصول إلى الأنفاق
• أنشئ نفقًا جديدًا من Visual Studio أو عبر CLI الخاصة بـ dev tunnels
• اختر اسم النفق الصحيح وأكّده، واختر المنطقة المناسبة لتقليل زمن الاستجابة
• حدّد نقطة النهاية المحلية (المنفذ) التي تريد عرضها عبر النفق واضبط إعدادها
• أكّد البروتوكول (HTTP/HTTPS أو TCP) وفعّل TLS عند عرض HTTPS
• اضبط النطاقات المخصصة أو النطاقات الفرعية واحجزها عند الحاجة
• اضبط نهج الوصول: عام، أو للمستخدمين المصادَق عليهم، أو لمستخدمين أو مجموعات محددة في AAD
• تحقّق من إعدادات جدار الحماية والموجّه للسماح بحركة مرور النفق الصادرة
• تحقّق من أن التطبيق المحلي يعمل ويستمع على المنفذ المُعدّ
• اختبر الاتصال بالنفق من جهاز خارجي أو من أحد المتعاونين
• استخدم HTTPS وشهادات صالحة لنقاط النهاية الحساسة في بيئات الإنتاج
• جدّد بيانات الاعتماد والرموز المميزة بشكل دوري، وألغِ الرموز غير المستخدمة
• راقب جلسات الأنفاق النشطة واستخدامها من لوحة المعلومات في Visual Studio أو من البوابة
• قيّد المسارات المعروضة، ولا تُعِد توجيه إلا نقاط النهاية الضرورية
• فعّل التسجيل وراجع سجلات النفق بحثًا عن أخطاء الاتصال ومشكلات الأداء
• عالج المشكلات الشائعة: تعارض المنافذ، وإخفاق المصادقة، وعدم تطابق المنطقة
• حدّث Visual Studio وأدوات dev tunnels بانتظام للحصول على تصحيحات الأمان
• أغلق الأنفاق غير النشطة أو احذفها لتقليل سطح الهجوم واستهلاك الموارد

الخاتمة

باختصار، فإن الاستفادة من Visual Studio Dev Tunnels بدلًا من عمليات النشر السحابية التقليدية تتيح للمطورين تسريع حلقات التغذية الراجعة بشكل كبير، وتقليل تكاليف البنية التحتية السحابية، والتصحيح محليًا بدقة كاملة. سواء كنت تبني webhooks أو تطبيقات Teams أو واجهات API حديثة، فإن هذه الميزة المدمجة تزيل العوائق. وللتعمق أكثر في هذه المفاهيم ومشاهدة شرح مباشر، استمع إلى الحلقة المرتبطة بالموضوع، Test Microsoft 365 Apps with Visual Studio Dev Tunnels.