Création de configurations de transport Microsoft .NET

Vous pouvez créer manuellement une configuration de transport Microsoft .NET pour décrire les paramètres de transport des demandes de services qui utilisent le protocole WCF (Windows Communication Foundation).

Avant de commencer

Si vous utilisez la sécurité SOAP, assurez-vous d'avoir configuré l'environnement avec les fichiers de configuration et les bibliothèques corrects.

Les certificats et les bibliothèques requis par le client proxy Microsoft doivent être installés sur l'ordinateur, y compris les bibliothèques Microsoft .NET.

Vous devez lier une version modifiée du fichier de configuration du proxy client Microsoft du service WCF (par défaut client.exe.config) à la configuration de transport Microsoft .NET. Vous devez renommer le fichier en soaclient.exe.config et l'éditer comme décrit dans la procédure suivante.

Conseil : Vous pouvez créer une configuration de transport Microsoft .NET automatiquement en important le fichier WSDL Microsoft .NET. Dans ce cas, vous devez toujours éditer manuellement la configuration de transport Microsoft .NET pour pointer vers le fichier soaclient.exe.config modifié comme décrit dans la procédure suivante. Pour plus d'informations, voir Envoi de demandes de service à l'aide de fichiers WSDL

Pourquoi et quand exécuter cette tâche

Le produit prend en charge le test des services WCF qui utilisent les liaisons suivantes :

BasicHttpBinding
WsHttpBinding
NetMsMqBinding pour appels unidirectionnels seulement
WSFederationHttpBinding
WS2007FederationHttpBinding
NetTcpBinding
Liaisons personnalisées qui n'intègrent pas d'extensions personnalisées dans le canal, sérialisation du message, transport, et sécurité

Remarque : Les services WCF ne sont pas pris en charge :

Transaction et portées
Requêtes en mode recto verso, telles que des rappels ou des services bidirectionnels basées sur le transport MS-MQ (Microsoft Message Queuing)

Uniquement pour les utilisateurs IBM AppScan

Pour utiliser le client de service générique avec IBM Appscan pour tester une application WCF, ajoutez le code suivant dans le fichier de configuration 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 attend uniquement des demandes HTTP dans WCF. Les liaisons HTTP suivantes sont prises en charge :

BasicHttpBinding
Custombinding au-dessus du transport http standard
WsHttpBinding
WsFederationHttpBinding
WS2007FederationHttpBinding

En outre, les modèles suivants sont pris en charge :

Valeur d'action (obligatoire)
Valeur d'action de réponse (obligatoire)
Niveau de protection

Procédure

Créez une modification du fichier soaclient.exe.config en procédant comme suit :
1. Créez une copie du fichier client.exe.config (ou proxy_client_name.config) du projet Microsoft .NET et renommez la copie en soaclient.exe.config.
2. Editez le fichier soaclient.exe.config pour utiliser la version de Microsoft .NET prise en charge par le produit, comme indiqué sur la ligne suivante :
```
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>
```
3. Editez le fichier soaclient.exe.config afin que les points d'extrémité du fichier de configuration pointent vers le contrat client du produit, comme indiqué sur la ligne suivante :
```
contract="IBM.ServiceModel.Soa.Extension.Stub.IStubTest"
```
4. Importez le fichier soaclient.exe.config modifié dans l'espace de travail.
Une fois que vous avez créé le fichier soaclient.exe.config , vous pouvez ignorer les étapes suivantes et importez le fichier WSDL pour créer automatiquement une configuration de transport Microsoft .NET basée sur les informations fournies par le WSDL. Pour plus d'informations, voir Envoi de demandes de service à l'aide de fichiers WSDL.
Cliquez sur le bouton Client de service générique () dans la barre d'outils pour ouvrir le client de service générique et cliquez sur l'onglet Transport.
Sur la page Configurations de transport, cliquez sur Créer une configuration Microsoft .NET.
Entrez un nom pour la nouvelle configuration de transport et spécifiez les options suivantes :
Emplacement du soaclient.exe.config

Indiquez l'emplacement du fichier soaclient.exe.config. Vous devez créer ce fichier manuellement en copiant et en éditant le fichier client.exe.config à partir du service Microsoft .NET.

Authentification utilisateur

Si le service demande une authentification, sélectionnez Authentification utilisateur et entrez le nom d'utilisateur ainsi que le mot de passe pour accéder au service.

Protection du point d'extrémité
Par défaut, la configuration de transport utilise le niveau de protection du point d'extrémité, qui est décrit dans le fichier soaclient.exe.config. Utilisez ce paramètre pour spécifier un autre Niveau de protection :
- Signature : sélectionnez cette option pour signer numériquement les demandes.
- Chiffrement et signature : sélectionnez cette option pour signer et chiffrer numériquement les demandes.
Propriétés avancées

Utilisez ce tableau pour répertorier les actions de demande et de réponse dans l'ordre des méthodes dans le fichier WSDL. Cliquez sur Ajouter pour spécifier le nom et la valeur des actions de demande et de réponse requises par le service. Cette table est générée automatiquement lorsque vous importez un fichier WSDL Microsoft .NET.
Cliquez sur OK pour créer la configuration de transport.

Que faire ensuite

Une fois que vous avez créé la configuration, vous pouvez l'utiliser avec n'importe quel appel de service utilisant le protocole de transport Microsoft .NET. Vous pouvez utiliser la liste Configurations dans le client de service générique pour modifier des configurations existantes ou créer des configurations en double.

Retour d'informations