> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coderabbit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CodeRabbit Secure

> Scan GitHub, GitLab, Azure DevOps, and Bitbucket repositories for potential security issues across the committed codebase.

GitHub (This feature is available on GitHub and GitHub Enterprise.) GitLab (CodeRabbit Security is available on GitLab and self-hosted GitLab.) Azure (CodeRabbit Security is available on Azure DevOps Services and Azure DevOps Server.) Bitbucket (CodeRabbit Security is available on Bitbucket Cloud and Bitbucket Data Center.) | Advanced Plan (Continuous pull request security review requires Advanced or Enterprise. Deep Scan is available separately through usage billing or a free allowance.) Open Beta (CodeRabbit Security is currently available in beta.)

A pull request diff shows what changed, not what the change affects, and a check that looks only at the diff misses vulnerabilities that already sit in the committed code. The code also keeps changing, so what you learned about a repository's security goes out of date with every merge.

CodeRabbit Secure brings repository-level security analysis to CodeRabbit. During pull request review, it raises security issues and, through [Security Architecture Review](https://docs.coderabbit.ai/security/architecture-review.md) and [Security Blast Radius](https://docs.coderabbit.ai/security/blast-radius.md) in [Change Stack](https://docs.coderabbit.ai/change-stack.md), shows how a change reaches trust boundaries, controls, and downstream dependencies. For the committed codebase, [Deep Scan](https://docs.coderabbit.ai/security/deep-scan.md) analyzes source code and infrastructure configuration for exploitable vulnerabilities and exposed secrets beyond the current pull request diff, and shows the results, including secret findings, under **Security > Findings**.

The [Attack surface map](https://docs.coderabbit.ai/security/attack-surface.md) organizes security-relevant code into subsystems and tracks verification coverage, findings, and drift as pull requests merge. [Delta scans](https://docs.coderabbit.ai/security/delta-scans.md) refresh it between full Deep Scans, and [Steer Deep Scans](https://docs.coderabbit.ai/security/steer-scans.md) explains how to guide what a scan checks. With the [CodeRabbit Security check](https://docs.coderabbit.ai/security/pull-request-check.md), you can publish Security results to your Git provider for merge enforcement, and [Runtime verification](https://docs.coderabbit.ai/security/runtime-verification.md) gives you reproduction guides for Deep Scan findings.

> [!NOTE]
>
> CodeRabbit Security findings are separate from **Security > PR security reviews**. **PR security reviews** shows issues raised during pull request reviews, while **Findings** shows results from Deep Scans.

## Security capabilities at a glance

| Capability | Purpose | Results |
| - | - | - |
| [Deep Scan](https://docs.coderabbit.ai/security/deep-scan.md) | Find exploitable vulnerabilities and exposed secrets across committed source code and infrastructure configuration | **Security > Findings** |
| [Delta scans](https://docs.coderabbit.ai/security/delta-scans.md) | Refresh changed files and stale or unverified mapped points between full Deep Scans | **Security > Scan history**, **Attack surface** |
| [Runtime verification](https://docs.coderabbit.ai/security/runtime-verification.md) | Get reproduction guides for Deep Scan findings and optionally run them in an isolated test environment | **Finding > Runtime verification** |
| [Attack surface](https://docs.coderabbit.ai/security/attack-surface.md) | Map security-relevant code and continuously track verification coverage and drift | **Security > Repositories > Attack surface** |
| [PR security reviews](#pr-security-reviews) | Show security issues raised during pull request reviews | **Security > PR security reviews** |
| [CodeRabbit Security check](https://docs.coderabbit.ai/security/pull-request-check.md) | Publish Security results for provider-specific merge enforcement | **Provider pull request or merge request checks, builds, or statuses** |
| [Security Architecture Review](https://docs.coderabbit.ai/security/architecture-review.md) | Assess security implications that span changed components, trust boundaries, controls, and downstream dependencies | **Change Stack > Overview** |
| Architecture Impact | Overlay mapped Security Architecture findings on the changed-architecture view | [**Change Stack > Architecture Impact**](https://docs.coderabbit.ai/change-stack/navigation.md#primary-views) |
| [Security Blast Radius](https://docs.coderabbit.ai/security/blast-radius.md) | Map how pull request changes connect to dependencies, downstream consumers, tests, and security-relevant paths | **Change Stack > Security Blast Radius** |

Deep Scan does not perform dependency or software composition analysis (SCA) or generate a software bill of materials (SBOM).

## PR security reviews

Open **PR security reviews** under **Security** or **Analytics** to review security issues raised during pull request reviews. Each finding shows its status and severity, plus separate **Reachability** and **Exploitability** badge columns.

On GitHub, GitLab, Bitbucket, and Azure DevOps, including their supported self-managed variants, you can enable the [CodeRabbit Security check](https://docs.coderabbit.ai/security/pull-request-check.md) for individual repositories. Publication is off by default, and the default blocking threshold is Critical. Merge blocking requires separate provider configuration; see the [provider support and enforcement table](https://docs.coderabbit.ai/security/pull-request-check.md#provider-support-and-merge-enforcement) for plan requirements and limitations.

### PR security reviews filters

Use the **PR status** filter to show **All**, **Open**, **Merged**, or **Closed** pull requests. **Author** is a searchable multi-select filter for choosing one or more pull request authors. Its menu continues to list all authors while filters are active, so you can switch authors without first clearing the current selection.

Filters apply to the full organization-wide PR security reviews result set before pagination, and the reported total reflects the filtered set. Changing either filter returns the list to page one and closes any open pull request detail.

The PR status filter describes the lifecycle of a pull request. It is separate from the status of each individual security finding.

If an active filter returns no results, **PR security reviews** shows **No pull requests match these filters**. This is distinct from the existing empty state shown when the organization has no security findings from pull request reviews.

### Reachability tiers

| Tier | Meaning |
| - | - |
| `external` | The finding is reachable from an external entry point |
| `internal` | The finding is reachable only from an internal entry point |
| `unreachable` | No reachable path to the finding was identified |

### Exploitability tiers

| Tier | Meaning |
| - | - |
| `trivial` | Exploitation requires minimal effort |
| `moderate` | Exploitation requires some effort or prerequisites |
| `difficult` | Exploitation requires substantial effort or prerequisites |
| `theoretical` | Exploitation is theoretical based on the available evidence |

A dash means no valid tier was available from the live provider review comment. This can happen for older findings or provider responses without the enriched comment body.

## Who can use CodeRabbit Secure

### Supported providers

* GitHub Cloud and GitHub Enterprise Server
* GitLab Cloud and self-hosted GitLab
* Azure DevOps Services and Azure DevOps Server
* Bitbucket Cloud and Bitbucket Data Center

The providers above support repository security settings and code context links. [Fix with AI](https://docs.coderabbit.ai/security/deep-scan.md#fix-with-ai) is available for supported Deep Scan findings on all of them except Azure DevOps Server; fixes for PR review comments have separate provider requirements. Custom scan branches and recurring Deep Scan schedules are currently available only for GitHub repositories.

### Azure DevOps Server support

Azure DevOps Server connected to CodeRabbit Cloud supports Deep Scan, PR security reviews, and the [CodeRabbit Security pull request check](https://docs.coderabbit.ai/security/pull-request-check.md#require-the-status-in-azure-devops). Fix with AI is not available for its Deep Scan findings. Follow the [Azure DevOps Server setup guide](https://docs.coderabbit.ai/management/sso/azure-devops-server.md) to connect your instance. Merge blocking requires a separate branch status policy for `coderabbit/security`.

[Linked repository source access](https://docs.coderabbit.ai/security/deep-scan.md#linked-repositories) for Deep Scan is available on GitHub Cloud, GitHub Enterprise Server, and GitLab Cloud. Its platform and plan requirements are separate from those for scanning a single repository.

### Access and billing

* Viewing Security requires Security read access. Running a Deep Scan requires Security write access, which organization admins have by default.
* Advanced and Enterprise include continuous pull request security review.
* Deep Scan is usage-based and is not included with Advanced or Enterprise. Some organizations can have a separate free allowance; otherwise, usage billing must be enabled.

For detailed usage and billing behavior, see [Usage and limits](https://docs.coderabbit.ai/security/deep-scan.md#usage-and-limits).

## Automate with the API and MCP

Automate this with the [CodeRabbit API and MCP server](https://docs.coderabbit.ai/api.md).

> [accordion] 25 operations
>
> | Operation | Method and path | MCP tool |
> | - | - | - |
> | [List or export Bug Scan findings](https://docs.coderabbit.ai/api/reference/bug-scan-findings-list.md) | `GET /v1/bug-scan/findings` | REST and CLI only |
> | [List security findings](https://docs.coderabbit.ai/api/reference/list-security-findings.md) | `GET /v1/security/findings` | `list_security_findings` |
> | [Export security findings CSV](https://docs.coderabbit.ai/api/reference/export-security-findings-csv.md) | `GET /v1/security/findings/export/csv` | `export_security_findings_csv` |
> | [Get security finding](https://docs.coderabbit.ai/api/reference/get-security-finding.md) | `GET /v1/security/repositories/{repository_id}/findings/{finding_id}` | `get_security_finding` |
> | [Dismiss security finding](https://docs.coderabbit.ai/api/reference/dismiss-security-finding.md) | `POST /v1/security/repositories/{repository_id}/findings/{finding_id}/dismiss` | `dismiss_security_finding` |
> | [Fix security finding](https://docs.coderabbit.ai/api/reference/fix-security-finding.md) | `POST /v1/security/repositories/{repository_id}/findings/{finding_id}/fix` | `fix_security_finding` |
> | [Create security finding Learning](https://docs.coderabbit.ai/api/reference/create-security-finding-learning.md) | `POST /v1/security/repositories/{repository_id}/findings/{finding_id}/learnings` | `create_security_finding_learning` |
> | [Reopen security finding](https://docs.coderabbit.ai/api/reference/reopen-security-finding.md) | `POST /v1/security/repositories/{repository_id}/findings/{finding_id}/reopen` | `reopen_security_finding` |
> | [Set security finding severity](https://docs.coderabbit.ai/api/reference/set-security-finding-severity.md) | `POST /v1/security/repositories/{repository_id}/findings/{finding_id}/severity` | `set_security_finding_severity` |
> | [Preview security finding ticket](https://docs.coderabbit.ai/api/reference/preview-security-finding-ticket.md) | `GET /v1/security/repositories/{repository_id}/findings/{finding_id}/ticket-preview` | `preview_security_finding_ticket` |
> | [Get security runtime validation capability](https://docs.coderabbit.ai/api/reference/get-security-runtime-validation-capability.md) | `GET /v1/security/repositories/{repository_id}/findings/{finding_id}/validation-capability` | `get_security_runtime_validation_capability` |
> | [List security Learnings](https://docs.coderabbit.ai/api/reference/list-security-learnings.md) | `GET /v1/security/repositories/{repository_id}/learnings` | `list_security_learnings` |
> | [Delete security Learning](https://docs.coderabbit.ai/api/reference/delete-security-learning.md) | `DELETE /v1/security/repositories/{repository_id}/learnings/{learning_id}` | `delete_security_learning` |
> | [Update security Learning](https://docs.coderabbit.ai/api/reference/update-security-learning.md) | `PATCH /v1/security/repositories/{repository_id}/learnings/{learning_id}` | `update_security_learning` |
> | [Get security scan schedule](https://docs.coderabbit.ai/api/reference/get-security-scan-schedule.md) | `GET /v1/security/repositories/{repository_id}/scan-schedule` | `get_security_scan_schedule` |
> | [Save security scan schedule](https://docs.coderabbit.ai/api/reference/save-security-scan-schedule.md) | `PUT /v1/security/repositories/{repository_id}/scan-schedule` | `save_security_scan_schedule` |
> | [Delete security scan schedule](https://docs.coderabbit.ai/api/reference/delete-security-scan-schedule.md) | `DELETE /v1/security/repositories/{repository_id}/scan-schedule/{schedule_id}` | `delete_security_scan_schedule` |
> | [Get security scan](https://docs.coderabbit.ai/api/reference/get-security-scan.md) | `GET /v1/security/repositories/{repository_id}/scans/{scan_id}` | `get_security_scan` |
> | [Recover security scan](https://docs.coderabbit.ai/api/reference/recover-security-scan.md) | `POST /v1/security/repositories/{repository_id}/scans/{scan_id}/recover` | `recover_security_scan` |
> | [Get security scan quote](https://docs.coderabbit.ai/api/reference/get-security-scan-quote.md) | `GET /v1/security/repositories/{repository_id}/scans/quote` | `get_security_scan_quote` |
> | [List security runtime validations](https://docs.coderabbit.ai/api/reference/list-security-runtime-validations.md) | `GET /v1/security/repositories/{repository_id}/validations` | `list_security_runtime_validations` |
> | [Get security runtime validation](https://docs.coderabbit.ai/api/reference/get-security-runtime-validation.md) | `GET /v1/security/repositories/{repository_id}/validations/{validation_id}` | `get_security_runtime_validation` |
> | [List security scans](https://docs.coderabbit.ai/api/reference/list-security-scans.md) | `GET /v1/security/scans` | `list_security_scans` |
> | [Start security scans](https://docs.coderabbit.ai/api/reference/start-security-scans.md) | `POST /v1/security/scans` | `start_security_scans` |
> | [List or export AI Deep Scan code findings](https://docs.coderabbit.ai/api/reference/security-scans-code-list.md) | `GET /v1/security/scans/code` | REST and CLI only |

## What's next

> [card] [Deep Scan](https://docs.coderabbit.ai/security/deep-scan.md)
>
> Run a scan of committed source code and infrastructure configuration, then triage and fix what it finds.

> [card] [Attack surface](https://docs.coderabbit.ai/security/attack-surface.md)
>
> Understand how CodeRabbit maps security-relevant code and keeps verification posture current as pull requests merge.

> [card] [Architecture Review](https://docs.coderabbit.ai/security/architecture-review.md)
>
> Assess the security implications of architecture-level changes in a pull request.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.