Skip to main content
A threat is a specific security risk that you want to check your code for. For example, a newly disclosed vulnerability in a common library, or an attack technique that worries your team. The Threats page in Devin Security lists your threats, shows whether your repositories are affected, and collects the findings for each one. Open Security, then Threats, or go to /security/threats.

Where threats come from

The Source column shows where each threat comes from.
  • Cognition: Cognition publishes threats when new risks appear, such as a new class of vulnerability. They show at the top of the Threats page until you act on them.
  • Your team: threats that people in your organization create.

Create a threat

  1. Select New threat.
  2. Enter a Title that names the threat.
  3. Enter a Description of what could happen, and how. Devin uses this text to search your code, so be specific.
  4. Select Create.

Scan for a threat

To check whether a threat affects you, open the threat and select Scan with Devin. Then choose the repositories and start the scan. The scan looks only for that threat. It is faster than a full scan, and its findings are linked to the threat. When a scan for a threat starts, the threat moves to Investigating. The Findings column shows the number of linked findings. It shows Not scanned until the first scan runs.

Focus a scan on threats

You can also select threats when you start a scan from the Scans page. Use Focus on threats to limit Devin’s search to the threats you select. Deep scans limit which threats you can select. See Deep scan.

Auto-triage

Auto-triage scans your repositories each time a new threat is published, so you do not need to start each scan yourself.
  1. On the Threats page, select Auto-triage.
  2. Turn it on and choose the repositories to scan.
  3. Set Severity to triage. Devin scans threats at this severity and above. Low scans every threat.
  4. Optional: turn on Dismiss threats with no findings. When a scan finds nothing for a threat, Devin dismisses the threat.
  5. Select Save.
Auto-triage is an automation named Threat auto-triage. To change it in more detail, open it in Automations.

Threat statuses

The Threats page has three tabs. Active shows Open and Investigating threats. Mitigated and Dismissed show the rest. Use the actions on a threat to select Mark mitigated, Dismiss, or Reopen. Devin does not mark a threat as mitigated for you. Mark it yourself after the fixes for its findings have merged.

Findings for a threat

Open a threat and select View findings to see its findings. On the Findings page, you can also filter by threat. To link an existing finding to a threat, open the finding and select Threat. To remove the link, select Remove from threat. Fix the findings of a threat the same way as any other finding. See Assign fixes to Devin.

Permissions

Your role controls whether you can create and change threats, and whether you can change auto-triage. If an action is not available, ask an administrator to check your access.