performing-phishing-simulation-with-gophish
About performing-phishing-simulation-with-gophish
A skill for security teams running authorized awareness campaigns with the open-source GoPhish simulation framework. It covers campaign setup, email and landing pages, delivery, and results analysis.
Key features
- 01Deploy GoPhish
- 02Configure an SMTP sending profile
- 03Create email templates and landing pages
- 04Import targets and schedule campaigns
- 05Analyze campaign results through the API
Use cases
- 01Run authorized phishing awareness exercises
- 02Validate email security controls
- 03Measure email opens, clicks, and submissions
- 04Direct participants to security training
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ mukul975/ anthropic-cybersecurity-skills --skill performing-phishing-simulation-with-gophishAfter installing, type/performing-phishing-simulation-with-gophishin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
LICENSEassets/template.mdreferences/api-reference.mdstandards.mdworkflows.mdscripts/agent.pyprocess.pyDetails
From the project READMEPerforming Phishing Simulation with GoPhish
Overview
GoPhish is an open-source phishing simulation framework used by security teams to conduct authorized phishing awareness campaigns. It provides campaign management, email template creation, landing page cloning, and comprehensive reporting. This skill covers deploying GoPhish, creating realistic phishing scenarios, and analyzing campaign results to measure and improve organizational resilience.
When to Use
- When conducting security assessments that involve performing phishing simulation with gophish
- When following incident response procedures for related security events
- When performing scheduled security testing or auditing activities
- When validating security controls through hands-on testing
Prerequisites
- GoPhish binary or Docker image (https://github.com/gophish/gophish)
- SMTP server or relay for sending test emails
- Written authorization from management for phishing simulation
- Target email list (HR-approved)
- SSL/TLS certificate for landing pages
- Python 3.8+ for automation scripts
Key Concepts
GoPhish Architecture
- Admin Panel: Web UI for campaign management (default port 3333)
- Phishing Server: Serves landing pages and tracks clicks (default port 80/443)
- SMTP Configuration: Outbound email sending profile
- Campaign Engine: Orchestrates email delivery, tracking, and reporting
Campaign Components
- Sending Profile: SMTP server configuration for outbound email
- Email Template: The phishing email content with tracking
- Landing Page: The fake page users are directed to
- User Group: Target recipients for the campaign
- Campaign: Combines all components with scheduling
Workflow
Step 1: Deploy GoPhish
# Docker deployment
docker pull gophish/gophish
docker run -d --name gophish -p 3333:3333 -p 8080:80 gophish/gophish
# Or binary deployment
wget https://github.com/gophish/gophish/releases/latest/download/gophish-v0.12.1-linux-64bit.zip
unzip gophish-v0.12.1-linux-64bit.zip
chmod +x gophish
./gophish
Step 2: Configure Sending Profile
- Name: "Internal Mail Server"
- SMTP From: [email protected]
- Host: smtp.yourdomain.com:587
- Username/Password: Service account credentials
- Enable TLS
Step 3: Create Email Template
- Use realistic scenarios: password reset, IT notification, HR update
- Include GoPhish tracking pixel:
{{.Tracker}} - Include phishing link:
{{.URL}} - Personalize with
{{.FirstName}},{{.LastName}},{{.Position}}
Step 4: Create Landing Page
- Clone legitimate login page using GoPhish's import feature
- Enable credential capture (for authorized testing only)
- Configure redirect to training page after submission
- Add SSL certificate for HTTPS
Step 5: Import Users and Launch Campaign
- Import CSV with: First Name, Last Name, Email, Position
- Set campaign schedule (stagger sends to avoid detection)
- Launch and monitor in real-time
Step 6: Analyze Results with process.py
Use the automation script to pull campaign data via GoPhish API and generate detailed analytics reports.
Tools & Resources
- GoPhish: https://getgophish.com/
- GoPhish API Docs: https://docs.getgophish.com/api-documentation/
- GoPhish GitHub: https://github.com/gophish/gophish
- Evilginx2 (for advanced AiTM testing): https://github.com/kgretzky/evilginx2
- King Phisher: https://github.com/rsmusllp/king-phisher
Validation
- Successfully deploy GoPhish and access admin panel
- Create and send a test phishing email to a test mailbox
- Capture simulated credentials on landing page
- Generate campaign report with open/click/submit rates
- Redirect users to awareness training after interaction