🏷️Tags

Tags are labels used to categorize and organize profiles. They enable powerful filtering, tag-based passive scan launching, and are the key mechanism for targeting groups of profiles in Smart Scan rules.

βš™οΈ How Tags Work

Every profile has a Tags array containing one or more tag strings:

{
  "Tags": ["All", "XSS", "Reflected"]
}

Tags are used for:

  1. πŸ” Filtering profiles in the Profiles tab β€” View profiles by category using the tag dropdown

  2. πŸ‘οΈ Launching passive scans by tag β€” Right-click context menu lets you run only passive profiles with a specific tag

  3. 🧠 Targeting profiles in Rules β€” Execute all profiles with a specific tag when rule conditions are met

  4. πŸ“‚ Organizing profiles β€” Group related profiles logically across all three profile types

πŸ“Š Tags in All Profile Tables

Tags are displayed in all three profile tables β€” Active, Passive Request, and Passive Response:

Table
Columns

🎯

Active Profiles

Enabled, Profile Name, Tags, Author's Twitter

πŸ“¨

Passive Request

Enabled, Profile Name, Tags, Author's Twitter

πŸ“©

Passive Response

Enabled, Profile Name, Tags, Author's Twitter

🏷️ Assigning Tags with "Set New Tag"

You can quickly assign tags to profiles directly from the profile tables using the right-click context menu:

Steps

  1. Select one or more profiles in any profile table (Active, Passive Request, or Passive Response)

  2. Right-click to open the context menu

  3. Click Set New Tag

  4. In the dialog, enter the tag name

  5. Click OK β€” the tag is added to all selected profiles βœ…

πŸ’‘ Tip: Select multiple profiles with Ctrl+Click or Shift+Click, then use Set New Tag to tag them all at once. This is the fastest way to organize a large number of profiles.

What Happens

  • βœ… The tag is added to each selected profile's Tags array in its .bb file

  • πŸ” If the tag already exists in a profile, it's not duplicated

  • πŸ“ The tag is added to the global tags list (tags.txt)

  • πŸ”„ The Tags column and tag dropdown are updated immediately

  • πŸ‘οΈ The tag becomes available in the passive scan context menu

🌐 The "All" Tag

The special All tag is included in most profiles by convention. It allows rules to target all profiles at once:

⚠️ Warning: Rules that execute the All tag will trigger every active profile, which can be very resource-intensive. Use with caution.

πŸ“¦ Default Tags

The bundled profiles use these tags for categorization:

Tag
Description
Count

All

All profiles

~254

XSS

Cross-Site Scripting

~15

SQLi

SQL Injection

~8

SSRF

Server-Side Request Forgery

~6

RCE

Remote Code Execution

~10

Open Redirect

Open Redirect

~5

CORS

CORS Misconfiguration

~1

SSTI

Server-Side Template Injection

~1

XXE

XML External Entity

~3

CVEs

Known CVE exploits

~50

Path Traversal

Path/Directory Traversal

~2

Wordpress

WordPress-specific

~12

Drupal

Drupal-specific

~2

Spring

Spring Framework-specific

~2

GraphQL

GraphQL-specific

~6

Fuzzing Files

File/directory fuzzing

~4

Forgot Password

Password reset testing

~3

Cloud

Cloud infrastructure

~1

API

API endpoints

~1

JWT

JSON Web Tokens

~1

Mobile

Mobile application testing

~1

Blind XSS

Blind XSS payloads

~1

CRLF

CRLF Injection

~1

Errors

Error page detection

~1

DRWuzz

DWR fuzzing

~1

Introspection

GraphQL introspection

~1

React/Next.js

React/Next.js vulnerabilities

~3

n8n

n8n platform vulnerabilities

~1

Security_Headers

Missing security headers (passive)

~6

Secrets

Exposed secrets and keys (passive)

~10

Parameters

Interesting parameters (passive)

~5

Cookie_Security

Cookie security flags (passive)

~3

Technology

Technology fingerprinting (passive)

~8

πŸ‘οΈ Tags in the Passive Scan Context Menu

Tags are the foundation of the tag-based passive scan feature. When you right-click to launch a passive scan, the context menu organizes passive profiles by tag:

Each entry shows the count of profiles with that tag. This lets you run precisely the passive checks you need.

See Passive Scan for details on launching tag-based passive scans.

πŸ“‹ Using Tags in Rules

Rules can target profiles by tag instead of listing individual profiles:

This executes all active profiles tagged with "XSS" when the rule's conditions are met.

See Creating Rules for details.

πŸ“Š Tags Manager

The Tags Manager sub-tab within the Profiles section allows you to:

  • πŸ‘€ View all tags in use across all profiles

  • πŸ“ See which profiles belong to each tag

  • πŸ”§ Manage tag assignments

  • πŸ” Filter the profile tables by selecting a tag from the dropdown

✏️ Creating Custom Tags

When creating or editing a profile, simply add your custom tag strings to the Tags array:

Or use the Set New Tag right-click menu on existing profiles β€” this is the fastest way. ⚑

Best practices:

  • βœ… Always include the All tag unless you want to exclude the profile from broad scans

  • πŸ“ Use descriptive tag names that indicate the vulnerability class or target technology

  • πŸ”€ Use consistent naming across profiles (e.g., always use XSS not xss or Cross-Site-Scripting)

  • 🎯 Create target-specific tags (e.g., Client_A) for profiles tailored to specific engagements

  • πŸ‘οΈ Use tags on passive profiles to enable focused passive scanning via the context menu

πŸ“š Example: Tag-Based Scanning Workflow

  1. 🏷️ Tag profiles by category:

    • XSS profiles β†’ XSS tag

    • SQLi profiles β†’ SQLi tag

    • WordPress profiles β†’ Wordpress tag

    • Security header checks β†’ Security_Headers tag

    • Secret detection β†’ Secrets tag

  2. πŸ‘οΈ Launch focused passive scans:

    • Right-click a request β†’ Passive Scan > Passive Response > Security_Headers

    • Right-click a request β†’ Passive Scan > Passive Request > Parameters

  3. πŸ“‹ Create rules that use tags:

    • When Passive Request detects SQL-like parameters β†’ Execute tag SQLi

    • When Passive Response detects WordPress β†’ Execute tag Wordpress

  4. 🎯 Control scope:

    • For broad scanning: Use tag All

    • For focused scanning: Use specific tags like XSS or CVEs

    • For passive-only audits: Use the tag submenu to run only relevant checks

Last updated