Package com.sun.xml.wss

Interface XWSSProcessor

All Known Implementing Classes:
XWSSProcessor2_0Impl
public interface XWSSProcessor
XWSSProcessor interface defines methods for
  • Securing an outbound SOAPMessage
  • Verifying the security in an inbound SOAPMessage
An XWSSProcessor can add/verify Security in a SOAPMessage as defined by the OASIS WSS 1.0 specification.

  • Method Details

    • secureOutboundMessage

      SOAPMessage secureOutboundMessage(ProcessingContext messageCntxt) throws XWSSecurityException
      Adds Security to an outbound SOAPMessage according to the Security Policy inferred from the SecurityConfiguration with which this XWSSProcessor was initialized.
      Parameters:
      messageCntxt - the SOAP ProcessingContext containing the outgoing SOAPMessage to be secured
      Returns:
      the resultant Secure SOAPMessage
      Throws:
      XWSSecurityException - if there was an error in securing the message.

    • verifyInboundMessage

      SOAPMessage verifyInboundMessage(ProcessingContext messageCntxt) throws XWSSecurityException
      Verifies Security in an inbound SOAPMessage according to the Security Policy inferred from the SecurityConfiguration with which this XWSSProcessor was initialized.
      Parameters:
      messageCntxt - the SOAP ProcessingContext containing the outgoing SOAPMessage to be secured
      Returns:
      the resultant SOAPMessage after successful verification of security in the message
      Throws:
      XWSSecurityException - if there was an unexpected error while verifying the message.OR if the security in the incoming message violates the Security policy that was applied to the message.
      WssSoapFaultException - when security in the incoming message is in direct violation of the OASIS WSS specification. When a WssSoapFaultException is thrown the getFaultCode() method on it will return a QName which would correspond to the WSS defined fault.

    • createProcessingContext

      ProcessingContext createProcessingContext(SOAPMessage msg) throws XWSSecurityException
      Create a Processing Context initialized with the given SOAPMessage
      Parameters:
      msg - the SOAPMessage with which to initialize the ProcessingContext
      Returns:
      A ProcessingContext instance.
      Throws:
      XWSSecurityException