Skip to content

Feat: User-Agent rotation in existing modules' headers #203

@kaifcodec

Description

@kaifcodec

Feature: Implement User-Agent Rotation for Stealth Scanning

Description

Currently, many of our modules use hardcoded User-Agents in their request headers. This makes the scanner easy to fingerprint.

We need to implement a centralized User-Agent rotation system in core/helpers.py and refactor existing modules in email_scan/ and user_scan/ to use it.

Tasks

1. Implement Helper Function

In user_scanner/core/helpers.py, create a function called get_random_user_agent().

  • It should contain a list of 15-20 modern User-Agents (Windows, macOS, Linux, iPhone, Android).
  • Always confirm you are listing current or slightly older version of the browser not a future version
  • It should return a random string from this list every time it is called.

2. Refactor Modules

Search through email_scan/ and user_scan/ for any modules with hardcoded headers like:

headers = {
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) ..."
}

Replace them with:

from user_scanner.core.helpers import get_random_user_agent

headers = {
    "User-Agent": get_random_user_agent()
}

Proposed User-Agent List (Partial)

The list should include variety, for example:

  • PC (Chrome/Edge/Safari): Windows 11, macOS Sonoma.
  • Mobile: iPhone 15 (Safari), Pixel 8 (Chrome).

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions