Scenario: Configuring a SOCKS proxy

In this scenario, you can make MQIPT act as a SOCKS proxy.

Before you begin

  • Before you start to use this scenario, make sure that you have completed the prerequisite tasks listed in Scenarios: Getting started with MQIPT.
  • Enable SOCKS on either the whole IBM MQ computer or just the IBM MQ client application (amqsputc/amqsgetc).
  • Configure the SOCKS client as follows:
    1. Use MQIPT as the SOCKS proxy.
    2. Enable SOCKS 5 support.
    3. Disable user authentication.
    4. Restrict connections to the MQIPT network address.
    (The values of the MQIPT Destination and DestinationPort properties can be anything, as the true destination is obtained from the IBM MQ client during the SOCKS handshaking process.)

About this task

Figure 1. SOCKS proxy network diagram
See text.

This diagram shows the connection flow from the IBM MQ client (called client1.company1.com on port 1415) through MQIPT to the IBM MQ server (called server1.company2.com on port 1414).

Procedure

To configure a SOCKS proxy, complete the following steps:

  1. On MQIPT1:
    1. Edit mqipt.conf and add a route definition:
      
      [route]
      ListenerPort=1080
      Destination=server1.company2.com
      DestinationPort=1414
      SocksServer=true
    2. Open a command prompt and start MQIPT:
      
      C:\mqipt\bin\mqipt C:\mqiptHome
      where C:\mqiptHome indicates the location of the MQIPT configuration file, mqipt.conf.
      The following message indicates successful completion:
      
      5639-L92 (C) Copyright IBM Corp. 2000, 2021 All Rights Reserved
      MQCPI001 IBM MQ Internet Pass-Thru 2.1.0.3 starting
      MQCPI004 Reading configuration information from C:\mqiptHome\mqipt.conf
      MQCPI011 The path C:\mqiptHome\logs will be used to store the log files
      MQCPI006 Route 1080 has started and will forward messages to :
      MQCPI034 ....server1.company2.com(1414)
      MQCPI035 ....using MQ protocols
      MQCPI052 ....Socks server side enabled
      MQCPI078 Route 1080 ready for connection requests
  2. At a command prompt on the IBM MQ client, enter the following commands:
    1. Set the MQSERVER environment variable:
      
      SET MQSERVER=MQIPT.CONN.CHANNEL/tcp/10.20.5.6(1414)
    2. Put a message:
      
      amqsputc MQIPT.LOCAL.QUEUE MQIPT.QM1
      Hello world
      Press Enter twice after typing the message string.
    3. Get the message:
      
      amqsgetc MQIPT.LOCAL.QUEUE MQIPT.QM1
      The message, "Hello world" is returned.