تمكين الوصول الخاص إلى Azure Digital Twins باستخدام Private Link

يصف هذا القسم كيفية تشغيل الارتباط الخاص أثناء إعداد مثيل Azure Digital Twins في مدخل Microsoft Azure.

توجد خيارات Private Link في علامة التبويب Networking لإعداد المثيل.

1. ابدأ في إعداد مثيل Azure Digital Twins في مدخل Microsoft Azure. للحصول على الإرشادات، راجعإعداد المثيل والمصادقة.

2. عند الوصول إلى علامة التبويب Networking لإعداد المثيل، يمكنك تمكين نقاط النهاية الخاصة عن طريق تحديد خيار نقطة النهاية الخاصة لأسلوب الاتصال.

   سيؤدي القيام بذلك إلى إضافة قسم يسمى اتصالات نقطة النهاية الخاصة حيث يمكنك تكوين تفاصيل نقطة النهاية الخاصة بك. حدد الزر + Add للمتابعة.

   

3. في صفحة Create private endpoint التي تفتح، أدخل تفاصيل نقطة نهاية خاصة جديدة.

   

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

   2. بعد ذلك، حدد الشبكة الظاهرية والشبكة الفرعية التي تريد استخدامها لنشر نقطة النهاية.

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

   4. بعد ملء خيارات التكوين، حدد موافق للإنهاء.

4. بمجرد الانتهاء من هذه العملية، سيعيدك المدخل إلى علامة التبويب Networking لإعداد مثيل Azure Digital Twins. تحقق من أن نقطة النهاية الجديدة مرئية ضمن اتصالات نقطة النهاية الخاصة.

   

5. استخدم أزرار التنقل السفلية للمتابعة مع بقية إعداد المثيل.

لا يمكنك إضافة نقطة نهاية Private Link أثناء إنشاء المثيل باستخدام Azure CLI.

يمكنك التبديل إلى مدخل Microsoft Azure لإضافة نقطة النهاية أثناء إنشاء المثيل، أو المتابعة إلى القسم التالي لاستخدام CLI لإضافة نقطة نهاية خاصة بعد إنشاء المثيل.

1. أولا، انتقل إلى مدخل Microsoft Azure في مستعرض. اجلب مثيل Azure Digital Twins الخاص بك عن طريق البحث عن اسمه في شريط بحث المدخل.

2. حدد Networking في القائمة اليسرى.

3. ثم حدد تبويب Private endpoint connections.

4. حدد + نقطة النهاية الخاصة لفتح إعداد إنشاء نقطة نهاية خاصة.

   

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

   

   عند الانتهاء، حدد الزر التالي : المورد > للانتقال إلى علامة التبويب التالية.

6. في علامة التبويب المورد ، أدخل أو حدد المعلومات التالية:

   • أسلوب الاتصال: حدد الاتصال بمورد Azure في دليلي للبحث عن مثيل Azure Digital Twins.
   • الاشتراك: أدخل اشتراكك.
   • نوع المورد: حدد Microsoft.DigitalTwins/digitalTwinsInstances
   • المورد: حدد اسم مثيل Azure Digital Twins.
   • المورد الفرعي المستهدف: حدد API.

   

   عند الانتهاء، حدد الزر التالي: التكوين > للانتقال إلى علامة التبويب التالية.

7. في علامة التبويب التهيئة ، أدخل المعلومات أو حددها:

   • "Virtual network": حدد شبكتك الظاهرية.
   • الشبكة الفرعية: اختر شبكة فرعية من شبكتك الظاهرية.
   • التكامل مع منطقة DNS الخاصة: حدد ما إذا كنت تريد التكامل مع منطقة DNS الخاصة. يمكنك استخدام الإعداد الافتراضي نعم أو، للحصول على تعليمات حول هذا الخيار، يمكنك اتباع الارتباط في المدخل لمعرفة المزيد حول تكامل DNS الخاص. إذا حددت نعم، يمكنك ترك معلومات التكوين الافتراضية.

   

   عند الانتهاء، يمكنك تحديد الزر Review + create لإنهاء الإعداد.

8. في علامة التبويب مراجعة + إنشاء ، راجع التحديدات وحدد الزر إنشاء .

عند الانتهاء من نشر نقطة النهاية، يجب أن تظهر في اتصالات نقطة النهاية الخاصة لمثيل Azure Digital Twins.

لإنشاء نقطة نهاية خاصة وربطها بمثيل Azure Digital Twins باستخدام Azure CLI، استخدم الأمر az network private-endpoint create . حدد مثيل Azure Digital Twins باستخدام معرفه المؤهل بالكامل في المعلمة --private-connection-resource-id .

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

az network private-endpoint create --connection-name <private-link-service-connection> --name <name-for-private-endpoint> --resource-group <resource-group> --subnet <subnet-ID> --private-connection-resource-id "/subscriptions/<subscription-ID>/resourceGroups/<resource-group>/providers/Microsoft.DigitalTwins/digitalTwinsInstances/<Azure-Digital-Twins-instance-name>" 

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

بمجرد إنشاء نقطة نهاية خاصة لمثيل Azure Digital Twins، يمكنك عرضه في علامة التبويب Networking لمثيل Azure Digital Twins. ستعرض هذه الصفحة كافة اتصالات نقطة النهاية الخاصة المقترنة بالمثيل.

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

بمجرد إنشاء نقطة نهاية خاصة لمثيل Azure Digital Twins، يمكنك استخدام أوامر اتصال نقطة النهاية الخاصة لشبكة az dt لمتابعة إدارة اتصالات نقطة النهاية الخاصة فيما يتعلق بالمثيل. وتشمل العمليات ما يلي:

• إظهار اتصال نقطة نهاية خاصة
• تعيين حالة اتصال نقطة النهاية الخاصة
• حذف اتصال نقطة النهاية الخاصة
• سرد كافة اتصالات نقطة النهاية الخاصة لمثيل

لمزيد من المعلومات والأمثلة، راجع الوثائق المرجعية لنقطة النهاية الخاصة لشبكة az dt.

الحصول على مزيد من معلومات الارتباط الخاص

يمكنك الحصول على مزيد من المعلومات حول حالة الارتباط الخاص للمثيل الخاص بك باستخدام أوامر الارتباط الخاص لشبكة az dt. وتشمل العمليات ما يلي:

• سرد الارتباطات الخاصة المقترنة بمثيل Azure Digital Twins
• إظهار ارتباط خاص مقترن بالمثيل

لمزيد من المعلومات والأمثلة، راجع الوثائق المرجعية للارتباط الخاص بشبكة az dt.

لتعطيل أو تمكين الوصول إلى الشبكة العامة في مدخل Microsoft Azure، افتح المدخل وانتقل إلى مثيل Azure Digital Twins.

1. حدد Networking في القائمة اليسرى.

2. في علامة التبويب الوصول العام، قم بتعيين السماح بالوصول إلى الشبكة العامة إلى معطل أو كافة الشبكات.

   

   حدد حفظ.

في Azure CLI، يمكنك تعطيل الوصول إلى الشبكة العامة أو تمكينه عن طريق إضافة معلمة --public-network-accessaz dt create إلى الأمر . بينما يمكن استخدام هذا الأمر أيضا لإنشاء مثيل جديد، يمكنك استخدامه لتحرير خصائص مثيل موجود عن طريق تزويده باسم مثيل موجود بالفعل. (لمزيد من المعلومات حول هذا الأمر، راجع وثائقه المرجعية أو الإرشادات العامة لإعداد مثيل Azure Digital Twins).

لتعطيل الوصول إلى الشبكة العامة لمثيل Azure Digital Twins، استخدم المعلمة --public-network-access مثل هذا:

az dt create --dt-name <name-of-existing-instance> --resource-group <resource-group> --public-network-access Disabled

لتمكين الوصول إلى الشبكة العامة على مثيل حيث تم تعطيله حاليا، استخدم الأمر المتشابه التالي:

az dt create --dt-name <name-of-existing-instance> --resource-group <resource-group> --public-network-access Enabled

باستخدام أداة الأمر ARMClient، يتم تمكين الوصول إلى الشبكة العامة أو تعطيله باستخدام الأوامر أدناه.

لتعطيل الوصول إلى الشبكة العامة:

armclient login 

armclient PATCH /subscriptions/<your-Azure-subscription-ID>/resourceGroups/<your-resource-group>/providers/Microsoft.DigitalTwins/digitalTwinsInstances/<your-Azure-Digital-Twins-instance>?api-version=2020-12-01 "{ 'properties': { 'publicNetworkAccess': 'disabled' } }"  

لتمكين الوصول إلى الشبكة العامة:

armclient login 

armclient PATCH /subscriptions/<your-Azure-subscription-ID>/resourceGroups/<your-resource-group>/providers/Microsoft.DigitalTwins/digitalTwinsInstances/<your-Azure-Digital-Twins-instance>?api-version=2020-12-01 "{ 'properties': { 'publicNetworkAccess': 'enabled' } }"