New advertisers: 50% off your first month with code FIRSTMONTHSee slots
bitwarden avatar

bitwarden-security-engineer

Application security engineering plugin that triages findings, threat models, and reviews code for vulnerabilities.

version
2.1.0
GitHub stars
165
View on GitHub

What it does

  • Adds the bitwarden-security-engineer agent plus skills for code security, secrets, dependencies, threat modeling, and architecture review
  • Covers triage of Aikido and Dependabot alerts via triaging-security-findings, with severity mapping and a false positive protocol
  • Runs perform-security-review as a multi-agent review using two-axis Severity × Confidence scoring across chat, file, or CI output
  • Designed for Bitwarden engineers who need reviews aligned to internal principles and to the Aikido plugin, which must be installed first

Application security engineering assistant for vulnerability triage, threat modeling, and secure code analysis.

Add marketplace

/plugin marketplace add bitwarden/ai-plugins

Run it inside Claude Code once, then install the plugin below.

Install

/plugin install bitwarden-security-engineer@bitwarden-marketplace

Run it inside Claude Code after adding the marketplace.

Files

Discovered from source

Security Review Workflow

Follow these steps when conducting a manual security code review:

  1. Identify the attack surface. Determine entry points: API endpoints, message handlers, file parsers, user-facing forms. Read route definitions and controller registrations to build a map.
  2. Trace data flows from sources to sinks. Follow untrusted input (HTTP parameters, headers, request bodies, file uploads, external API responses) through all transformations to dangerous operations (database queries, command execution, HTML rendering, file system access).
  3. Check trust boundary crossings. At every point where data crosses a trust boundary (client→server, service→service, user input→database), verify that validation, authentication, and authorization are enforced.
  4. Apply framework checklists. Consult references/framework-checklists.md for OWASP Web/API/Mobile Top 10 and CWE Top 25. Check each applicable category against the code under review.
  5. Adopt an adversarial mindset. Form a hypothesis (e.g., "I can bypass SSO", "I can access another user's vault") and work backwards to determine what conditions would make it exploitable.
  6. Map findings to CWE IDs. Every finding must include the specific CWE identifier, the code location, and the data flow that makes it exploitable.
  7. Classify by practical exploitability. Distinguish between practically exploitable vulnerabilities and theoretical risks. Prioritize accordingly but document both.

Key Vulnerability Categories

The most frequently encountered categories across Bitwarden's stack:

  • Injection (CWE-89, CWE-78, CWE-77) — Unsanitized input reaching SQL queries, OS commands, or LDAP queries. Always use parameterized queries and avoid string concatenation.
  • Broken Access Control (CWE-862, CWE-287, CWE-306) — Missing authorization checks, IDOR, privilege escalation. Verify per-object ownership checks and role enforcement at every layer.
  • XSS (CWE-79) — User input rendered in HTML without encoding. In Angular, avoid innerHTML and bypassSecurityTrust* with untrusted content.
  • SSRF (CWE-918) — User-controlled URLs in server-side requests. Validate against host allowlists.
  • Insecure Deserialization (CWE-502) — Type-handling enabled on untrusted input. Avoid TypeNameHandling.All in JSON.NET.
  • Path Traversal (CWE-22) — User-supplied paths reaching file system operations. Canonicalize and validate against a base directory.
  • Cryptographic Failures — Weak algorithms, hardcoded keys, predictable IVs. See the reviewing-security-architecture skill for approved algorithms.

For complete framework checklists (all OWASP and CWE categories), consult references/framework-checklists.md.

For CORRECT/WRONG code examples in C#, TypeScript, and SQL, consult references/vulnerability-patterns.md.

Adversarial Review Mindset

Adopt an adversarial mindset during security code review — this differs from regular code review which seeks to strengthen code.

How to think adversarially:

  1. Create a hypothesis — e.g., "I can bypass SSO", "I can access another user's vault", "I can escalate from member to admin"
  2. Work backwards — What conditions would need to be true for the attack to succeed? Can those conditions be fabricated?
  3. Question assumptions — Is that authorization check always reached? What happens if the middleware fails? What if the token is malformed but not invalid?
  4. Consider failure modes — What happens when things fail? Do they fail open (insecure) or fail closed (secure)?

Critical Rules

  • Authentication before authorization. Always verify the user is who they claim to be before checking what they're allowed to do. Never skip auth checks in "internal" endpoints.
  • Validate at trust boundaries. Every point where data crosses a trust boundary (client→server, service→service, user input→database) must validate. Never trust client-side validation alone.
  • Map findings to CWE IDs. Every finding must include a specific CWE identifier with evidence: the code location and the data flow that makes it exploitable.
  • Practical over theoretical. Distinguish between vulnerabilities that are practically exploitable in this system vs. theoretical risks. Prioritize accordingly but document both.
  • Check the whole chain. A vulnerability isn't just the sink — trace from the source (user input) through all transformations to the sink (dangerous operation). If the chain is broken by sanitization, it's not exploitable.

Additional Resources

Reference Files

For detailed checklists and code examples, consult:

  • references/framework-checklists.md — OWASP Web Top 10, API Top 10, Mobile Top 10 (2024), CWE Top 25 lookup tables
  • references/vulnerability-patterns.md — CORRECT/WRONG code examples for C#/.NET, TypeScript/Angular, and SQL

Readme

Bitwarden Security Engineer Plugin

Claude Code skills for application security at Bitwarden. Generic AI coding assistance doesn't know our scanner toolchain, triage workflows, or threat modeling practices. These skills keep Claude focused on how we secure software here.

Overview

This plugin provides specialized skills for security engineering tasks — from triaging scanner findings and threat modeling to conducting multi-agent security code reviews. Skills can be invoked individually or orchestrated together for comprehensive coverage across code, dependencies, secrets, and architecture.

Prerequisites

triaging-security-findings, reviewing-dependencies, and perform-security-review query the Aikido feed via the aikido:issues skill. That skill ships in the separate aikido plugin — Aikido Security's own Claude Code plugin — and requires an authenticated MCP session. Install it with /plugin install aikido@claude-plugins-official and run /aikido:setup before using those skills. For triaging-security-findings and reviewing-dependencies, Aikido is the primary data source: if it isn't installed, these skills stop and ask you to install it rather than silently returning no findings. perform-security-review treats Aikido SAST/IaC/SCA/container evidence as one of several best-effort corroborating sources rather than a hard requirement — if it's unavailable, the review continues using whichever sources it could reach.

Skills

SkillWhat It Does
triaging-security-findingsTriage Aikido feed findings (SAST, IaC, SCA, secrets, cloud, container, malware, EOL, license) via Jira, plus GitHub Dependabot and secret scanning alerts. Includes severity mapping, group-scope verification, false positive protocol, and fix patterns.
threat-modelingGenerate security definitions, data flow diagrams, and threat catalogs using STRIDE. Follows Bitwarden's 4-phase AppSec engagement model.
analyzing-code-securitySecurity code review against OWASP Web/API/Mobile Top 10, CWE Top 25. Step-by-step review workflow with adversarial mindset guidance.
reviewing-dependenciesDependabot triage, Aikido open-source and container scanning, transitive dependency risk analysis. NuGet and npm platform-specific guidance.
detecting-secretsHardcoded credential detection with context-aware analysis. GitHub secret scanning integration, Azure Key Vault remediation.
reviewing-security-architectureArchitecture-level review for authentication, authorization, encryption, trust boundaries, and cryptographic patterns.
perform-security-reviewMulti-agent security code review with 4 specialized agents, two-axis Severity × Confidence scoring, Aikido SAST/IaC/SCA/container evidence plus secret scanning and Dependabot evidence (the latter two are interactive only — not pre-approved, so CI records them as not checked), --base-ref <ref> to pick the comparison base, and flexible output (chat, file, or GitHub Actions).
auditing-external-claude-pluginsSecurity audit of a third-party Claude Code plugin before it's vendored, covering MCP config, dependency supply chain, tool permission scope, and prompt-injection surface. Runs as an isolated subagent and writes a report file.

Usage

Install the plugin, then ask for what you want in natural language. Example prompts:

Use the bitwarden-security-engineer:bitwarden-security-engineer agent to triage the open Aikido findings on this PR.
Use the bitwarden-security-engineer:bitwarden-security-engineer agent to create a threat model for the new Send feature.
Use the bitwarden-security-engineer:bitwarden-security-engineer agent to review this code for OWASP Top 10 vulnerabilities.

auditing-external-claude-plugins takes positional arguments instead:

/bitwarden-security-engineer:auditing-external-claude-plugins https://github.com/org/plugin <commit-sha>

References

External resources that informed each skill. Useful for maintainers updating skill content when upstream sources change.

threat-modeling

triaging-security-findings

analyzing-code-security

reviewing-dependencies

detecting-secrets

reviewing-security-architecture

Details

Marketplace
bitwarden/ai-plugins
Source
plugins/bitwarden-security-engineer
Category
Community

More from bitwarden/ai-plugins

All 25

Similar to bitwarden-security-engineer

More Security & Compliance