Created : 15 April 2015
Last Modified : 30 April 2018

***********************************************************************************
Contents:

A. SUMMARY
B. PRE-REQUIREMENT
C. FILES STRUCTURE
D. INSTALLATION INSTRUCTIONS
E. GUIDE TO MAKE CHANGES IN MODULE
F. HOW TO KNOW IF YOU HAVE TLS 1.2 WORKING PROPERLY
G. CHANGES LOGS
H.
TROUBLESHOOTING
I.
FAQ
J. COPYRIGHT NOTICE
K. TERMS AND CONDITIONS

***********************************************************************************

A. SUMMARY
==========

This package is to guide you how to build your vpcart application support TLS 1.2.

***********************************************************************************

B. PRE-REQUIREMENT
===================

1. Any Windows Server 2008 editions or
2. Any Windows 10 editions or
3. Any Windows 8 editions

**** This will not work for sites hosted on Window Server 2008 or earlier. ****

***********************************************************************************

C. FILES STRUCTURE
============================

Files included in the zip are:
- $readme_tls12900.txt
- shopxmlhttp.asp
- shopxmlhttp_v8.asp
- check_tls12.asp
- admin\shopxmlhttp.asp
- admin\shopxmlhttp_v8.asp


***********************************************************************************

D. INSTALLATION INSTRUCTIONS
===============

1. Upload all files into your shopping cart folder and your admin folder

***********************************************************************************

E. GUIDE TO MAKE CHANGES IN MODULE
=================

Basically you need to change the existing XML routine file in the module to use new routine Shopxmlhttp_v8

Example:

E1. Without any XML specific header: AuthorizeNet AIM - anaimshoppayment.asp
E1i. Make sure the includes always link to shopxmlhttp.asp, as below: (if does not have the xml file include, insert the code)
<!-- #include file="shopxmlhttp.asp" -->

E1ii. Search any xml routine and replace to Shopxmlhttp_v8
From
Shopxmlhttp xanaim_xml, xanaim_gatewaylocation, anrequest, result, "POST", xmlerror

To
dim rheadercnt, rheadertypeary(10), rheadervalueary(10)
rheadercnt = 0
shopxmlhttp_v8 "auto", xanaim_gatewaylocation, anrequest, result, "POST", xmlerror, rheadercnt, rheadertypeary, rheadervalueary, "", ""

E2. With XML specific header and Login/Password assign via XML: Eway Rapid 3.1 - ewayrapid_xmlhttp.asp
E2i. Make sure the includes always link to shopxmlhttp.asp, as below: (if does not have the xml file include, insert the code)
<!-- #include file="shopxmlhttp.asp" -->

E2ii. Search any xml routine and replace to Shopxmlhttp_v8
From
sub Shopxmlhttp_ewayrapid (itype, iurl, httpid, httppassword, contentstring, authstring, indata, outdata, method, xmlerror)

To
sub Shopxmlhttp_ewayrapid (itype, iurl, httpid, httppassword, contentstring, authstring, indata, outdata, method, xmlerror)
dim rheadercnt, rheadertypeary(10), rheadervalueary(10)
rheadercnt = 2
rheadertypeary(0) = "Content-Type"
rheadervalueary(0) = contentstring
rheadertypeary(1) = "Authorization"
rheadervalueary(1) = authstring
Shopxmlhttp_v8 "auto", iurl, indata, outdata, method, xmlerror, rheadercnt, rheadertypeary, rheadervalueary, httpid, httppassword
exit sub

E3. With XML specific header: UPS: shopxmlhttp_ups.asp
E3i. Make sure the includes always link to shopxmlhttp.asp, as below: (if does not have the xml file include, insert the code)
<!-- #include file="shopxmlhttp.asp" -->

E3ii. Search any xml routine and replace to Shopxmlhttp_v8
From
sub Shopxmlhttp (itype, iurl, indata, outdata, method, xmlerror)

To
sub Shopxmlhttp (itype, iurl, indata, outdata, method, xmlerror)
dim rheadercnt, rheadertypeary(10), rheadervalueary(10)
rheadercnt = 2
rheadertypeary(0) = "Content-Type"
rheadervalueary(0) = "application/x-www-form-urlencoded"
rheadertypeary(1) = "Content-Length"
rheadervalueary(1) = len(indata)
Shopxmlhttp_v8 "auto", iurl, indata, outdata, method, xmlerror, rheadercnt, rheadertypeary, rheadervalueary, "", ""


F. HOW TO KNOW IF YOU HAVE TLS 1.2 WORKING PROPERLY
===========================

1. Simply open the URL http://yourdomain.com/yourcartfolder/check_tls12.asp

2. If your server support TLS 1.2 for ASP Classic and this patch is installed properly, you will get the message as below:

TLS 1.2 Patch Setup properly

Otherwise, this page will prompt you the related error message.

***********************************************************************************

G. CHANGE LOGS
============================

2016.05.27 - Support Windows 2008 server.
2018.04.30 - Compatible with v9

***********************************************************************************

H. TROUBLESHOOTING
============================

Please submit a ticket to our helpdesk at https://helpdesk.vpcart.com and our support team will assist you.

***********************************************************************************

I. FAQ
============================

NONE

***********************************************************************************
J. COPYRIGHT NOTICE
============================

Copyright (c) 1999-2023 Rocksalt International Pty. Ltd.
All rights reserved.

This software and documentation constitute a published work and
contains valuable trade secrets and proprietary information
belonging to Rocksalt International Pty. Ltd. .
None of the foregoing material may be copied,
duplicated or disclosed without the express written permission
of Rocksalt International Pty. Ltd. .

LICENSEE ACCEPTS VP-ASP Shopping Cart "AS IS" "WITH ALL FAULTS",
Rocksalt International Pty. Ltd. accepts no responsibility for the
operation or performance of the VP-ASP Shopping Cart.
The entire risk of use and consequences of use of the
VP-ASP Shopping Cart falls completely on the Licensee
and Rocksalt International Pty. Ltd. shall not be liable in any respect
for any claims, loss or injury alleged to have resulted
from use of or in reliance on VP-ASP Shopping Cart.

Licensee acknowledges that it has read the foregoing
disclaimers of warranty and limitation of liability
and understands that Licensee assumes
the entire risk of using VP-ASP Shopping Cart.


***********************************************************************************

K. TERMS AND CONDITIONS
============================
ROCKSALT INTERNATIONAL GRANTS TO THE LICENSEE A NON-EXCLUSIVE,
NON-SUB LICENSABLE, NONTRANSFERABLE LICENSE
TO INSTALL AND USE THIS APPLICATION ON A SINGLE DOMAIN FOR
A SINGLE SHOP.

THE CODE IN THE APPLICATION MAY BE MODIFIED FOR USE IN
SETTING UP A SINGLE SHOPPING SITE ON THE WORLD WIDE WEB.

LICENSEE MAY MAKE A COPY OF THE APPLICATION FOR
BACK-UP AND ARCHIVAL PURPOSES, PROVIDED THAT ANY COPY
MUST CONTAIN ALL PROPRIETARY NOTICES INCLUDED
WITH THE APPLICATION.

LICENSEE IS PROHIBITED FROM SELLING OR DISTRIBUTING
THE APPLICATION IN ANY MANNER.

LIMITATION OF LIABILITY.

ROCKSALT INTERNATIONAL AND ITS LICENSORS SHALL
NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE OR ANY
THIRD PARTY AS A RESULT OF USING OR DISTRIBUTING THIS
APPLICATION.

IN NO EVENT WILL ROCKSALT INTERNATIONAL OR ITS LICENSORS
BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA,
OR FOR DIRECT, INDIRECT, SPECIAL,
CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES,
HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LI
ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE,
EVEN IF ROCKSALT INTERNATIONAL HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.