EncryptedKeyToken Class

  • Article

Represents a security token for an encrypted symmetric key.

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

Usage

'Usage
Dim encryptingToken As SecurityToken
Dim encryptedKeyToken1 As New EncryptedKeyToken(encryptingToken)

Syntax

'Declaration
Public Class EncryptedKeyToken
    Inherits SecurityToken
    Implements IDerivableToken

public class EncryptedKeyToken : SecurityToken, IDerivableToken

public ref class EncryptedKeyToken : SecurityToken, IDerivableToken

public class EncryptedKeyToken extends SecurityToken implements IDerivableToken

public class EncryptedKeyToken extends SecurityToken implements IDerivableToken

Remarks

Use the EncryptedKeyToken security token when a symmetric key is desired, but the available security credentials are asymmetric. Cryptographic operations are generally much slower when computed with asymmetric keys than symmetric keys. A common example of this is when a client attempts to communicate with a Web service and it has the public key for a Web service's X.509 certificate, which is the public key of an asymmetric key pair. To use a symmetric key to protect the SOAP message instead, use the EncryptedKeyToken security token. That symmetric key is then encrypted using the public key of the X.509 certificate, such that only the Web service can decrypt it, and then include it in the SOAP message. This allows for SOAP messages to be protected using existing security credentials and for more efficient cryptographic operations.

The <anonymousForCertificateSecurity> Element, <mutualCertificate10Security> Element, <mutualCertificate11Security> Element, and <usernameForCertificateSecurity> Element turnkey assertions use the EncryptedKeyToken security token to secure SOAP messages.

Inheritance Hierarchy

System.Object
   Microsoft.Web.Services3.Security.Tokens.SecurityToken
    Microsoft.Web.Services3.Security.Tokens.EncryptedKeyToken

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

EncryptedKeyToken Members
Microsoft.Web.Services3.Security.Tokens Namespace