Comment : récupérer des métadonnées sur une liaison personnalisée

Cette rubrique décrit comment récupérer les métadonnées d'un point de terminaison MEX sur une liaison personnalisée. Le code dans cet exemple est basé sur l'exemple Custom Secure Metadata Endpoint.

Pour récupérer des métadonnées sur une liaison personnalisée

1. Déterminez la liaison utilisée par le point de terminaison MEX. Concernant les services WCF, vous pouvez déterminer la liaison MEX en accédant au fichier de configuration du service. Dans ce cas, la liaison MEX est définie dans la configuration de service suivante :

   <services>
       <service name="Microsoft.ServiceModel.Samples.CalculatorService"
               behaviorConfiguration="CalculatorServiceBehavior">
        <!-- Use the base address provided by the host. -->
        <endpoint address=""
          binding="wsHttpBinding"
          bindingConfiguration="Binding2"
          contract="Microsoft.ServiceModel.Samples.ICalculator" />
        <endpoint address="mex"
          binding="wsHttpBinding"
          bindingConfiguration="Binding1"
          contract="IMetadataExchange" />
        </service>
    </services>
    <bindings>
      <wsHttpBinding>
        <binding name="Binding1">
          <security mode="Message">
            <message clientCredentialType="Certificate" />
          </security>
        </binding>
        <binding name="Binding2">
          <reliableSession inactivityTimeout="00:01:00" enabled="true" />
          <security mode="Message">
            <message clientCredentialType="Certificate" />
          </security>
        </binding>
      </wsHttpBinding>
    </bindings>
   

2. Dans le fichier de configuration client, configurez la même liaison personnalisée. Dans ce cas, le client définit également un comportement clientCredentials pour fournir un certificat permettant d'authentifier auprès du service lors de la demande des métadonnées provenant du point de terminaison MEX. Lorsque vous utilisez Svcutil.exe pour demander les métadonnées sur une liaison personnalisée, vous devez ajouter la configuration du point de terminaison MEX au fichier de configuration de Svcutil.exe (Svcutil.exe.config), et le nom de la configuration du point de terminaison doit correspondre au schéma d'URI de l'adresse du point de terminaison MEX :

     <system.serviceModel>
       <client>
         <endpoint name="http"
                   binding="wsHttpBinding"
                   bindingConfiguration="Binding1"
                   behaviorConfiguration="ClientCertificateBehavior"
                   contract="IMetadataExchange" />
       </client>
       <bindings>
         <wsHttpBinding>
           <binding name="Binding1">
             <security mode="Message">
               <message clientCredentialType="Certificate"/>
             </security>
           </binding>
         </wsHttpBinding>
       </bindings>
       <behaviors>
         <endpointBehaviors>
           <behavior name="ClientCertificateBehavior">
             <clientCredentials>
               <clientCertificate findValue="client.com" storeLocation="CurrentUser" storeName="My" x509FindType="FindBySubjectName" />
               <serviceCertificate>
                 <authentication certificateValidationMode="PeerOrChainTrust" />
               </serviceCertificate>
             </clientCredentials>
           </behavior>
         </endpointBehaviors>
       </behaviors>  
     </system.serviceModel>
   

3. Créez un MetadataExchangeClient et appelez GetMetadata. Cette opération peut s'effectuer de deux manières différentes : vous pouvez spécifier la liaison personnalisée dans la configuration ou la spécifier dans le code :

   // The custom binding is specified in configuration.
   EndpointAddress mexAddress = new EndpointAddress("https://localhost:8000/ServiceModelSamples/Service/mex");
   
   MetadataExchangeClient mexClient = new MetadataExchangeClient("http");
   mexClient.ResolveMetadataReferences = true;
   MetadataSet mexSet = mexClient.GetMetadata(mexAddress);
   
   // The custom binding is specified in code.
   // Specify the Metadata Exchange binding and its security mode.
   WSHttpBinding mexBinding = new WSHttpBinding(SecurityMode.Message);
   mexBinding.Security.Message.ClientCredentialType = MessageCredentialType.Certificate;
   
   // Create a MetadataExchangeClient and set the certificate details.
   MetadataExchangeClient mexClient = new MetadataExchangeClient(mexBinding);
   mexClient.SoapCredentials.ClientCertificate.SetCertificate(
       StoreLocation.CurrentUser, StoreName.My,
       X509FindType.FindBySubjectName, "client.com");
   mexClient.SoapCredentials.ServiceCertificate.Authentication.    CertificateValidationMode =    X509CertificateValidationMode.PeerOrChainTrust;
   mexClient.SoapCredentials.ServiceCertificate.SetDefaultCertificate(
       StoreLocation.CurrentUser, StoreName.TrustedPeople,
       X509FindType.FindBySubjectName, "localhost");
   MetadataExchangeClient mexClient2 = new MetadataExchangeClient(customBinding);
   mexClient2.ResolveMetadataReferences = true;
   MetadataSet mexSet2 = mexClient2.GetMetadata(mexAddress);
   

4. Créez un WsdlImporter et appelez ImportAllEndpoints :

   WsdlImporter importer = new WsdlImporter(mexSet);
   ServiceEndpointCollection endpoints = importer.ImportAllEndpoints();
   

5. À ce stade, vous disposez d'une collection de points de terminaison de service. Pour plus d'informations sur l'importation de métadonnées, consultez Comment : importer des métadonnées dans des points de terminaison de service.

Voir aussi

Concepts

Métadonnées