Welcome to the new Parasoft forums! We hope you will enjoy the site and try out some of the new features, like sharing an idea you may have for one of our products or following a category.

What are message proxies and how are they used?

When getting started with Virtualize, it is often a good idea to
get ahold of some traffic going from your client to your service
so that you have a better understanding of the transport between
the two. The best way to do this when using Virtualize is by using
a message proxy.

  • The first thing you will want to do when creating your proxy is
    look over at the Virtualize server view on the right hand side of
    your Virtualize instance. Here, if you expand the server tab, you
    should see your "local machine" server. If it is not already,
    expand this as well. At that point, the "Message Proxies" folder
    will be visible.

  • Right click this folder and select Add Message Proxy. This will
    not immediately create the proxy itself, so we need to take a
    couple extra steps to create and configure it. From here, double
    click on the Proxy that was created under the Message Proxies
    folder. From here, click on the Connections tab. On this screen,
    you can view any active proxies that were created as part of this
    proxy "container." To add a proxy, click on the Add button at the
    bottom of the table.

  • Next we will want to add our connection settings. These settings
    will be different for every service, so make sure that you are
    double-checking these settings as they are being input. The first
    connection you will make is from the incoming client. This setting
    should be something that is easily identifiable as being the proxy,
    so it is considered best practice to make this incoming path the
    same path as the connection to the service that you are trying to
    emulate, but add in "/proxy/" to the beginning of it.

Ex: /proxy/parabank/services/store-01.

  • Once that has been done, we need to enter in the connection settings
    for the service that we are trying to emulate. If you are following
    the best practice as shown above, you need only enter in the service
    host and port, then paste the rest of the path after /proxy/ as shown
    above into the service forward path section.

  • After this is done, click OK and >>REMEMBER TO SAVE YOUR PROGRESS<<.

  • Next, you need to point your client application at the proxy you just
    created. This is often done in the source code of the client application.
    If you were following the best practices as stated above, you need only
    change the host and port of the target application and then add in
    /proxy/ to the path.

  • Now that you have configured your client application, the only thing
    we have left is to enable our proxy in Virtualize by right-clicking
    it in the Virtualize server view in Virtualize and clicking enable.

  • Once it has finished deploying, you should be able to use your client
    application as normal, but instead of going directly to the live
    service, it will be getting diverted through the proxy to the live
    service. To create the traffic, all you need to do is end your
    recording by right clicking the proxy once again and selecting "Stop
    Recording." The next step when creating traffic is to right click the
    enabled proxy and select start recording. All traffic that flows
    through this proxy will then get recorded into a traffic file that
    you can locate by moving over to the navigator view in Virtualize
    and refreshing. You should see a folder called "recorded traffic"
    under the Virtualize Assets Project folder.

  • As an alternative, you can simply monitor the traffic going between
    your client and your backend by right clicking the proxy and selecting
    "Start Monitoring" instead of "Start Recording". When the proxy is in
    monitor mode, any messages that are sent back and forth through the
    proxy are added into our Event Details Perspective. To view this
    perspective, the easiest way to do this is to click on "window" at
    the top of the Virtualize screen and select Perspective > Open
    Perspective > Parasoft Event details.

Tagged: