WSTrustServiceHost Class
This class extends the ServiceHost class implemented by the Windows Communication Foundation (WCF) service model programming model. It is a service host for registering Security Token Services (STSs) and lets you expose an STS for use by client applications when you are not using Internet Information Services (IIS). The ServiceHost will have multiple endpoints registered based on the number of listeners registered in the configuration.
Namespace: Microsoft.IdentityModel.Protocols.WSTrust
Assembly: Microsoft.IdentityModel (in Microsoft.IdentityModel.dll)
public class MySecurityTokenServiceConfiguration : SecurityTokenServiceConfiguration
{
public MySecurityTokenServiceConfiguration ()
: base(”HelloWorldSTS”)
{
SecurityTokenService = typeof(MySecurityTokenService);
}
}
// Following code snippet uses WSTrustServiceHost to expose STS for use by
// client applications
{
MySecurityTokenServiceConfiguration config = new MySecurityTokenServiceConfiguration();
// Add the STS endoint information
config.TrustEndpoints.Add( new ServiceHostEndpointConfiguration( "http://localhost:6000/SimpleActiveSTS", new WSHttpBinding(), typeof( IWSTrustFeb2005SyncContract ) ) );
// Create the WS-Trust service host with our STS configuration
using ( WSTrustServiceHost host = new WSTrustServiceHost( config, new Uri( "http://localhost:6000/SimpleActiveSTS" ) ) )
{
host.Open();
Console.WriteLine( "SimpleActiveSTS started, press ENTER to stop ..." );
Console.ReadLine();
The WSTrustServiceHost class is the Windows® Identity Foundation (WIF) implementation of a Windows Communication Foundation ServiceHost that is intended to be used to integrate a WCF hosting environment with a Security Token Service (STS) built using WIF. The WSTrustServiceHost class provides a fully functioning ServiceHost that offers both integration with WCF configuration as well as WIF specific features that are configured by modifying the SecurityTokenServiceConfiguration, which is a class provided by WIF.
By default, the WSTrustServiceHost class provides the following:
It adds WS-Trust endpoints to the ServiceHost based on the TrustEndpoints property.
It enables metadata over the base addresses if the DisableWsdl property is set to false.
It configures the service certificate on the ServiceHost service credentials if a WIF configuration section specifies a service certificate. Note that this will override the equivalent service certificate settings in WCF configuration.
It integrates WIF token handlers into the security processing pipeline by calling the ExtensibleSecurityCredentials.ConfigureServiceHost method on itself.
The WSTrustServiceHost class may be overridden to customize this behavior.
System.ServiceModel.Channels.CommunicationObject
System.ServiceModel.ServiceHostBase
System.ServiceModel.ServiceHost
Microsoft.IdentityModel.Protocols.WSTrust.WSTrustServiceHost
Target Platforms
Windows 7, Windows Server 2008 R2, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2003 SP2 (32-bit or 64-bit)
Copyright © 2008 by Microsoft Corporation. All rights reserved.