WinGridProxy

From libopenmetaverse - libomv - Developer Wiki

Jump to: navigation, search

Contents

Introduction

WinGridProxy is a proxy server and protocol analyzer used to display and modify UDP and Capabilities traffic sent between a Viewer and Simulator.

Screen Shots

WinGridProxy Main Screen

Getting WinGridProxy

WinGridProxy is included as part of the libOpenMetaverse protocol library which can be downloaded here

Quick Start

Windows

  • Navigate to the folder containing WinGridProxy.exe
  • Double Click WinGridProxy.exe to start the application
  • Toolbar Settings:
    • Listen IP Address - This is the IP Address the proxy server will listen for viewer connections on
    • Port - This is the Port the proxy server will listen on
    • Login URL - This is the login url of the grid to connect to, you can select one of the default servers or add your own
    • Start button - This starts the proxy server allowing for viewer connections
    • Launch button - The proxy server on start will attempt to find installed viewers, this button starts the viewer in the dropdown passing the correct parameters to connect using the proxy server
  • Click the Start button, the proper loginuri is displayed on the summary page

Windows Requrements

  • All versions of Windows that support and have installed the .NET Framework 3.5 or newer can run WinGridProxy

Linux

  • Navigate to the folder containing WinGridProxy.exe in a terminal session
  • issue the following command at the prompt#mono WinGridProxy.exe
  • Toolbar Settings:
    • Listen IP Address - This is the IP Address the proxy server will listen for viewer connections on
    • Port - This is the Port the proxy server will listen on
    • Login URL - This is the login url of the grid to connect to, you can select one of the default servers or add your own
    • Start button - This starts the proxy server allowing for viewer connections
    • Launch button - The proxy server on start will attempt to find installed viewers, this button starts the viewer in the dropdown passing the correct parameters to connect using the proxy

Linux Requirements

  • Mono 2.4.2 or newer
  • a Graphical Desktop/Window Manager running

OSX

OSX Requirements

Selecting packets and messages to capture

The filters tab allows you to select multiple packets to capture, as traffic is passed back and forth between the viewer and simulator, selected packets will be added to the sessions list.

Viewing Traffic Details

Clicking any item in the session list will display the decoded details on the Inspector tab

Injecting Packets