SOAP Injector

A Python tool for injecting SOAP messages with automatic variable substitution. This tool allows you to send randomized SOAP messages to test endpoints with dynamic content generation.

Features

• 🎲 Random Template Selection: Automatically selects random SOAP templates from a directory
• 🔄 Variable Substitution: Dynamic replacement of variables with UUIDs, timestamps, and random values
• 📊 Batch Processing: Send multiple messages with configurable delays
• 📝 Detailed Logging: Comprehensive logging with success/failure statistics
• ⚙️ Configurable: Customizable timeouts, delays, and template directories

Quick Start

1. Setup Python Virtual Environment

# Create virtual environment
python3 -m venv .venv

# Activate virtual environment
source .venv/bin/activate  # On Linux/macOS
# or
.venv\Scripts\activate     # On Windows

# Install dependencies
pip install requests

⚠️ Important: Always use .venv/bin/python instead of just python to ensure you're using the virtual environment's Python interpreter with the correct dependencies installed. All examples in this README use the virtual environment path.

2. Setup a dockerized SOAP Endpoint (Optional) for Testing

docker run --detach --rm --name echo-server -p 10000:8080 -e LOG_HTTP_BODY='true' jmalloc/echo-server

Now you have a simple SOAP endpoint running locally on port 10000. This endpoint will echo back any SOAP messages you send to it, which is useful for testing this python tool.

Monitor the SOAP endpoint logs:

# View real-time logs from the echo server
docker logs -f echo-server

# View last 50 lines and follow new logs
docker logs -f --tail 50 echo-server

3. Run the Injector

# Send a single SOAP message
.venv/bin/python soap_injector.py http://localhost:10000/soap-endpoint

# Send multiple messages with delay
.venv/bin/python soap_injector.py http://localhost:10000/soap-endpoint --count 10 --delay 1.0

# Use custom template directory
.venv/bin/python soap_injector.py http://localhost:10000/soap-endpoint --soap-dir ./my_templates

Command Line Options

Option	Short	Description	Default
endpoint	-	SOAP endpoint URL (required)	-
--soap-dir	-d	Directory containing SOAP templates	./soap_templates
--count	-c	Number of messages to send	1
--delay	-w	Delay between sends (seconds)	0.0
--timeout	-t	HTTP request timeout (seconds)	30
--verbose	-v	Enable verbose logging	false

SOAP Templates

Place your SOAP XML templates in the soap_templates/ directory. The tool supports variable substitution using the {{VARIABLE_NAME}} syntax.

Supported Variables

Variable	Description	Example
{{UUID}}	Standard UUID v4	f47ac10b-58cc-4372-a567-0e02b2c3d479
{{UUID_UPPER}}	Uppercase UUID	F47AC10B-58CC-4372-A567-0E02B2C3D479
{{UUID_NO_DASH}}	UUID without dashes	f47ac10b58cc4372a5670e02b2c3d479
{{TIMESTAMP}}	ISO timestamp	2025-09-17T14:30:15
{{TIMESTAMP_MS}}	Timestamp with milliseconds	2025-09-17T14:30:15.123
{{DATE}}	Current date	2025-09-17
{{TIME}}	Current time	14:30:15
{{EPOCH}}	Unix timestamp	1726578615
{{RANDOM_ID}}	6-digit random number	482751
{{RANDOM_ALPHA}}	8-character random string	HXMKPQWZ
{{RANDOM_ALPHANUM}}	10-character alphanumeric	H3X9MK2QWZ

Example Template

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ns:Request xmlns:ns="http://example.com/service">
      <ns:MessageId>MSG-{{UUID}}</ns:MessageId>
      <ns:Timestamp>{{TIMESTAMP}}</ns:Timestamp>
      <ns:TransactionId>TXN_{{RANDOM_ID}}</ns:TransactionId>
      <ns:Data>
        <ns:Reference>REF_{{UUID_NO_DASH}}</ns:Reference>
        <ns:UserId>USER_{{RANDOM_ALPHANUM}}</ns:UserId>
      </ns:Data>
    </ns:Request>
  </soap:Body>
</soap:Envelope>

Project Structure

soap-injector/
├── soap_injector.py          # Main script
├── soap_templates/           # SOAP template directory
│   ├── message-1.xml        # Example template 1
│   └── message-2.xml        # Example template 2
├── .venv/                   # Python virtual environment
└── README.md                # This file

Usage Examples

Basic Usage

# Send one random message
.venv/bin/python soap_injector.py http://localhost:8080/soap

# Send 5 messages with 2-second delays
.venv/bin/python soap_injector.py http://localhost:8080/soap --count 5 --delay 2

# Use verbose logging
.venv/bin/python soap_injector.py http://localhost:8080/soap --verbose

Load Testing

# Send 100 messages as fast as possible
.venv/bin/python soap_injector.py http://localhost:8080/soap --count 100

# Send 50 messages with 0.5s delay (sustained load)
.venv/bin/python soap_injector.py http://localhost:8080/soap --count 50 --delay 0.5

# Long timeout for slow endpoints
.venv/bin/python soap_injector.py http://localhost:8080/soap --timeout 60

Output and Logging

The tool provides detailed logging including:

• ✅ Success messages: HTTP 200 responses with response size
• ❌ Error messages: HTTP errors, timeouts, connection issues
• 📊 Statistics: Success rate and timing information for batch runs

Example output:

2025-09-17 15:15:25 [INFO] 📚 Loaded 2 SOAP file(s) from soap_templates
2025-09-17 15:15:25 [INFO]    📄 message-2.xml
2025-09-17 15:15:25 [INFO]    📄 message-1.xml
2025-09-17 15:15:25 [INFO] 🚀 Starting injection of 3 SOAP message(s)
2025-09-17 15:17:02 [INFO] ✅ [message-2.xml] → http://localhost:10000/soap-endpoint | HTTP 200 | 785 bytes
2025-09-17 15:17:02 [INFO] ⏳ Waiting 0.2s before next send...
2025-09-17 15:17:03 [INFO] ✅ [message-1.xml] → http://localhost:10000/soap-endpoint | HTTP 200 | 785 bytes
2025-09-17 15:18:51 [INFO] ┌────────────────────────────────────────────────┐
2025-09-17 15:18:51 [INFO] │ 📊 INJECTION SUMMARY                           │
2025-09-17 15:18:51 [INFO] ├────────────────────────────────────────────────┤
2025-09-17 15:18:51 [INFO] │ 🏁 Completed in: 0.00s                         │
2025-09-17 15:18:51 [INFO] │ ✅ Success: 2/2 (100.0%)                       │
2025-09-17 15:18:51 [INFO] │ ❌ Failed: 0/2                                 │
2025-09-17 15:18:51 [INFO] └────────────────────────────────────────────────┘

Troubleshooting

Common Issues

1. Import Error: ModuleNotFoundError: No module named 'requests'

   # Make sure virtual environment is activated and requests is installed
   source .venv/bin/activate
   pip install requests

2. No SOAP files found:

   # Check that XML files exist in soap_templates directory
   ls soap_templates/*.xml

3. Connection refused:

   # Verify the SOAP endpoint is running and accessible
   curl -X POST http://localhost:10000/soap-endpoint

Debug Mode

Use --verbose flag to enable debug logging for troubleshooting:

.venv/bin/python soap_injector.py http://localhost:8080/soap --verbose

Contact

If you have questions, suggestions, or need support with this SOAP Injector tool, feel free to reach out:

• Author: Robin
• Repository: soap-injector
• Issues: GitHub Issues

For bug reports or feature requests, please use the GitHub Issues page. Pull requests are welcome!

License

This project is provided as-is for testing and development purposes.