Troubleshooting

Troubleshooting Guide

This guide helps you diagnose and resolve common issues with Postman2Burp.

Common Issues and Solutions

Proxy Connection Issues

Problem: "Proxy is not running at localhost:8080"

Solutions:

• Ensure Burp Suite is running and the proxy is listening on the specified port
• Use --proxy to specify a different proxy address:

  python postman2burp.py --collection "your_collection.json" --proxy localhost:9090

• Use --skip-proxy-check to bypass the proxy check:

  python postman2burp.py --collection "your_collection.json" --skip-proxy-check

Problem: "Failed to connect to proxy"

Solutions:

• Check if there's a firewall blocking the connection
• Verify the proxy host and port are correct
• Try using the IP address instead of hostname

Variable Substitution Issues

Problem: Variables not being substituted in requests

Solutions:

• Check that your profile file contains all required variables
• Ensure variable names match exactly (case-sensitive)
• Use --verbose to see detailed logs of variable substitution:

  python postman2burp.py --collection "your_collection.json" --target-profile "your_profile.json" --verbose

• Verify the profile file is valid JSON

Collection Loading Issues

Problem: "Failed to load collection"

Solutions:

• Verify the collection file exists and is valid JSON
• Ensure the collection is in Postman Collection v2.1 format
• Check file permissions
• Try using the absolute path to the collection file

Spaces in Filenames

Problem: Command fails with "unrecognized arguments" when filenames contain spaces

Solutions:

• Wrap filenames in quotes:

  python postman2burp.py --collection "My Collection.json" --target-profile "My Profile.json"

• Rename files to use underscores instead of spaces

SSL Certificate Issues

Problem: SSL certificate verification errors

Solutions:

• By default, SSL verification is disabled. If you've enabled it and are experiencing issues, you can disable it again:

  # Remove the --verify-ssl flag if you were using it
  python postman2burp.py --collection "your_collection.json"

• If you need to keep SSL verification enabled, ensure the necessary CA certificates are installed on your system

Environment Setup Issues

Problem: "ModuleNotFoundError: No module named 'requests'"

Solutions:

• Ensure you've activated the virtual environment:

  source venv/bin/activate  # On Windows: venv\Scripts\activate

• Reinstall dependencies:

  pip install -r requirements.txt

• If issues persist, try recreating the virtual environment:

  rm -rf venv
  python3 -m venv venv
  source venv/bin/activate
  pip install -r requirements.txt

Debugging Techniques

Enable Verbose Logging

Use the --verbose flag to get detailed information about what's happening:

python postman2burp.py --collection "your_collection.json" --verbose

Check Proxy Connection Manually

Test if your proxy is accessible:

curl -x localhost:8080 https://www.example.com

Validate JSON Files

Ensure your collection and profile files are valid JSON:

python -m json.tool your_collection.json > /dev/null
python -m json.tool your_profile.json > /dev/null

Check Python Version

Ensure you're using Python 3.6 or higher:

python --version

Getting Help

If you're still experiencing issues:

1. Check the GitHub Issues to see if your problem has been reported
2. Open a new issue with:
   • A clear description of the problem
   • Steps to reproduce
   • Error messages
   • Your environment details (OS, Python version, etc.)

Next Steps

• Installation Guide
• Usage Guide
• Advanced Usage
• Configuration Guide