Condividi tramite


UsernameForCertificateAssertion Class

Represents a turnkey security assertion that uses an X509SecurityToken security token to protect SOAP messages. The client is authenticated using a UsernameToken security token. WS-Security 1.1 is required for this assertion.

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

Usage

'Usage
Dim usernameForCertificateAssertion1 As New UsernameForCertificateAssertion()

Syntax

'Declaration
Public Class UsernameForCertificateAssertion
    Inherits SecurityPolicyAssertion
public class UsernameForCertificateAssertion : SecurityPolicyAssertion
public ref class UsernameForCertificateAssertion : SecurityPolicyAssertion
public class UsernameForCertificateAssertion extends SecurityPolicyAssertion
public class UsernameForCertificateAssertion extends SecurityPolicyAssertion

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 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 usernameForCertificate turnkey assertion without a policy file, use the UsernameForCertificateAssertion class and the process specified in the How to: Secure a Web Service Without Using a Policy File topic. To use the usernameForCertificate turnkey assertion with a policy file, use the <usernameForCertificate> Element with the process specified in the How to: Secure a Web Service Using a Policy File topic.

Inheritance Hierarchy

System.Object
   Microsoft.Web.Services3.Design.PolicyAssertion
     Microsoft.Web.Services3.Design.SecurityPolicyAssertion
      Microsoft.Web.Services3.Design.UsernameForCertificateAssertion

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

UsernameForCertificateAssertion Members
Microsoft.Web.Services3.Design Namespace

Other Resources

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