Share via


DerivedKeyToken Class

Represents a security token whose key is cryptographically derived from the key of another security token.

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

Usage

'Usage
Dim parent As IDerivableToken
Dim derivedKeyToken1 As New DerivedKeyToken(parent)

Syntax

'Declaration
Public Class DerivedKeyToken
    Inherits SecurityToken
    Implements IDerivableToken, IMutableSecurityToken
public class DerivedKeyToken : SecurityToken, IDerivableToken, IMutableSecurityToken
public ref class DerivedKeyToken : SecurityToken, IDerivableToken, IMutableSecurityToken
public class DerivedKeyToken extends SecurityToken implements IDerivableToken, IMutableSecurityToken
public class DerivedKeyToken extends SecurityToken implements IDerivableToken, , IMutableSecurityToken

Remarks

Using a DerivedKeyToken can help secure a series of SOAP messages by allowing you to encrypt or sign each SOAP message using a different key--a key that is cryptographically derived from the original key. Signing and/or encrypting the SOAP messages using different keys can help prevent a ciphertext-only attack, which attempts to recover the original key from a series of encrypted SOAP messages.

To create a DerivedKeyToken , pass a security token that supports security token derivation, such as a KerberosToken or SecurityContextToken , to the DerivedKeyToken constructor. Add the DerivedKeyToken instance and the parent security token to the Tokens collection of the SoapContext for the SOAP message. If the parent security token was derived from a security token, then that grandparent security token must be added to the Tokens collection as well. To then sign and or encrypt the SOAP message using the DerivedKeyToken , create a new instance of the EncryptedData or MessageSignature class, passing in the instance of DerivedKeyToken to the constructor as you would for any other security token type.

Inheritance Hierarchy

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

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

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