bvstone

GETURI, MAILTOOL and SSL Protocol Versions Update

Posted:

GETURI, MAILTOOL and SSL Protocol Versions Update

I'm sure we've all heard of the HeartBleed security issues on systems based on the OpenSSL platform.  Because of this, people assume the IBM i is affected and are being required to update their SSL/TLS processing defaults to use newer versions of TLS (mainly v1.1 or higher) for PCI compliance.   

Recently we had a customer on V7R1 run into issues with GETURI and the SSL versions they were using because of PCI compliance.  They need to use TLS v1.1 or TLS v1.2.  This means changing the system value for QSSLPCL to *TLSV1.1 *TLSV1.2.

Because MAILTOOL also uses the same system SSL APIs this will apply to that as well.

The problem occurred when running GETURI and they were receiving a return code error of -13 (SSL_ERROR_UNSUPPORTED).  If they added *TLSV1.0 back into the system value for QSSLPCL things worked fine.  But, that means they were not PCI compliant.

Right away I got a virtual loaner system on V7R2 to test.  Things worked fine there as well.  So, it seems like on V7R1 there are some issues with SSL and they're not quite caught up with PTFs available.

The customer worked with IBM and after many days they offered a workaround to change the SSL version used on the SSL Handshake operation.  The default has always been zero (which should work, and IBM even admitted to this).  They said to try versions of 4, 7 or 8 (version values can be seen here).  Part of the conversation is as follows:

 It appears to me that the applications is calling SSL_Handshake(), and in the SSLHandleStr is using Protocol 0: SSL_Version_Current.
On R720 GA, that is [TLSv1.2, TLSv1.1, TLSv1].
On R710 GA, that is [TLSv1, SSLv3].
  When SSLv3 and TLSv1 are both disabled via QSSLPCL, there are no matching protocols available, which results in the 'not supported' return code.
  When TLSv1.2 and TLSv1.1 were added in TR6, I would have expected SSL_VERSION_CURRENT to adapt, but perhaps it is still working with the default shipped values, or perhaps it is using the versions that were available when the application was compiled.

  This is the table from InfoCenter, the API definition:
SSL_VERSION_CURRENT          0  (Uses the default protocols as determined by
                                 the intersection of Security system value QSSLPCL
                                 and the eligible default protocols from the
                                 SSLCONFIG macro)
SSL_VERSION_2                2  (SSL Version 2.0 only)
SSL_VERSION_3                3  (SSL Version 3.0 only)
TLS_VERSION_1                4  (TLS Version 1.0 only)
TLSV1_SSLV3                  5  (TLS Version 1.0 with SSL Version 3.0 compatibility)
TLS_VERSION_1_0              6  (TLS Version 1.0 only)
TLS_VERSION_1_1              7  (TLS Version 1.1 only)
TLS_VERSION_1_2              8  (TLS Version 1.2 only)
TLSV12_TLSV11_TLSV10         9  (TLS Version 1.x only)
TLSV12_TLSV11_TLSV10_SSLV3   10 (TLS Version 1.x with SSL Version 3.0 compatibility)

This to me sounds like on V7R1 when TLS v1.2 and TLSv1.1 were added the current values for the SSL_Version_Current should have been updated, but wasn't.  I don't see how the values when compiled would make a difference as these are system values.

So, for the latest version of GETURI (v4.10 SP150609) as well as MAILTOOL (v8.10 and up) we have created data areas in the applications that will hold the SSL protocol version to use when calling either GETURI or MAILTOOL.  

  • GETURI - GU002DA
  • MAILTOOL - MLT002DA

The customer has reported that they chose to use option 9 (which is TLS v1.x only) and it worked fine and solved the problem. 

Feel free to contact us for any questions regarding this issue.

Update:  Please see this article on how to set your system's SSL or TLS version on your IBM i.


Last edited 10/26/2017 at 16:28:51



Latest Posts:

MAILTOOL Now Allows Email Redirection for Development and Testing MAILTOOL Now Allows Email Redirection for Development and Testing
Posted by May 27, 2023
BVSTools >> BVSTools Announcements >> eMail Tool (MAILTOOL) Specific Announcements
GreenTools for Microsoft Apps (G4MS) Now Supports Footers When Sending Email GreenTools for Microsoft Apps (G4MS) Now Supports Footers When Sending Email
Posted by March 29, 2023
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
QuickBooks Online - Subtotals and Discounts Frustration QuickBooks Online - Subtotals and Discounts Frustration
Posted by March 16, 2023
QuickBooks >> QuickBooks Online
Making the Switch From QuickBooks Desktop to QuickBooks Online - No Picnic Making the Switch From QuickBooks Desktop to QuickBooks Online - No Picnic
Posted by March 16, 2023
QuickBooks >> QuickBooks Online
BVSTools Software Verified on V7R5 and Power10 BVSTools Software Verified on V7R5 and Power10
Posted by December 9, 2022
BVSTools >> BVSTools Announcements
Microsoft Office 365 Servers and Random Errors Issue Microsoft Office 365 Servers and Random Errors Issue
Posted by November 14, 2022
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
Sending/Resending Emails Using a MIME File with MAILTOOL Sending/Resending Emails Using a MIME File with MAILTOOL
Posted by November 8, 2022
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
Sending an HTML Email on Your IBM i Using MAILTOOL Sending an HTML Email on Your IBM i Using MAILTOOL
Posted by November 1, 2022
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
Transferring License Keys from One System to Another Transferring License Keys from One System to Another
Posted by October 31, 2022
BVSTools >> BVSTools Software Discussion
Calculating the Size of a File Before Base64 Encoding Calculating the Size of a File Before Base64 Encoding
Posted by August 13, 2022
Programming >> RPG Programming
GreenTools for Microsoft Apps (G4MS) v9.12 Now Includes Function to Send Emails using MIME File GreenTools for Microsoft Apps (G4MS) v9.12 Now Includes Function to Send Emails using MIME File
Posted by August 11, 2022
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
GreenTools for Google Apps (G4G) v15.20 Now Supports Shortcuts GreenTools for Google Apps (G4G) v15.20 Now Supports Shortcuts
Posted by August 6, 2022
BVSTools >> BVSTools Announcements >> GreenTools for G Suite (Google Apps) (G4G) Specific Announcements
GreenTools for Microsoft Apps (G4MS) Groups Admin Authority Instructions GreenTools for Microsoft Apps (G4MS) Groups Admin Authority Instructions
Posted by July 26, 2022
BVSTools >> BVSTools Software Discussion >> GreenTools for Microsoft Apps (G4MS) Specific Discussion
GreenTools for Microsoft Apps (G4MS) v9.10 Now Includes OneDrive Functions that Work With Groups/Shared Drives GreenTools for Microsoft Apps (G4MS) v9.10 Now Includes OneDrive Functions that Work With Groups/Shared Drives
Posted by July 19, 2022
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
GreenTools for Google Apps (G4G) v15.10 Now Includes Drive Functions that Work With Shared Drives GreenTools for Google Apps (G4G) v15.10 Now Includes Drive Functions that Work With Shared Drives
Posted by July 15, 2022
BVSTools >> BVSTools Announcements >> GreenTools for G Suite (Google Apps) (G4G) Specific Announcements

Reply




© Copyright 1983-2020 BVSTools
GreenBoard(v3) Powered by the eRPG SDK, MAILTOOL Plus!, GreenTools for Google Apps, jQuery, jQuery UI, BlockUI, CKEditor and running on the IBM i (AKA AS/400, iSeries, System i).