hunt-grpc

Detect gRPC vulnerabilities including reflection exposure, missing authentication, and metadata-spoofing trust bypasses.

Updated Sep 6, 2026
One-click install
npx skills add https://github.com/inventashif/helpful-code-sidekick --skill hunt-grpc-inventashif
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hunt-grpc
Source: https://github.com/inventashif/helpful-code-sidekick/tree/main/scripts/hackerai/skills/bughunter/hunt-grpc
Command: npx skills add https://github.com/inventashif/helpful-code-sidekick --skill hunt-grpc-inventashif

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Security testers often lack a structured methodology for assessing gRPC services, which hide behind HTTP/2 transports, edge proxies, and transcoding gateways where traditional web testing techniques miss critical authorization flaws. ## Core Features & Use Cases - Service Enumeration: Discover exposed gRPC ports, verify ALPN h2 negotiation, and enumerate every service and method via server reflection using grpcurl. - Authorization Testing: Call privileged RPC methods without credentials, test IDOR via enumerable id fields, and spoof proxy-trusted metadata headers like x-user-id and x-tenant-id to expose cross-tenant impersonation. - Transcoder & DoS Analysis: Attack gRPC-Web, grpc-gateway, and Connect JSON-transcoding routes, and version-verify HTTP/2 Rapid Reset (CVE-2023-44487) exposure without unauthorized flooding. - Use Case: During a bug bounty engagement against a microservices platform, you find port 50051 open with reflection enabled, enumerate an internal AdminService, and prove an unauthenticated DeleteUser call executes — a Critical finding. ## Quick Start Use the hunt-grpc skill to enumerate and test the gRPC services exposed on my authorized target for missing authentication and reflection issues.

Frequently Asked Questions about hunt-grpc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test gRPC services for security vulnerabilities?

Start by fingerprinting gRPC ports with nmap and confirming ALPN h2 negotiation, then use grpcurl to list services via server reflection. Call sensitive methods without authentication and interpret grpc-status codes to distinguish real authorization failures from enforced controls.

How to enumerate gRPC services when reflection is enabled?

Run grpcurl with the list command against the target port to retrieve every registered service, then use describe on each service and method to dump message schemas. Pipe the catalog into grep for admin, internal, debug, or delete patterns to prioritize targets.

What tools are used for gRPC penetration testing?

grpcurl is the primary CLI client for listing, describing, and calling methods, while grpcui provides a web interface for interactive exploration. protoc and protoscope build raw protobuf and gRPC-Web frames, and buf drives Connect protocol endpoints.

Can I test gRPC APIs when server reflection is disabled?

Yes, reflection-off is a hardening control, not a security boundary. Recover .proto definitions from leaked repositories or swagger endpoints, compile them into a descriptor set with protoc, and pass it to grpcurl with the -protoset flag to drive the API.

Is gRPC server reflection enabled a vulnerability by itself?

Reflection exposure alone is information disclosure rated Low to Medium, since many vendors ship it intentionally. It becomes reportable when it reveals a non-public service catalog that leads to calling a sensitive method without authentication.

Can I test CVE-2023-44487 Rapid Reset on a bug bounty target?

Only with explicit written authorization, since DoS testing is out of scope on most programs. Prefer version-matching the HTTP/2 stack from the server banner against known patched releases instead of sending reset floods, which produce unreliable results.