HTTPS support with SOAP

Simple Object Access Protocol (SOAP), is a standard protocol that is used to communicate with Web Services.

To use HTTPS with SOAP, some prerequisites must be met. The correct versions of the porting set, 4GL Engine and Application Studio must be installed. The required certificates that enable HTTPS must be installed and accessible by the porting set.

Prerequisites

To use HTTPS with SOAP meet these prerequisites:

  • Porting set 8.7a.02
    • Porting set 8.7a.02 is the first porting set to contain correct support for HTTPS and SSL. The porting set uses the cURL and OpenSSL libraries, and offers 3GL functions to enable HTTPS.
  • 4GL Engine build 3971, solution 1009866
    • The SOAP DLL in this build of the 4GL Engine contains functions such as SoapService.SetClientCertFile() and SoapService.SetCertAuthorityDir() which are required for HTTPS.
  • Application Studio build 8.7.0.0229
    • The WSDL2Baan tool in this build of the Application Studio supports HTTPS and generates wrapper functions to create client and server certificates.
  • OpenSSL tool version 1.0 (recommended)
    • The OpenSSL command line tool is required for converting certificates from DER and PKCS12 format to PEM format. It can be used to generate the hashed file names of server certificates, see "To generate the hashed file name of a certificate". It can be used to diagnose issues connecting to web sites. If the correct certificates are already available in PEM format, and no hashed file names are required, the OpenSSL tool is not required.
  • Perl (optional)
    • Perl (Practical Extraction and Reporting Language) is a scripting language. It is required for the c_rehash utility script, which may be used to create hashed file names of server certificates. Note that this utility is not shipped with every distribution of OpenSSL.