IBM Support

SI63760 - OSP-IWS Support SSL over proxy in the client (IFS)

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP-IWS Support SSL over proxy in the client (IFS)


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED           PTF/FIX  LEVEL

TYPE PROGRAM  RELEASE   NUMBER   MIN/MAX  OPTION
---- -------- --------- -------  -------  ------
PRE  5770SS1  V7R2M0    SI62168   NONE     0003
PRE  5770SS1  V7R2M0    SI56274   NONE     0003
PRE  5770SS1  V7R2M0    SI55447   NONE     0003
CO   5770SS1  V7R2M0    SI63729   NONE     0003
CO   5770SS1  V7R2M0    SI60806   NONE     0003



NOTICE:
-------
Application of this PTF may disable or render ineffective programs that
use system memory addresses not generated by the IBM translator,
including programs that circumvent control technology designed to limit
interactive capacity to purchased levels.  This PTF may be a prerequisite
for future PTFs.  By applying this PTF you authorize and agree to the
foregoing.

This PTF is subject to the terms of the license agreement which
accompanied, or was contained in, the Program for which you are obtaining
the PTF.  You are not authorized to install or use the PTF except as part
of a Program for which you have a valid Proof of Entitlement.

SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT AS EXPLICITLY
AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR AN APPLICABLE SUPPORT
AGREEMENT, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON INFRINGEMENT,
REGARDING THE PTF.

The applicable license agreement may have been provided to you in printed
form and/or may be viewed using the Work with Software Agreements (WRKSFWAGR)
CL command.





APAR Error Description / Circumvention

-----------------------------------------------
The integrated web services client for ILE does not support
using SSL when connecting to a proxy server.

CORRECTION FOR APAR SE66569 :
-----------------------------
The client transport support has been enhanced to support SSL
when connecting to a proxy server. The support includes:

(1) The ability to use a secure channel (SSL) when connecting to
a proxy server. In order to indicate that SSL is to be used when
connecting to the proxy server, a call to the API
axiscStubSetProxySSL must be made:

RPG: axiscStubSetProxySSL(WsStub.handle: 1);

C:   axiscStubSetProxySSL(handle, 1);


(2) The ability to perform SSL tunneling when connecting to a
proxy server over an unsecure channel.  In SSL tunneling,
encrypted data is passed through the proxy server unaltered.
This will happen automatically if the web service endpoint uses
the 'https' protocol.

CIRCUMVENTION FOR APAR SE66569 :
--------------------------------
None.


Activation Instructions


None.




Special Instructions


End all integrated web services servers.

********************************************************************
THE FOLLOWING ARE SUPERSEDED SPECIAL INSTRUCTIONS. IF THE SUPERSEDED
PTF HAS ALREADY BEEN APPLIED AND ITS SPECIAL INSTRUCTION FOLLOWED,
IT IS NOT NECESSARY TO FOLLOW THAT SPECIAL INSTRUCTION AGAIN.
********************************************************************

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI63373 :
=================================================

In order to get the enhancements
provided by this PTF, you will
need to redeploy the web service
after applying the PTF.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI62768 :
=================================================

End all integrated web services servers.

After applying PTF, redeploy the web service.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI62633 :
=================================================

End any integrated web services servers
that are running.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI62415 :
=================================================

End any integrated web services servers that
are running.

You will need to regenerate any integrated Web
services client stubs in order to pick up the
fixes packaged as part of this PTF.

In general, it is recommended that you regenerate
any integrated Web services client stubs in order
to pick up the latest updates in the stub-generation
tools, wsdl2ws.sh and wsdl2rpg.sh, even if you have
not encountered any errors.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI58316 :
=================================================

End all integrated web services servers.

You will need to regenerate any integrated web
services client stubs in order to pick up the
fixes packaged as part of this PTF.

In general, it is recommended that you regenerate
any integrated web services client stubs in order
to pick up the latest updates in the stub-generation
tools, wsdl2ws.sh and wsdl2rpg.sh, even if you have
not encountered any errors.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI57437 :
=================================================

After applying PTF, regenerate the stub.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI55911 :
=================================================

You will need to regenerate any integrated Web
services client stubs in order to pick up the
fixes packaged as part of this PTF.

In general, it is recommended that you regenerate
any integrated Web services client stubs in order
to pick up the latest updates in the stub-generation
tools, wsdl2ws.sh and wsdl2rpg.sh, even if you have
not encountered any errors.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI53439 :
=================================================

Subsystem qhttpsvr must be ended. In addition,
any integrated web services servers must
also be ended.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI63573      OSP-IWS SETTING CONTEXT ROOT TO FORWARD SLASH (/) MAKES SERV
   SI63573      OSP-IWS INSTALLWEBSERVICE WITH FIX SI63374 (SWAGGER SUPPORT)
   SI63373      OSP-IWS Add ability to control wrapper element identifier
   SI62768      OSP-IWS ALLOW 1.3/1.5 SERVERS TO ACCEPT EMPTY ELEMENTS FOR N
   SI62633      OSP-IWS Internal changes for future extensions
   SI62415      OSP-IWS INSTALLWEBSERVICE.SH SCRIPT DOES NOT ALLOW TARGETNAM
   SI62415      OSP-IWS CONSTANT INTEGERS BEING INITIALIZED TO STRINGS
   SI61495      OSP-IWS WSDL2RPG FAILS BECAUSE OF LARGE ELEMENT NAME
   SI61035      OSP-IWS Infrastructure updates for future extensions
   SI60809      OSP-IWS Client Axis.rpgleinc file updates
   SI60721      OSP-IWS UNABLE TO DEPLOY PROCEDURE THAT RETURNS AN INTEGER
   SI60721      OSP-IWS RESTOREWEBSERVICES.SH INCORRECTLY MODIFIES REST SERV
   SI60360      OSP-IWS Allow REMOTE_USER to be passed to web service as env
   SI60193      OSP-IWS BAD NUMERIC DATA IN SOAP REQUEST NOT DETECTED
   SI59961      OSP-IWS Nested arrays not being returned correctly by server
   SI59020      OSP-IWS New client APIs for REST requests (IFS updates)
   SI58316      OSP-IWS STUBS DO NOT COMPILE WHEN WSDL CONTAINS '-'
   SI58221      OSP-IWS CPF2103 MSG IS CAUSING WEB SERVICE FAILURE
   SI58063      OSP-IWS INSTALLWEBSERVICE.SH USING PCML REST ATTRIBUTES NOT
   SI58063      OSP-IWS HOST SERVER CONNECTION NOT CLOSED AFTER EXCEPTION
   SI57976      OSP-IWS WSDL2WS FAILS NULLPOINTEREXCEPTION AND 'UNKNOWN SOUR
   SI57676      OSP-IWS ADD SUPPORT FOR REST IN  INSTALLWEBSERVICE.SH SCRIPT
   SI57437      OSP-IWS MSGCZM0021 CZM0021 ON CRTCMOD AS PART OF WSDL2WS
   SI57437      OSP-IWS WSDL2WS VARIANT CHARACTERS CAUSE RPG COMPILE FAILURE
   SI56823      OSP-IWS Web services server enhancements
   SI56823      OSP-IWS InstallWebService.sh enhancements
   SI56430      OSP-IWS Deployment errors with nested arrays
   SI56327      OSP-IWS STARTWEBSERVICE.SH RESULTS IN COMMAND FAILED
   SI56245      OSP-IWS Re-organize bean generation code
   SI56181      OSP-IWS ERROR WHEN SENDING JSON ARRAY TO REST WEB SERVICE
   SI56130      OSP-IWS web service fails to report errors when invoked
   SI55911      OSP-IWS StackOverflowError error in WSDL2WS.SH
   SI55558      OSP-IWS Server - internal infrastructure enhancements.
   SI55507      OSP-IWS RPG stub compile failure due to leading underscore
   SI55434      OSP-IWS WSDL2RPG.WS FAILS WITH "UNKNOWN DATA TYPE"
   SI54945      OSP-IWS Infrastructure changes for future enhancements
   SI54059      OSP-IWS WSDL2WS FAILS W/-LRPG OPTION DUE XSD:IDREF IN WSDL
   SI53439      OSP-IWS Deployment to V1.5 servers do not work
   SI53439      OSP-IWS handling nil array elements going from 1.3 to 1.5
   SI52756      OSP-IWS web services updates
   SI51528      OSP-IWS createwebservicesserver.sh script fails with latest

Summary Information

System..............................i
Models..............................
Release.............................V7R2M0
Licensed Program...............5770SS1
APAR Fixed..........................View details for APAR SE66569
Superseded by:......................View fix details for PTF SI78848
Recompile...........................N
Library.............................QSYSDIR
MRI Feature ........................NONE
Cum Level...........................NONE


IBM i Support

IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright © 1996,1997,1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult the Terms of use link for trademark information.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.2.0","Product":{"code":"SWG60","label":"IBM i"},"Component":"5770SS1","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Document Information

Modified date:
25 February 2022