Overview
GitHub’s bug bounty program has long been a cornerstone of its security strategy, relying on external researchers to uncover vulnerabilities across a platform serving over 180 million developers. However, the landscape is shifting: submission volumes have surged—partly due to AI tools—but quality hasn’t kept pace. Reports without proof of concept (PoC), theoretical scenarios, or findings already listed as ineligible are flooding the system. Rather than shutting down (as some programs have), GitHub is raising the bar. This tutorial guides you through crafting submissions that meet the new standards, ensuring your reports get serious attention and contribute to a safer GitHub.
Prerequisites
Before diving in, make sure you have:
- A HackerOne account (GitHub uses this platform for submissions).
- Basic knowledge of web security concepts (XSS, CSRF, SQL injection, etc.).
- Familiarity with common tools like Burp Suite, curl, or a browser’s developer console.
- Access to GitHub’s bug bounty scope and ineligible list (read them carefully).
- A testing environment (e.g., a local replica or a non-production GitHub instance) to validate PoCs without causing harm.
Step-by-Step Instructions
1. Understand Scope and Ineligible Findings
Before writing a single line of code, know what GitHub accepts and what it rejects. The program’s official scope lists eligible repositories and services. The ineligible list includes categories like DMARC/SPF/DKIM configurations, user enumeration (e.g., “login error messages differ”), and missing security headers without a demonstrated attack path. Submissions in these areas will likely be closed as “Not Applicable,” harming your HackerOne Signal score. Action: Bookmark the scope and ineligible pages, and cross-check every potential finding before proceeding.
2. Create a Working Proof of Concept
GitHub now requires a working PoC with demonstrated security impact. A theoretical description (“this could lead to…”) is insufficient. You must show that the vulnerability can be exploited in practice. For example, if you find a stored XSS in a comment field, don’t just describe the input vector; provide a simple JavaScript payload that executes in the browser (e.g., <script>alert('XSS')</script>) and explain what an attacker could achieve (e.g., stealing session cookies). For CSRF, include a crafted HTML form that forces a state-changing action. Use screenshots or video captures to prove impact. Tip: Replicate the attack on a test account (your own) to confirm it works in production.
3. Validate Before Submission
Whether you use automated scanners, static analysis, or AI assistants, manually verify every finding. False positives are noise; they waste both your time and the triager’s. For instance, an AI might suggest a SQL injection based on user input reflection, but a manual test reveals proper parameterization. How to validate:
- Recreate the attack step-by-step in a controlled environment.
- Confirm that the vulnerable endpoint is within scope.
- Ensure the PoC demonstrates the actual impact (e.g., data retrieval, privilege escalation).
- Check for duplicate reports on GitHub’s public issue tracker or HackerOne discussions.
4. Leverage AI Tools Responsibly
GitHub welcomes AI in security research. AI can help you scan codebases, generate payload variations, or identify patterns. However, you are ultimately responsible for the output. If an AI produces a flawed PoC, you must catch it. Best practices:
- Use AI to augment your analysis, not replace it.
- Critically review AI-generated code for edge cases.
- Document any AI assistance in your report (transparency builds trust).
- Never submit raw AI output without manual testing—it often includes non-exploitable scenarios or irrelevant details.
As we covered in Step 3, validation is key—AI or not.
Common Mistakes
- Submitting without a PoC: Reports that say “this could lead to…” but don’t show exploitation are closed. Always include a working demonstration.
- Ignoring the ineligible list: DMARC misconfigurations, user enumeration, and missing headers are out of scope unless you can prove a concrete attack path. Check the list before crafting your report.
- Relying solely on automated tools: Scanners and AI generate false positives. Manual verification catches them before submission. Otherwise, you contribute to noise.
- Over-theorizing impact: Claiming “critical” impact without evidence leads to reclassification or rejection. Be realistic and back claims with data.
- Forgetting to include steps to reproduce: Even with a PoC, provide clear, numbered steps so the triager can easily verify.
- Submitting duplicate findings: Search existing reports and GitHub’s security advisories to avoid wasting effort.
Summary
GitHub’s bug bounty program remains open but demands higher-quality submissions. To succeed, focus on: understanding scope and ineligible items, creating a working PoC with real impact, validating every finding manually (even with AI tools), and avoiding common pitfalls like no PoC or automated noise. By raising your own bar, you’ll earn better rewards, build your reputation, and help secure the platform for millions.