UsernameOverTransportAssertion Class

  • Article

Represents a turnkey security assertion that authenticates the client using a UsernameToken security token. The SOAP message is not encrypted or digitally signed, so a secure transport should be used with this assertion. WS-Security 1.1 or 1.0 can be used with this assertion.

Namespace: Microsoft.Web.Services3.Design
Assembly: Microsoft.Web.Services3 (in microsoft.web.services3.dll)

Usage

'Usage
Dim usernameOverTransportAssertion1 As New UsernameOverTransportAssertion()

Syntax

'Declaration
Public Class UsernameOverTransportAssertion
    Inherits PolicyAssertion

public class UsernameOverTransportAssertion : PolicyAssertion

public ref class UsernameOverTransportAssertion : PolicyAssertion

public class UsernameOverTransportAssertion extends PolicyAssertion

public class UsernameOverTransportAssertion extends PolicyAssertion

Remarks

Given that most applications are secured based on the network topology in which the Web service resides, WSE 3.0 introduces a scenario-based methodology to secure communication to and from a Web service. That is, instead of piecing security together for an application using multiple low-level security operations, WSE allows you to apply security at a higher level using a prepackaged set of security operations, which are known as security assertions. For common scenarios, WSE provides a set of these security assertions that are called turnkey security assertions.

A turnkey security assertion can be used with or without a policy file. To use the UsernameOverTransportProfile turnkey assertion without a policy file, use the UsernameOverTransportAssertion class and the process specified in the How to: Secure a Web Service Without Using a Policy File topic. To use the UsernameOverTransportSecurity turnkey assertion with a policy file, use the <UsernameOverTransportSecurity> Element with the process specified in the How to: Secure a Web Service Using a Policy File topic.

When you use the usernameOverTransportSecurity policy assertion in a policy file, it is recommended that you do not specify the client's user name and password in the policy file.

Inheritance Hierarchy

System.Object
   Microsoft.Web.Services3.Design.PolicyAssertion
    Microsoft.Web.Services3.Design.UsernameOverTransportAssertion

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows 2000, Windows 2000 Server, Windows 2000 Advanced Server

Target Platforms

See Also

Reference

UsernameOverTransportAssertion Members
Microsoft.Web.Services3.Design Namespace

Other Resources

<UsernameOverTransportSecurity> Element
How to: Secure a Web Service Without Using a Policy File
How to: Secure a Web Service Using a Policy File