Tools - zcabrer/proxylab GitHub Wiki

Proxy Lab Tools Documentation

Welcome to the Proxy Lab Tools Documentation! This page provides detailed descriptions of all the tools available in Proxy Lab, along with instructions on how to use them. Each tool is designed to help you test and debug various aspects of web applications and proxies.

Table of Contents

1. Headers Tool

Description

The Headers Tool allows you to inspect and modify HTTP request and response headers. This is particularly useful for testing proxy tools, header rewrites, and header injections (e.g., x-forwarded-for, x-forwarded-port).

How to Use

  1. Navigate to the Headers Tool.
  2. View the general information about the request, including URL, status, method, and remote address.
  3. Inspect the request headers (as seen by the server) and response headers (sent by the server).
  4. Add custom request or response headers using the "Add Headers" section:
    • Click the + button to add a new header field.
    • Enter the header name and value.
  5. Submit the headers using the Submit button.
  6. Reset the headers to their default state using the Reset button.

2. Post Body Tool

Description

The Post Body Tool allows you to submit an HTTP POST request to the server. You can select the content type, input custom body content, and view the server's response.

How to Use

  1. Navigate to the Post Body Tool.
  2. Select a content type from the dropdown menu. If "Other" is selected, input a custom content type.
  3. (Optional) View examples for the selected content type.
  4. Enter the body content in the provided text area.
  5. Click the Submit button to send the POST request.
  6. View the server's response and the content length in the response display section.

3. Query String Tool

Description

The Query String Tool helps you create and submit query strings to the server. This is ideal for testing how proxies handle query string manipulations.

How to Use

  1. Navigate to the Query String Tool.
  2. Input a raw query string in the format key1=value1&key2=value2.
  3. Click the Submit button to send the query string to the server.
  4. The server will echo back the response status code and the submitted query string for verification.

4. File Upload and Download Tool

Description

This tool allows you to test file uploads and downloads. It is useful for evaluating upload/download limits and performance.

How to Use

Upload Files

  1. Navigate to the File Upload and Download Tool.
  2. Select files to upload using the file input field (supports multiple files).
  3. Ensure the total file size does not exceed 1.5GB (5-file limit).
  4. Click the Upload button to submit the files.
  5. View the upload duration and server response.

Download Files

  1. Select a file size from the dropdown menu (e.g., 1MB, 10MB, 100MB, 1GB).
  2. Click the Download button to initiate the download.
  3. The server will generate and return a random text file of the specified size.

5. Request Timeout Tool

Description

The Timeout Tool allows you to test how proxies handle delayed responses. You can specify a timeout duration, and the server will delay its response accordingly.

How to Use

  1. Navigate to the Request Timeout Tool.
  2. Enter a timeout duration in seconds (minimum: 1 second, maximum: 86,400 seconds or 24 hours).
  3. Click the Initiate Request button to send the request.
  4. The server will wait for the specified duration before responding.
  5. View the server's response and any associated timer display.

6. HTTP Status Code Generator

Description

The HTTP Status Code Generator allows you to test how proxies and clients handle specific HTTP responses. You can input a valid HTTP status code, and the server will respond with the specified code.

How to Use

  1. Navigate to the HTTP Status Code Generator.
  2. Enter a valid HTTP status code (e.g., 200, 404, 500) in the input field.
  3. Select the request method (POST or GET).
  4. Click the Generate button to send the request.
  5. View the server's response with the specified status code.

These tools are designed to help you test and debug various scenarios in web applications and proxies. Explore each tool to understand its capabilities and how it can assist in your testing workflows.