Transportbeveiliging met basisverificatie
In de volgende afbeelding ziet u een WCF-service (Windows Communication Foundation) en -client. De server heeft een geldig X.509-certificaat nodig dat kan worden gebruikt voor SSL (Secure Sockets Layer) en de clients moeten het certificaat van de server vertrouwen. Verder heeft de webservice al een SSL-implementatie die kan worden gebruikt. Zie Basisverificatie voor meer informatie over het inschakelen van basisverificatie op Internet Information Services (IIS).
| Characteristic | Beschrijving |
|---|---|
| Beveiligingsmodus | Transport |
| Interoperabiliteit | Met bestaande webserviceclients en -services |
| Verificatie (server) Verificatie (client) |
Ja (met HTTPS) Ja (via gebruikersnaam/wachtwoord) |
| Integriteit | Ja |
| Vertrouwelijkheid | Ja |
| Transport | HTTPS |
| Binding | WSHttpBinding |
Service
De volgende code en configuratie zijn bedoeld om onafhankelijk van elkaar te worden uitgevoerd. Voer een van de volgende stappen uit:
Maak een zelfstandige service met behulp van de code zonder configuratie.
Maak een service met behulp van de opgegeven configuratie, maar definieer geen eindpunten.
Code
De volgende code laat zien hoe u een service-eindpunt maakt dat gebruikmaakt van een gebruikersnaam en wachtwoord van een Windows-domein voor overdrachtbeveiliging. Houd er rekening mee dat voor de service een X.509-certificaat is vereist voor verificatie bij de client. Zie Werken met certificaten en procedures voor meer informatie: Een poort configureren met een SSL-certificaat.
// Create the binding.
WSHttpBinding binding = new WSHttpBinding();
binding.Security.Mode = SecurityMode.Transport;
binding.Security.Transport.ClientCredentialType =
HttpClientCredentialType.Basic;
// Create the URI for the endpoint.
Uri httpUri = new Uri("https://localhost/Calculator");
// Create the service host and add an endpoint.
ServiceHost myServiceHost = new ServiceHost(
typeof(ServiceModel.Calculator), httpUri);
myServiceHost.AddServiceEndpoint(
typeof(ServiceModel.ICalculator), binding, "");
// Open the service.
myServiceHost.Open();
Console.WriteLine("Listening...");
Console.WriteLine("Press Enter to exit.");
Console.ReadLine();
// Close the service.
myServiceHost.Close();
' Create the binding.
Dim binding As New WSHttpBinding()
binding.Security.Mode = SecurityMode.Transport
binding.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic
' Create the URI for the endpoint.
Dim httpUri As New Uri("https://localhost/Calculator")
' Create the service host and add an endpoint.
Dim myServiceHost As New ServiceHost(GetType(ServiceModel.Calculator), httpUri)
myServiceHost.AddServiceEndpoint(GetType(ServiceModel.ICalculator), binding, "")
' Open the service.
myServiceHost.Open()
Console.WriteLine("Listening...")
Console.WriteLine("Press Enter to exit.")
Console.ReadLine()
' Close the service.
myServiceHost.Close()
Configuratie
Met de volgende configuratie configureert u een service voor het gebruik van basisverificatie met beveiliging op transportniveau:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.serviceModel>
<bindings>
<wsHttpBinding>
<binding name="UsernameWithTransport">
<security mode="Transport">
<transport clientCredentialType="Basic" />
</security>
</binding>
</wsHttpBinding>
</bindings>
<services>
<service name="BasicAuthentication.Calculator">
<endpoint address="https://localhost/Calculator"
binding="wsHttpBinding"
bindingConfiguration="UsernameWithTransport"
name="BasicEndpoint"
contract="BasicAuthentication.ICalculator" />
</service>
</services>
</system.serviceModel>
</configuration>
Klant
Code
De volgende code toont de clientcode die de gebruikersnaam en het wachtwoord bevat. Houd er rekening mee dat de gebruiker een geldige Windows-gebruikersnaam en -wachtwoord moet opgeven. De code voor het retourneren van de gebruikersnaam en het wachtwoord wordt hier niet weergegeven. Gebruik een dialoogvenster of een andere interface om een query uit te voeren op de gebruiker voor de informatie.
Notitie
Gebruikersnaam en wachtwoord kunnen alleen worden ingesteld met behulp van code.
// Create the binding.
WSHttpBinding myBinding = new WSHttpBinding();
myBinding.Security.Mode = SecurityMode.Transport;
myBinding.Security.Transport.ClientCredentialType =
HttpClientCredentialType.Basic;
// Create the endpoint address. Note that the machine name
// must match the subject or DNS field of the X.509 certificate
// used to authenticate the service.
EndpointAddress ea = new
EndpointAddress("https://machineName/Calculator");
// Create the client. The code for the calculator
// client is not shown here. See the sample applications
// for examples of the calculator code.
CalculatorClient cc =
new CalculatorClient(myBinding, ea);
// The client must provide a user name and password. The code
// to return the user name and password is not shown here. Use
// a database to store the user name and passwords, or use the
// ASP.NET Membership provider database.
cc.ClientCredentials.UserName.UserName = ReturnUsername();
cc.ClientCredentials.UserName.Password = ReturnPassword();
try
{
// Begin using the client.
cc.Open();
Console.WriteLine(cc.Add(100, 11));
Console.ReadLine();
// Close the client.
cc.Close();
}
' Create the binding.
Dim myBinding As New WSHttpBinding()
myBinding.Security.Mode = SecurityMode.Transport
myBinding.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic
' Create the endpoint address. Note that the machine name
' must match the subject or DNS field of the X.509 certificate
' used to authenticate the service.
Dim ea As New EndpointAddress("https://machineName/Calculator")
' Create the client. The code for the calculator
' client is not shown here. See the sample applications
' for examples of the calculator code.
Dim cc As New CalculatorClient(myBinding, ea)
' The client must provide a user name and password. The code
' to return the user name and password is not shown here. Use
' a database to store the user name and passwords, or use the
' ASP.NET Membership provider database.
cc.ClientCredentials.UserName.UserName = ReturnUsername()
cc.ClientCredentials.UserName.Password = ReturnPassword()
' Begin using the client.
Try
cc.Open()
Console.WriteLine(cc.Add(100, 11))
Console.ReadLine()
' Close the client.
cc.Close()
Catch tex As TimeoutException
Console.WriteLine(tex.Message)
cc.Abort()
Catch cex As CommunicationException
Console.WriteLine(cex.Message)
cc.Abort()
Finally
Console.WriteLine("Closed the client")
Console.ReadLine()
End Try
Configuratie
De volgende code toont de clientconfiguratie.
Notitie
U kunt de configuratie niet gebruiken om de gebruikersnaam en het wachtwoord in te stellen. De hier weergegeven configuratie moet worden uitgebreid met behulp van code om de gebruikersnaam en het wachtwoord in te stellen.
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.serviceModel>
<bindings>
<wsHttpBinding>
<binding name="WSHttpBinding_ICalculator" >
<security mode="Transport">
<transport clientCredentialType="Basic" />
</security>
</binding>
</wsHttpBinding>
</bindings>
<client>
<endpoint address="https://machineName/Calculator"
binding="wsHttpBinding"
bindingConfiguration="WSHttpBinding_ICalculator"
contract="ICalculator"
name="WSHttpBinding_ICalculator" />
</client>
</system.serviceModel>
</configuration>