hunt-grpc

Validates gRPC, gRPC-Web, and Connect service authorization boundaries through evidence-gated probing.

10|3|Updated Aug 10, 2026
One-click install
npx skills add https://github.com/baiqigo/baiqi-redteam-lab --skill hunt-grpc-baiqigo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hunt-grpc
Source: https://github.com/baiqigo/baiqi-redteam-lab/tree/main/.agents/skills/hunt-grpc
Command: npx skills add https://github.com/baiqigo/baiqi-redteam-lab --skill hunt-grpc-baiqigo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Testing gRPC-based APIs for authorization flaws is difficult because service/method discovery, protobuf schemas, and metadata-based auth differ from REST conventions, and naive probing produces false positives or out-of-scope damage. This Skill provides an evidence-gated workflow to verify whether a low-privilege identity can invoke services or access objects it should not. ## Core Features & Use Cases - Protocol-Aware Discovery: Confirms transport, service/method names, protobuf or JSON schemas, metadata auth, and stream types from real client traffic instead of guessing from ports or headers. - Minimal Safe Validation: Runs single-variable metadata and message differentials against your own test methods and objects, comparing server responses, audit logs, and authoritative object read-backs. - Strict Oracle and Stop Rules: Treats WAF blocks, captchas, and transcoding errors as inconclusive, and halts on reflection sprawl, stream flooding, third-party data, or sensitive admin RPCs. - Use Case: During an authorized assessment of a microservices platform, use this Skill to verify whether a standard user token can invoke an admin-only gRPC method, capturing sanitized evidence for the report. ## Quick Start Use the hunt-grpc skill to plan an evidence-gated authorization test of our gRPC service endpoints within the declared scope.

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 APIs for authorization vulnerabilities?

Capture real client traffic to confirm the transport, service/method names, protobuf schema, and metadata authentication, then run single-variable differentials using your own low-privilege identity. A finding is valid only when server-side evidence confirms access to a method or object that identity should not reach.

How to discover gRPC services and methods during a security assessment?

Derive service and method names from observed client traffic rather than guessing from ports or headers. Server reflection should only be used minimally when explicitly permitted by the engagement scope.

Does gRPC-Web testing differ from native gRPC testing?

Yes, gRPC-Web and Connect add HTTP transcoding layers whose errors must not be mistaken for authorization findings. The workflow validates the actual service/method and metadata handling behind the transcoding proxy before drawing conclusions.

Why do gRPC security scans produce false positives?

WAF blocks, captchas, timeouts, and HTTP transcoding errors look like access denials but prove nothing about authorization logic. This workflow classifies all such signals as inconclusive and requires server-side or authoritative read-back evidence.

When should I stop a gRPC authorization test?

Stop immediately on reflection sprawl, stream flooding, exposure of third-party data, shared user impact, or irreversible side effects such as sensitive admin RPCs. Only owned accounts, objects, and approved rates are in scope.