Classe WSTrustServiceHost

Article
04/21/2010

This class extends the ServiceHost class implemented by Windows Communication Foundation (WCF) service model programming model. It is a service host for registering Security Token Services (STSes) and let 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.

Espace de noms: Microsoft.IdentityModel.Protocols.WSTrust
Assembly : Microsoft.IdentityModel (dans microsoft.identitymodel.dll)

Utilisation

    Dim instance As WSTrustServiceHost

Syntaxe

'Déclaration
Public Class WSTrustServiceHost
    Inherits ServiceHost

public class WSTrustServiceHost : ServiceHost

public ref class WSTrustServiceHost : public ServiceHost

public class WSTrustServiceHost extends ServiceHost

public class WSTrustServiceHost extends ServiceHost

Exemple

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( "https://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( "https://localhost:6000/SimpleActiveSTS" ) ) )
    {
        host.Open();
        Console.WriteLine( "SimpleActiveSTS started, press ENTER to stop ..." );
        Console.ReadLine();

Remarques

The WSTrustServiceHost class is the WIF (Windows® Identity Foundation) 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 is a fully functioning ServiceHost which 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 performs the following:

It adds WS-Trust endpoints to the ServiceHost based on SecurityTokenServiceConfiguration.TrustEndpoints.
It enables metadata over the base addresses if SecurityTokenServiceConfiguration.DisableWsdl is set to false.
Thirdly, 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.
Fourthly, it integrates WIF token handlers into the security processing pipeline by calling ExtensibleSecurityCredentials.ConfigureServiceHost() on itself.

The WSTrustServiceHost class may be overridden to customize this behavior.

Hiérarchie d'héritage

System.Object
   System.ServiceModel.Channels.CommunicationObject
     System.ServiceModel.ServiceHostBase
       System.ServiceModel.ServiceHost
        Microsoft.IdentityModel.Protocols.WSTrust.WSTrustServiceHost

Cohérence de thread

Tous les membres statiques publics (partagés dans Visual Basic) de ce type sont thread-safe.Il n'est pas garanti que les membres d'instance soient thread-safe.

Plateformes

Plateformes de développement

Windows Server 2003, Windows Vista

Target Platforms

Windows Server 2008, Windows Vista, Not tested on Windows XP

Change History

Voir aussi

Référence

Membres WSTrustServiceHost
Espace de noms Microsoft.IdentityModel.Protocols.WSTrust

Partager via