تكوين توصيف نقل Microsoft .NET

يمكنك تكوين توصيف نقل Microsoft .NET يدويا لوصف محددات النقل لطلبات الخدمة التي تستخدم بروتوكول Windows Communication Foundation ‎(WCF)‎‏.

قبل البدء

اذا كنت تستخدم سرية SOAP، تأكد من توصيف بيئة التشغيل بالمكتبات وملفات التوصيف الصحيحة .

يجب تركيب الشهادات والمكتبات المطلوبة بواسطة proxy للوحدة التابعة Microsoft بالحاسب، متضمنا مكتبات Microsoft .NET.

يجب التوصيل لنسخة تم تعديلها من ملف توصيف proxy للوحدة التابعة Microsoft لخدمة WCF (افتراضيا client.exe.config) لتوصيف نقل Microsoft .NET. يجب أن تقوم باعادة تسمية الملف الى soaclient.exe.config وتحريره كما هو موضح في الاجراء التالي.

توضيح: يمكنك تكوين توصيف نقل Microsoft .NET آليا من خلال استقبال ملف Microsoft .NET WSDL. في هذه الحالة، يجب أن تقوم يدويا بتحرير توصيف نقل Microsoft .NET للاشارة الى ملف soaclient.exe.config الذي تم تعديله كما هو موضح في الاجراء التالي. للحصول على مزيد من المعلومات، أنظر ارسال طلبات الخدمة مع ملفات WSDL

نبذة عن هذه المهمة

يقوم المنتج بدعم اختبار خدمات WCF التي تستخدم عمليات الربط التالية:

BasicHttpBinding
WsHttpBinding
NetMsMqBinding للاتصالات أحادية الاتجاه فقط
WSFederationHttpBinding
WS2007FederationHttpBinding
NetTcpBinding
عمليات الربط المهيأة هي التي لا تقوم بادماج الوصلات المهيأة في القناة وتسلسل الرسائل والنقل والسرية.

ملاحظة: لا يتم دعم خدمات WCF التالية:

العمليات والنطاقات
طلبات النمط المزدوج، مثل خدمات اعادة الاتصال أو الاتصالات ثنائية الاتجاه بناءا على نقل ‏‎Microsoft Message Queuing ‎(MS-MQ)‎‏

فقط لمستخدمي ‏‎IBM AppScan‎‏

لاستخدام برنامج الحاسب للخدمة العامة مع IBM Appscan لاختبار تطبيق WCF، قم باضافة الكود التالي الى ملف توصيف WCF:

<system.diagnostics>    <trace autoflush="true" />   
      <sources>      <source name="System.Net"
      maxdatasize="1048576"><listeners><add
    name="System.Net"/></listeners></source>      <source
      name="System.Net.Cache"><listeners><add
      name="System.Net"/></listeners></source>      <source
      name="System.Net.Http"><listeners><add name="System.Net
      "/></listeners></source>      <source
      name="System.Net.Sockets"><listeners><add
      name="System.Net"/></listeners></source>      <source
      name="System.Net.WebSockets"><listeners><add
      name="System.Net"/></listeners></source>    </sources>   
      <sharedListeners>      <add
    name="System.Net"          
      type="IBM.ServiceModel.Soa.Extension.tools.TrafficTraceListener,
      Soa-Behavior-Library"          
    initializeData=""       />   
    </sharedListeners>    <switches>      <add name="System.Net"
      value="All"/>      <add name="System.Net.Cache"
    value="All"/>      <add name="System.Net.Http"
    value="All"/>      <add name="System.Net.Sockets"
    value="All"/>      <add name="System.Net.WebSockets"
    value="All"/>    </switches></system.diagnostics>

يتوقع IBM Appscan طلبات HTTP فقط في WCF. يتم دعم روابط HTTP التالية:

BasicHttpBinding
Custombinding above standard httpTransport
WsHttpBinding
WsFederationHttpBinding
WS2007FederationHttpBinding

أيضا، يتم دعم النماذج التالية:

قيمة التصرف ( الزامية )
قيمة تصرف الرد ( الزامية )
مستوى الحماية

اجراء

تكوين ملف soaclient.exe.config معدل من خلال اتمام الخطوات التالية:
1. قم بتكوين نسخة من الملف client.exe.config (أو الملف proxy_client_name.config) من مشروع Microsoft .NET واعادة تسمية النسخة الى soaclient.exe.config.
2. قم بتحرير الملف soaclient.exe.config بحيث يقوم باستخدام نسخة Microsoft .NET التي يقوم المنتج بدعمها، كما هو محدد في السطر التالي:
```
‎<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>‎
```
3. قم بتحرير الملف soaclient.exe.config بحيث تشير نقاط النهاية في ملف التوصيف الى عقد العميل الخاص بالمنتج، كما هو محدد في السطر التالي:
```
contract=‎"IBM.ServiceModel.Soa.Extension.Stub.IStubTest"‎
```
4. قم باستقبال ملف soaclient.exe.config المعدل في مساحة العمل.
بعد تكوين الملف soaclient.exe.config، يمكنك تخطي الخطوات التالية واستقبال ملف WSDL لتكوين توصيف نقل Microsoft .NET آليا بناءا على المعلومات التي يتم اتاحتها بواسطة WSDL. للحصول على مزيد من المعلومات، أنظر ارسال طلبات الخدمة مع ملفات WSDL.
اضغط على اختيار خط أدوات الوحدة التابعة للخدمة العامة () لفتح الوحدة التابعة للخدمة العامة ثم اضغط على علامة تبويب النقل .
في صفحة توصيف النقل، اضغط على تكوين توصيف Microsoft .NET.
أدخل اسم لتوصيف النقل الجديد وحدد الاختيارات التالية:
مكان soaclient.exe.config

حدد المكان الخاص بالملف soaclient.exe.config. يجب أن تقوم بتكوين هذا الملف يدويا من خلال نسخ وتحرير الملف client.exe.config من خدمة Microsoft .NET.

توثيق مستخدم

اذا كانت الخدمة تتطلب توثيق، حدد توثيق المستخدم ثم أدخل اسم المستخدم وكلمة السرية للتوصل الى الخدمة.

حماية نقطة النهاية
افتراضيا، يستخدم توصيف النقل مستوى حماية نقطة النهاية الذي يتم توضيحه في الملف soaclient.exe.config. استخدم هذه المحددات لتحديد مستوى حماية مختلف:
- التوقيع: حدد هذا الاختيار لتوقيع الطلبات رقميا.
- التشفير والتوقيع: حدد هذا الاختيار لتوقيع وتشفير الطلبات.
خصائص متقدمة

استخدم هذا الجدول لعرض تصرفات الطلب والاستجابة وفقا لترتيب الطرق في ملف WSDL. اضغط اضافة لتحديد اسم وقيمة تصرفات الطلب والاستجابة المطلوبة بواسطة الخدمة. يتم تكوين هذا الجدول آليا عند استقبال ملف Microsoft .NET WSDL.
اضغط حسنا لتكوين توصيف النقل.

ما تريد القيام به بعد الآن

بعد القيام بتكوين التوصيف، يمكنك استخدامه مع أي استدعاء خدمة يستخدم بروتوكول نقل Microsoft .NET. يمكنك استخدام كشف التوصيفات فى الوحدة التابعة للخدمة العامة لتحرير التوصيفات القائمة أو لتكوين توصيفات مكررة.

المعلومات المرجعية