hunt-grpc

Detect gRPC vulnerabilities including unauthenticated RPC access and metadata spoofing.

1.1k|191|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/uphiago/recon-skills --skill hunt-grpc-uphiago
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hunt-grpc
Source: https://github.com/uphiago/recon-skills/tree/main/redteam/hunt-grpc
Command: npx skills add https://github.com/uphiago/recon-skills --skill hunt-grpc-uphiago

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

gRPC services in microservice architectures are often assumed to be internal and secure, but common misconfigurations like enabled server reflection, missing authentication on internal endpoints, and unstripped proxy-injected metadata expose them to critical vulnerabilities including unauthenticated access to privileged RPC methods, cross-tenant impersonation, and denial-of-service attacks. This skill provides a structured, field-validated workflow to systematically identify and exploit these gRPC-specific security gaps that are missed by standard web vulnerability scanners.

Core Features & Use Cases

  • 7-Phase Assessment Workflow: Covers fingerprinting, service enumeration via reflection, unauthenticated method testing, trust-boundary bypass, proto file discovery, gRPC-Web/grpc-gateway attack surface testing, and HTTP/2 Rapid Reset DoS validation.
  • High-Impact Vulnerability Detection: Identifies crown-jewel findings including unauthenticated admin RPC access, metadata spoofing for cross-tenant impersonation, IDOR via enumerable gRPC message fields, and exposed internal services via transcoded endpoints.
  • Use Case: For penetration testers assessing cloud-native microservice environments, this skill enables the discovery of critical gRPC-specific attack surfaces such as unauthenticated access to internal payment or user admin services via exposed gRPC ports or public gRPC-Web gateways.

Quick Start

Use the hunt-grpc skill to assess a target's gRPC services for unauthenticated admin method access, metadata spoofing vulnerabilities, and HTTP/2 Rapid Reset DoS exposure, following the structured 7-phase workflow to validate findings and avoid false positives.

Frequently Asked Questions about hunt-grpc

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

FAQPage Schema
How do I find unauthenticated gRPC methods during a penetration test?

gRPC server reflection allows clients to query service definitions dynamically, exposing available RPC methods and message structures. During penetration testing, this mechanism reveals internal services and unauthenticated methods that standard web vulnerability scanners cannot detect.

What is gRPC server reflection and how does it expose attack surface?

gRPC server reflection allows clients to query service definitions dynamically, exposing available RPC methods and message structures. During penetration testing, this mechanism reveals internal services and unauthenticated methods that standard web vulnerability scanners cannot detect.

How do I test for cross-tenant impersonation via gRPC metadata spoofing?

Test cross-tenant impersonation by spoofing proxy-injected metadata headers in gRPC requests to bypass trust boundaries. This skill identifies misconfigurations where unstripped metadata allows attackers to impersonate tenants and access privileged functionality.

Can I use grpcurl to enumerate gRPC services exposed on port 50051?

Yes, grpcurl is required for service enumeration and RPC invocation against gRPC targets on common ports like 50051, 443, 8443, and 9090. The skill uses grpcurl alongside protoc and protoscope for protobuf descriptor handling during assessments.

Does this workflow cover HTTP/2 Rapid Reset denial-of-service testing for gRPC?

Yes, the workflow includes HTTP/2 Rapid Reset DoS validation as part of its 7-phase assessment. It requires explicit written authorization for DoS testing to comply with program scope rules before attempting any denial-of-service exposure validation.

What limitations exist when testing gRPC-Web endpoints fronted by Envoy proxies?

Testing gRPC-Web endpoints fronted by Envoy proxies or grpc-gateway transcoders requires handling transcoded HTTP/1.1 attack surfaces. The skill addresses these specific configurations but standard web scanners miss these exposed internal services via transcoded endpoints.