Class WSBaseMessage

java.lang.Object

org.apache.ws.security.message.WSBaseMessage

Direct Known Subclasses:

WSAddSignatureConfirmation, WSAddTimestamp, WSEncryptBody, WSSAddSAMLToken, WSSAddUsernameToken, WSSignEnvelope

public class WSBaseMessage
extends Object

This is the base class for WS Security messages. It provides common functions and fields used by the specific message classes such as sign, encrypt, and username token.

Author:

Werner Dittmann (Werner.Dittmann@t-online.de)

Field Summary

Fields

Modifier and Type	Field	Description
protected String	actor
protected boolean	doDebug
protected int	keyIdentifierType
protected boolean	mustunderstand
protected Vector	parts
protected String	password
protected int	timeToLive
protected String	user
protected WSSConfig	wssConfig

Constructor Summary

Constructors

Constructor	Description
WSBaseMessage()	Deprecated. replaced by WSSecBase()
WSBaseMessage(String actor)	Deprecated. replaced by WSSecBase() and WSSecHeader for actor specification.
WSBaseMessage(String actor, boolean mu)	Deprecated. replaced by WSSecBase() and WSSecHeader for actor and mustunderstand specification.

Method Summary

Modifier and Type	Method	Description
int	getKeyIdentifierType()	Deprecated. replaced by WSSecBase.getKeyIdentifierType()
protected Element	insertSecurityHeader(Document doc)	Deprecated. replaced by WSSecHeader.insertSecurityHeader(Document)
void	setActor(String act)	Deprecated. replaced by WSSecHeader.setActor(String)
protected String	setBodyID(Document doc)	Deprecated. replaced by WSSecBase.setBodyID(Document)
void	setKeyIdentifierType(int keyIdType)	Deprecated. replaced by WSSecBase.setKeyIdentifierType(int)
void	setMustUnderstand(boolean mu)	Deprecated. replaced by WSSecHeader.setMustUnderstand(boolean)
void	setParts(Vector parts)	Deprecated. replaced by WSSecBase.setParts(Vector)
void	setTimeToLive(int ttl)	Deprecated. replaced by WSSecTimestamp.setTimeToLive(int)
void	setUserInfo(String user, String password)	Deprecated. replaced by WSSecBase.setUserInfo(String, String)
void	setWsConfig(WSSConfig wsConfig)	Deprecated. replaced by WSSecBase.setWsConfig(WSSConfig)
protected String	setWsuId(Element bodyElement)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

actor

protected String actor

mustunderstand

protected boolean mustunderstand

user

protected String user

password

protected String password

keyIdentifierType

protected int keyIdentifierType

parts

protected Vector parts

timeToLive

protected int timeToLive

doDebug

protected boolean doDebug

wssConfig

protected WSSConfig wssConfig

Constructor Details

WSBaseMessage

public WSBaseMessage()

Deprecated.

replaced by WSSecBase()

Constructor.

WSBaseMessage

public WSBaseMessage(String actor)

Deprecated.

replaced by WSSecBase() and WSSecHeader for actor specification.

Constructor.

Parameters:

actor - The actor name of the wsse:Security header

WSBaseMessage

public WSBaseMessage(String actor,
 boolean mu)

Deprecated.

replaced by WSSecBase() and WSSecHeader for actor and mustunderstand specification.

Constructor.

Parameters:

actor - The actor name of the wsse:Security header

mu - Set mustUnderstand to true or false

Method Details

setActor

public void setActor(String act)

Deprecated.

replaced by WSSecHeader.setActor(String)

set actor name.

Parameters:

act - The actor name of the wsse:Security header

setTimeToLive

public void setTimeToLive(int ttl)

Deprecated.

replaced by WSSecTimestamp.setTimeToLive(int)

Set the time to live. This is the time difference in seconds between the Created and the Expires in Timestamp.

Parameters:

ttl - The time to live in second

setParts

public void setParts(Vector parts)

Deprecated.

replaced by WSSecBase.setParts(Vector)

Set which parts of the message to encrypt/sign.

Parameters:

parts - The vector containing the WSEncryptionPart objects

setMustUnderstand

public void setMustUnderstand(boolean mu)

Deprecated.

replaced by WSSecHeader.setMustUnderstand(boolean)

Set the mustUnderstand flag for the wsse:Security header

Parameters:

mu - Set mustUnderstand to true or false

setKeyIdentifierType

public void setKeyIdentifierType(int keyIdType)

Deprecated.

replaced by WSSecBase.setKeyIdentifierType(int)

Sets which key identifier to use.

Defines the key identifier type to use in the signature or the ecnryption function to set up the key identification elements.

Parameters:

keyIdType -

See Also:

• WSConstants.ISSUER_SERIAL
• WSConstants.BST_DIRECT_REFERENCE
• WSConstants.X509_KEY_IDENTIFIER
• WSConstants.SKI_KEY_IDENTIFIER

getKeyIdentifierType

public int getKeyIdentifierType()

Deprecated.

replaced by WSSecBase.getKeyIdentifierType()

Gets the value of the keyIdentifyerType.

Returns:

The keyIdentifyerType.

See Also:

• WSConstants.ISSUER_SERIAL
• WSConstants.BST_DIRECT_REFERENCE
• WSConstants.X509_KEY_IDENTIFIER
• WSConstants.SKI_KEY_IDENTIFIER

setWsConfig

public void setWsConfig(WSSConfig wsConfig)

Deprecated.

replaced by WSSecBase.setWsConfig(WSSConfig)

Parameters:

wsConfig - The wsConfig to set.

setBodyID

protected String setBodyID(Document doc)
                    throws Exception

Deprecated.

replaced by WSSecBase.setBodyID(Document)

Looks up or adds a body id.

First try to locate the wsu:Id in the SOAP body element. If one is found, the value of the wsu:Id attribute is returned. Otherwise the methode generates a new wsu:Id and an appropriate value.

Parameters:

doc - The SOAP envelope as Document

Returns:

The value of the wsu:Id attribute of the SOAP body

Throws:

Exception

setWsuId

protected String setWsuId(Element bodyElement)

setUserInfo

public void setUserInfo(String user,
 String password)

Deprecated.

replaced by WSSecBase.setUserInfo(String, String)

Set the user and password info.

Both information is used to get the user's private signing key.

Parameters:

user - This is the user's alias name in the keystore that identifies the private key to sign the document

password - The user's password to get the private signing key from the keystore

insertSecurityHeader

protected Element insertSecurityHeader(Document doc)

Deprecated.

replaced by WSSecHeader.insertSecurityHeader(Document)

Creates a security header and inserts it as child into the SOAP Envelope.

Check if a WS Security header block for an actor is already available in the document. If a header block is found return it, otherwise a new wsse:Security header block is created and the attributes set

Parameters:

doc - A SOAP envelope as Document

Returns:

A wsse:Security element