Documente Academic
Documente Profesional
Documente Cultură
TechDoc
WebSphere Message Broker / IBM Integration Bus
March 2015 - IBM Message Broker - Administration – Using Policy Sets for SOAP Nodes
Author(s): Glen Brumbaugh
Table of Contents
Introduction .................................................................................................................................................. 3
Document Version .................................................................................................................................... 3
Product Naming History ............................................................................................................................ 3
Product Component Terminology ............................................................................................................ 4
Message Broker Policy Sets .......................................................................................................................... 4
Overview ................................................................................................................................................... 4
Default Objects ......................................................................................................................................... 5
Handling Policy Sets and Bindings ................................................................................................................ 5
Defining Configurable Services ................................................................................................................. 5
Importing Policy Sets and Bindings ........................................................................................................... 5
Display the linkage between Policy Sets and Bindings ............................................................................. 6
Exporting Policy Sets and Bindings ........................................................................................................... 6
Relating Policy Sets and Bindings to Message Flows and Nodes .................................................................. 6
Configuring WS-Security properties ............................................................................................................. 7
Authentication and Tokens – Policy Set................................................................................................ 7
Authentication and Tokens – Binding ................................................................................................... 7
Configuring WS-RM properties ..................................................................................................................... 7
Best Practices ................................................................................................................................................ 8
References .................................................................................................................................................... 8
Page 2 of 8
Introduction
Document Version
This document describes how to configure and use Policy Sets with Message Broker SOAP nodes.
The Message Flow nodes that use Policy Sets are:
• SOAPInput
• SOAPReply
• SOAPRequest
• SOAPAsyncRequest
• SOAPAsyncResponse
Policy Sets contain WS-Security (Web Security XML specification) and WS-RM (Web Reliable
Messaging XML specification) specifications. This document should apply to any version of the
Message Broker product that supports these Message Flow nodes. The contents of this document
have been specifically verified on the following production versions:
• WebSphere Message Broker v7.0.0.2
• IBM Integration Bus v9.0.0.0
This documentation has been created and maintained by:
• Glen Brumbaugh
This documentation has been reviewed by:
• Glen Brumbaugh
This documentation was last updated:
• Version 1.0 March 2015
Page 3 of 8
For the remainder of this document, the product will be referred to as “Message Broker”. This is
both for historical reasons and to signify that this documentation applies to both the WMB and IIB
product versions.
Page 4 of 8
Table 1 - SOAP Nodes and their Roles
Message Broker Point of View (PoV)
Node Request Response Initiator Recipient
SOAP Input Inbound Msg External Client SOAP Input Node
SOAP Reply Outbound Msg External Client SOAP Reply Node
SOAP Request Outbound Msg Inbound Msg SOAP Request Node External Client
SOAP Async Request Outbound Msg SOAP Async Rqst External Client
SOAP Async Response Inbound Msg SOAP Async Rspnce External Client
Default Objects
When a Message Broker is created, a default Policy Set and its Binding is created. The names of
these default objects are as follows:
• WSS10Default (Policy Set for WS-Security; Request messages contain Username token)
• WSRMDefault (Policy Set for WS-RM; no associated Binding)
• WSS10Default (Binding; refers to WSS10Default Policy Set, not to WSRMDefault!)
Page 5 of 8
Once the Policy Set and its Bindings have been imported, the Binding must be re-linked with its
associated Policy Set. This is done using the following command:
• mqsichangeproperties BrokerName -c PolicySetBindings -o ExistingPolicySetBinding -n
associatedPolicySet -v ExistingPolicySet
Note that the Execution Group must be stopped and restarted before these changes can take effect.
Page 6 of 8
Message Flow Node Properties
• Policy Set
• Policy Set Bindings
Page 7 of 8
Best Practices
• XML File Names: There can potentially be a number of different Policy Set and Binding files. All
of these files will have an “.xml” file extension. Since Policy Set and Binding files need to be
related to one another, a naming approach that relates one or more Binding files to its
associated Policy Set file is required. It is recommended that these two groups of files begin
with the same character string so that they sort together. After this common beginning, the
Binding files should be further named so that their relationship to a Message Flow or Node can
easily be determined.
References
o IBM – Knowledge Center – IIB – v9.0 – Setting up Message Flow Security
http://www-
01.ibm.com/support/knowledgecenter/api/content/SSMKHH_9.0.0/com.ibm.etools.mft.doc/ap
04170_.htm
o IBM – Knowledge Center – IIB – v9.0 – Associate Policy Sets & Bindings with Message Flows
http://www-
01.ibm.com/support/knowledgecenter/api/content/SSMKHH_9.0.0/com.ibm.etools.mft.doc/ac
60120_.htm
o IBM – Knowledge Center – IIB – v9.0 – Policy Sets & Bindings Editor
http://www-
01.ibm.com/support/knowledgecenter/api/content/SSMKHH_9.0.0/com.ibm.etools.mft.doc/ab
60180_.htm
Page 8 of 8