Postupy: Vytvoření vlastní vazby pro spolehlivou relaci s HTTPS

Toto téma ukazuje použití zabezpečení přenosu SSL (Secure Sockets Layer) se spolehlivými relacemi. Pokud chcete používat spolehlivou relaci přes PROTOKOL HTTPS, musíte vytvořit vlastní vazbu, která používá spolehlivou relaci a přenos HTTPS. Spolehlivou relaci povolíte buď imperativním použitím kódu, nebo deklarativním způsobem v konfiguračním souboru. Tento postup používá konfigurační soubory klienta a služby k povolení spolehlivé relace a <elementu httpsTransport.>

Klíčovou součástí tohoto postupu je, že element konfigurace koncového bodu> obsahuje bindingConfiguration atribut, který odkazuje na vlastní konfiguraci vazby s názvem reliableSessionOverHttps.< Element <konfigurace vazby> odkazuje na tento název k určení, že spolehlivá relace a přenos HTTPS jsou používány včetně< reliableSession> a< httpsTransport> elementů.

Zdrojová kopie tohoto příkladu najdete v tématu Spolehlivá relace vlastních vazeb přes HTTPS.

Konfigurace služby s využitím CustomBinding pro použití spolehlivé relace s HTTPS

1. Definujte kontrakt služby pro typ služby.

   [ServiceContract]
   public interface ICalculator
   {
       [OperationContract]
       double Add(double n1, double n2);
       [OperationContract]
       double Subtract(double n1, double n2);
       [OperationContract]
       double Multiply(double n1, double n2);
       [OperationContract]
       double Divide(double n1, double n2);
   }
   

2. Implementujte kontrakt služby ve třídě služby. Všimněte si, že adresa nebo informace o vazbě nejsou zadány uvnitř implementace služby. K načtení adresy nebo vazby z konfiguračního souboru nemusíte psát kód.

   public class CalculatorService : ICalculator
   {
       public double Add(double n1, double n2)
       {
           return n1 + n2;
       }
       public double Subtract(double n1, double n2)
       {
           return n1 - n2;
       }
       public double Multiply(double n1, double n2)
       {
           return n1 * n2;
       }
       public double Divide(double n1, double n2)
       {
           return n1 / n2;
       }
   }
   

3. Vytvořte soubor Web.config pro konfiguraci koncového bodu pro CalculatorService vlastní vazbu s názvem reliableSessionOverHttps , která používá spolehlivou relaci a přenos HTTPS.

   <?xml version="1.0" encoding="utf-8" ?>
   <configuration>
     <system.serviceModel>
   
       <services>
         <service name="Microsoft.ServiceModel.Samples.CalculatorService" 
                  behaviorConfiguration="CalculatorServiceBehavior">
           <!-- 
             Use base address provided by the host 
           -->
           <endpoint address=""
                     binding="customBinding"
                     bindingConfiguration="reliableSessionOverHttps" 
                     contract="Microsoft.ServiceModel.Samples.ICalculator" />
           <!-- 
             The mex endpoint is exposed as 
             http://localhost/servicemodelsamples/service.svc/mex
           -->
           <endpoint address="mex"
                     binding="mexHttpBinding"
                     contract="IMetadataExchange" />
         </service>
       </services>
   
       <bindings>
         <customBinding>
           <binding name="reliableSessionOverHttps">
             <reliableSession />
             <httpsTransport />
           </binding>
         </customBinding>
       </bindings>
   
     </system.serviceModel>
   </configuration>
   

4. Vytvořte soubor Service.svc , který obsahuje řádek:

   <%@ServiceHost language=c# Service="CalculatorService" %>

5. Umístěte soubor Service.svc do virtuálního adresáře Internetová informační služba (IIS).

Konfigurace klienta s využitím CustomBinding pro použití spolehlivé relace s HTTPS

1. Pomocí nástroje ServiceModel Metadata Utility (Svcutil.exe) z příkazového řádku vygenerujte kód z metadat služby.

   Svcutil.exe <Metadata Exchange (MEX) address or HTTP GET address>
   

2. Vygenerovaný klient obsahuje ICalculator rozhraní, které definuje kontrakt služby, který musí implementace klienta splňovat.

   // Generated interface defining the ICalculator contract	
   [System.ServiceModel.ServiceContractAttribute(
   Namespace="http://Microsoft.ServiceModel.Samples",
   ConfigurationName="Microsoft.ServiceModel.Samples.ICalculator")]
   public interface ICalculator
   {
       [System.ServiceModel.OperationContractAttribute(
       Action="http://Microsoft.ServiceModel.Samples/ICalculator/Add",
       ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/AddResponse")]
       double Add(double n1, double n2);
   
       [System.ServiceModel.OperationContractAttribute(
       Action="http://Microsoft.ServiceModel.Samples/ICalculator/Subtract",
       ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/SubtractResponse")]
       double Subtract(double n1, double n2);
   
       [System.ServiceModel.OperationContractAttribute(
       Action="http://Microsoft.ServiceModel.Samples/ICalculator/Multiply",
       ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/MultiplyResponse")]
       double Multiply(double n1, double n2);
   
       [System.ServiceModel.OperationContractAttribute(
       Action="http://Microsoft.ServiceModel.Samples/ICalculator/Divide",
       ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/DivideResponse")]
       double Divide(double n1, double n2);
   }
   

3. Vygenerovaná klientská aplikace obsahuje také implementaci ClientCalculator. Všimněte si, že v implementaci služby není zadána adresa a informace o vazbě. K načtení adresy a vazby z konfiguračního souboru nemusíte psát kód.

   // Implementation of the CalculatorClient
   public partial class CalculatorClient :
       System.ServiceModel.ClientBase<Microsoft.ServiceModel.Samples.ICalculator>,
       Microsoft.ServiceModel.Samples.ICalculator
   {
       public CalculatorClient()
       {
       }
   
       public CalculatorClient(string endpointConfigurationName) :
           base(endpointConfigurationName)
       {
       }
   
       public CalculatorClient(string endpointConfigurationName, string remoteAddress) :
           base(endpointConfigurationName, remoteAddress)
       {
       }
   
       public CalculatorClient(string endpointConfigurationName,
           System.ServiceModel.EndpointAddress remoteAddress) :
           base(endpointConfigurationName, remoteAddress)
       {
       }
   
       public CalculatorClient(System.ServiceModel.Channels.Binding binding,
           System.ServiceModel.EndpointAddress remoteAddress) :
           base(binding, remoteAddress)
       {
       }
   
       public double Add(double n1, double n2)
       {
           return base.Channel.Add(n1, n2);
       }
   
       public double Subtract(double n1, double n2)
       {
           return base.Channel.Subtract(n1, n2);
       }
   
       public double Multiply(double n1, double n2)
       {
           return base.Channel.Multiply(n1, n2);
       }
   
       public double Divide(double n1, double n2)
       {
           return base.Channel.Divide(n1, n2);
       }
   }
   

4. Nakonfigurujte vlastní vazbu s názvem reliableSessionOverHttps pro použití přenosových relací HTTPS a spolehlivých relací.

   <?xml version="1.0" encoding="utf-8" ?>
   <configuration>
     <system.serviceModel>
   
       <client>
         <!-- 
           This endpoint has an https address
         -->
         <endpoint name=""
                   address="https://localhost/servicemodelsamples/service.svc" 
                   binding="customBinding" 
                   bindingConfiguration="reliableSessionOverHttps" 
                   contract="Microsoft.ServiceModel.Samples.ICalculator" />
       </client>
   
       <bindings>
         <customBinding>
           <binding name="reliableSessionOverHttps">
             <reliableSession />
             <httpsTransport />
           </binding>
         </customBinding>      
       </bindings>
   
     </system.serviceModel>
   </configuration>
   

5. Vytvořte instanci ClientCalculator aplikace a pak volejte operace služby.

   //Client implementation code.
   class Client
   {
       static void Main()
       {
           // Create a client with given client endpoint configuration
           CalculatorClient client = new CalculatorClient();
   
           // Call the Add service operation.
           double value1 = 100.00D;
           double value2 = 15.99D;
           double result = client.Add(value1, value2);
           Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);
   
           // Call the Subtract service operation.
           value1 = 145.00D;
           value2 = 76.54D;
           result = client.Subtract(value1, value2);
           Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);
   
           // Call the Multiply service operation.
           value1 = 9.00D;
           value2 = 81.25D;
           result = client.Multiply(value1, value2);
           Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);
   
           // Call the Divide service operation.
           value1 = 22.00D;
           value2 = 7.00D;
           result = client.Divide(value1, value2);
           Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);
   
           //Closing the client gracefully closes the connection and cleans up resources
           client.Close();
   
           Console.WriteLine();
           Console.WriteLine("Press <ENTER> to terminate client.");
           Console.ReadLine();
       }
   }
   

6. Zkompilujte a spusťte klienta.

zabezpečení v rozhraní .NET Framework

Vzhledem k tomu, že certifikát použitý v této ukázce je testovací certifikát vytvořený pomocí Makecert.exe, zobrazí se výstraha zabezpečení při pokusu o přístup k adrese HTTPS, například https://localhost/servicemodelsamples/service.svc, z prohlížeče.

Viz také

• Spolehlivé relace