Skip to content

Burp Faker helps you generate unique or custom fake data directly in Burp Suite requests.

License

Notifications You must be signed in to change notification settings

ItzzMeGrrr/burp_faker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Burp Faker

Author: Bhavin Vasara
Github: github.com/itzzmegrrr


Table of Contents


Overview

Burp Faker helps you generate unique or custom fake data directly in Burp Suite requests. Many web scanners and extensions fail when requests reuse the same data repeatedly, or servers reject duplicate/invalid inputs. Unlike Postman or Insomnia, Burp does not have built-in support for per-request dynamic fake data. This extension solves that problem.

With Burp Faker, you can replace request body, headers, and URL parameters with:

  • Random UUIDs
  • Alphanumeric, alphabetic, upper/lowercase, numeric, or custom-character strings
  • Regex-based strings (via rstr library)

Each placeholder is replaced independently, and you can optionally assign tags to reuse the same value across multiple placeholders of the same type.


Installation

NOTE: Since Burp uses Jython for Python extensions, and Jython only supports Python 2.7, we need to manually add the rstr library to the same folder as the extension file. Therefore, we have the following two options for installation:

Option 1: Using the GitHub Release (Regex support included)

  1. Download the latest release from the Releases page or clone the repository:
git clone https://github.com/ItzzMeGrrr/burp_faker.git
  1. Open Burp Suite -> Extensions -> Add.
  2. Select the burp_faker.py file from the cloned folder or downloaded release.
  3. The extension will load with regex support enabled (thanks to the bundled rstr library).

Option 2: Without regex faker support (BApp Store)

  1. Open Burp Suite -> Extensions -> BApp Store
  2. Search for Burp Faker and click Install

In this mode, regex placeholders will not work, but all other fake data types are fully functional.


Usage

Placeholder Format

{{burp_faker.<type>(<length_or_charset_or_regex>, tag=<optional_tag>) }}
  • <type>: uuid, alphanumeric, alpha, lower, upper, numeric, custom, regex
  • <length>: Number of characters to generate (for string types)
  • <charset>: For custom, the set of characters to use
  • <regex>: For regex type
  • <optional_tag>: Reuse the same value across multiple placeholders of the same type

Examples

Unique values

{{burp_faker.uuid()}}
{{burp_faker.alpha(10)}}
{{burp_faker.numeric(5)}}

Reusing the same value with a tag

{{burp_faker.uuid(tag=session)}}
{{burp_faker.alpha(5, tag=session)}}
{{burp_faker.alpha(10, tag=session)}}  # Will slice from the longest alpha(10) value

Custom charset

{{burp_faker.custom(10, abc123!@#)}}

Regex

{{burp_faker.regex([a-z]{3}[0-9]{2})}}

Notes:

  • Tagging is per type: a UUID tag is independent from an alpha tag with the same name.
  • When multiple placeholders of the same type share a tag, the longest requested length is used, and shorter ones are sliced from it.
  • Regex values are always generated uniquely and do not support tags or length slicing.
  • Invalid placeholders output INVALID_PLACEHOLDER without slicing.

Features

  • Replace placeholders in request body, headers, and URL parameters
  • Supports UUID, alpha, alphanumeric, numeric, upper/lowercase, custom charset, and regex
  • Optional tagging to reuse the same value across multiple placeholders of the same type
  • Each placeholder is independent and can be unique or repeated based on tags
  • Context menu integration for easy insertion of placeholders
  • Logs all replacements in Burp output for transparency

Context Menu

Right-click a request in Burp and choose from:

  • Insert UUID
  • Insert alphanumeric
  • Insert alpha, lower, upper, numeric
  • Insert custom charset string
  • Insert regex pattern

The placeholder is inserted at the selection and will be replaced automatically when the request is sent.


License

MIT License

Acknowledgments

This project includes rstr, which is licensed under the following terms:

Copyright (c) 2011, Leapfrog Direct Response, LLC
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.
    * Neither the name of the Leapfrog Direct Response, LLC, including
      its subsidiaries and affiliates nor the names of its
      contributors, may be used to endorse or promote products derived
      from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL LEAPFROG DIRECT
RESPONSE, LLC, INCLUDING ITS SUBSIDIARIES AND AFFILIATES, BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

About

Burp Faker helps you generate unique or custom fake data directly in Burp Suite requests.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages