New IMS Enterprise Suite V2.2 SOAP Gateway example: Web service provider with SAML signed assertion security (z/OS platform, XMLBeans approach)
This sample takes you through the steps to enable an IMS™ application as a web service by using the IMS Phonebook sample application (IVTNO). This sample demonstrates how to enable web services security using Security Assertion Markup Language (SAML) 2.0 signed assertion, and how to create a client application for secure HTTPS communication to the IMS Phonebook web service that is deployed on the SOAP Gateway server on z/OS®.
The Enterprise Modernization for System z Sandbox is a cloud-based demo environment where you can test out some of the most popular new features in IMS. The following hands-on step by step exercises have just been added or updated:
This sample includes java and CAM files that demonstrate the basics of the SOAP Gateway custom authentication module function for both SAML and UNTP security. You can use custom authentication modules to provide additional security checks on SOAP requests before SOAP Gateway routes them to IMS Connect. The sample zip file is available here: https://www.ibm.com/developerworks/mydeveloperworks/groups/service/html/communityview?communityUuid=8a337b1c-3c0c-48a5-b7cc-7f805884dbb9#fullpageWidgetId=W6f81c5cbb9d6_4ff0_b5fd_e730ec47ced2&file=46b01f8d-0daa-41c7-87f4-2db1e294fe6a
The included code comments contain additional information. Also see this topic in the IMS Enterprise Suite 2.1 SOAP Gateway information center: http://publib.boulder.ibm.com/infocenter/dzichelp/v2r2/topic/com.ibm.ims.soap21.doc/sgw_sec_provider_customauthmod.htm
In this overview video, we describe the new installation process for the IMS Enterprise Suite 2.2 version of SOAP Gateway on the z/OS platform. We explain the new installation architecture and its benefits, what IBM Installation Manager for z/OS is, why you should use it to install SOAP Gateway, and how the installation process generally works. Two additional videos then demonstrate how to install IBM Installation Manager for z/OS and how to install and configure SOAP Gateway for use.
Watch on YouTube: http://www.youtube.com/watch?v=uiOZKtyXJ8c&feature=plcp&list=PLeVzecbkl8Bwu9R-JV_Z-GokxgZD1_VSs
Transcript for Part 1: https://www.ibm.com/developerworks/mydeveloperworks/files/app/person/270002MTAW/file/e0a1074b-5683-42bb-9ba3-fdbe374d7974
Transcript for Part 2: https://www.ibm.com/developerworks/mydeveloperworks/files/app/person/270002MTAW/file/9f753f29-d1e9-4275-82ca-772c659a0136
DavidHanson 270002MTAW 2,810 Views
A new set of pre-generated sample artifacts has been made available so that the callout application with SAML security tutorial (located at http://www-01.ibm.com/support/docview.wss?uid=swg27036434) can be used with the latest version of IMS Enterprise Suite SOAP Gateway, version 3.1. Download the new artifacts here: https://www.ibm.com/developerworks/community/files/app/file/b265e36d-3f65-4f06-a88a-ba8f9712c232.
DavidHanson 270002MTAW 3,462 Views
Starting with the IMS Enterprise Suite V2.2, SOAP Gateway installation on the z/OS platform requires the use of IBM Installation Manager for z/OS. In addition, a three-part installation architecture is introduced to enhance the server’s security and the ability to add more disk space without interrupting server operations when demands for web services increase. This installation architecture and the installation process is generally the same in IMS Enterprise Suite V3.1.
If you are new to SOAP Gateway, you can watch the IMS Enterprise Suite V2.2 SOAP Gateway installation on z/OS video series to get acquainted with the general process. The video series is available on YouTube: http://www.youtube.com/watch?v=uiOZKtyXJ8c&feature=plcp&list=PLeVzecbkl8Bwu9R-JV_Z-GokxgZD1_VSs
The following sections describe what the videos cover and point out the differences between V2.2 and V3.1 installation steps.
Video 1: IMS Enterprise Suite V2.2 SOAP Gateway: Installation using IBM Installation Manager for z/OS
You can download the video transcript here: https://www.ibm.com/developerworks/mydeveloperworks/files/app/person/270002MTAW/file/e0a1074b-5683-42bb-9ba3-fdbe374d7974
Video 2: IMS Enterprise Suite V2.2 SOAP Gateway installation series, Part II: Installing IBM Installation Manager for z/OS
This video demonstrates how to install IBM Installation Manager for z/OS, which is required before you can install SOAP Gateway. The same version of IBM Installation Manager for z/OS is included IMS Enterprise Suite V3.1, so the installation process described in this video is the same for V3.1.
You can download the video transcript here:
Video 3: IMS Enterprise Suite V2.2 SOAP Gateway installation series, Part III: Installing SOAP Gateway
This video demonstrates how to install SOAP Gateway using IBM Installation Manager. This general process applies to IMS Enterprise Suite 3.1, although the actual FMIDs and the provided sample JCLs for installation and configuration are somewhat different between Version 3.1 and Version2.2.
For IMS Enterprise Suite 3.1, several of the sample installation jobs have changed. While you can watch the video to get a general idea of the steps involved, ensure that you follow the steps described in the following topics in the SOAP Gateway documentation instead:
For an overall installation roadmap that covers different installation scenarios and other potential configuration steps, see the Installing SOAP Gateway on z/OS topic here: http://publib.boulder.ibm.com/infocenter/dzichelp/v2r2/topic/com.ibm.ims.soap31.doc/sgw_install_z31.htm
z/OS Management Facility workflow samples for compiling IMS Enterprise Suite SOAP Gateway XML converters
The samples provided here demonstrate how you can use IBM® z/OS® Management Facility (z/OSMF) workflows to compile and bind IMS™ Enterprise Suite SOAP Gateway XML converters.
By taking advantage of the supportive framework of user input validation, tool tips and online user assistance in z/OSMF, tasks in a z/OSMF workflow can help guide the activities for those responsible for compiling and binding the XML converters in the form of structured procedures known as workflows.
Two workflow XML files are provided in this sample:
The workflow samples simplify the converter compilation task by by collecting the required information and executing the job through a web interface, and thereby reduce potential typos and user errors.
The provided workflow samples are developed and tested with the following software:
Download the zOSMF_Workflows_IMSSOAP_xmlconverterszip file. Extract this file and you will find the following files: