# infisical-secret-scanning

Covers Infisical Secret Scanning, which finds leaked credentials in GitHub, GitLab and Bitbucket repos and in local Git history, with pre-commit hooks.

Skill by Infisical. Category: Security.

## Install

Project (for this project only):

```sh
npx skills add infisical/ai-skills --skill infisical-secret-scanning
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add infisical/ai-skills --skill infisical-secret-scanning -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Warn

Installs: 113. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/infisical/ai-skills/infisical-secret-scanning)

## Source

[Open the source](https://github.com/infisical/ai-skills/tree/HEAD/skills/infisical-secret-scanning). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: infisical-secret-scanning
description: "Guide for Infisical Secret Scanning — detecting leaked credentials in source code and developer systems. Covers the 3 cloud data sources (GitHub via a GitHub Radar connection, GitLab, Bitbucket), full scans vs automatic diff scans on push, finding lifecycle and severity, the `infisical scan` CLI for Git history, working directories, staged changes and CI pipelines, pre-commit hook installation with `infisical scan install --pre-commit-hook`, noise reduction via infisical-scan:ignore, .infisicalignore, entropy thresholds and custom rules, and AWS honey tokens as decoy credentials that alert on use. Use this skill when someone asks about: Infisical secret scanning, finding leaked secrets in a repo, scanning git history for credentials, pre-commit secret scanning, false positives in scanning, or honey tokens. Not for storing secrets so they stop leaking (infisical-setup) or rotating one that leaked (infisical-secret-rotation). GitHub scanning needs a github-radar App Connection, not a github one."
---
# Infisical Secret Scanning Guide

You are a setup assistant helping users detect leaked credentials in source code and respond when
they find them.

Secret Scanning is a **separate Infisical product** with its own project type (`secret-scanning`).

## Two halves that solve different problems

Keep these distinct when advising:

| Half | What it does | When it catches a leak |
|------|-------------|------------------------|
| **Cloud data sources** | Monitor connected GitHub/GitLab/Bitbucket repos | **After** the secret is pushed |
| **CLI (`infisical scan`)** | Scan local directories, Git history, staged changes, CI | **Before** the push, if wired into a hook or pipeline |

A user who only sets up data sources is detecting leaks after they exist. A user who only uses the
CLI has no coverage of what is already in the repo. **Recommend both**: the CLI as a pre-commit hook
to stop new leaks, and a data source to find existing ones and catch anything that bypasses the hook.

## Not this skill

| If the user wants... | Use |
|----------------------|-----|
| To **store** secrets so they stop ending up in code | `infisical-setup` — the actual fix for leaks |
| To **rotate** a credential that leaked | `infisical-secret-rotation` |
| To **revoke** a leaked dynamic credential | `infisical-dynamic-secrets` |
| To create the `github-radar` App Connection | `infisical-app-connections` |
| Audit logs of Infisical activity | `infisical-access-control` |

Worth raising unprompted: scanning is detection, not remediation. When a real finding turns up, the
response is **rotate the credential first**, then clean the history. A secret in Git history is
compromised even after the commit is removed, because it was already cloned. Point users at
`infisical-secret-rotation` as part of the incident response, not as a separate conversation.

## Data sources

`SecretScanningDataSource` values, and the App Connection each requires:

| Data source | Value | App Connection |
|-------------|-------|----------------|
| GitHub | `github` | **`github-radar`** |
| GitLab | `gitlab` | `gitlab` |
| Bitbucket | `bitbucket` | `bitbucket` |

**GitHub scanning needs a `github-radar` connection, not a `github` connection.** They install
different GitHub Apps with different permissions — Radar needs to read repository contents and
receive push webhooks. Using a `github` connection here fails. This is the most common setup error
for this product. See `infisical-app-connections`.

All three trigger automatic scans on **push**.

## How to use this skill

1. **Wire the CLI into pre-commit** so new leaks are stopped at the source
2. **Connect the data sources** for repositories that matter
3. **Run a full scan** to establish a baseline of what already exists
4. **Triage findings** — resolve, mark false positive, or ignore
5. **Tune to reduce noise** so the signal stays credible
6. **Enable automatic diff scans** for ongoing coverage
7. **Consider honey tokens** for detecting misuse rather than exposure

## Reference files

| File | When to read |
|------|-------------|
| `references/scanning-and-findings.md` | Data source setup, scan types and statuses, finding lifecycle and severity, noise reduction |
| `references/cli-and-honey-tokens.md` | `infisical scan` usage, pre-commit hooks, CI integration, AWS honey tokens |

## Guiding principles

- **`github-radar`, not `github`.** Repeat it; it is the error users hit first.
- **Rotate before cleaning history.** A leaked credential is compromised the moment it is pushed. Rewriting history does not un-leak it.
- **False positives destroy the control.** A noisy scanner gets ignored, and then a real finding gets ignored too. Invest in ignore rules and entropy tuning early.
- **Prefer `.infisicalignore` and `infisical-scan:ignore` over disabling rules.** Targeted suppressions keep coverage; disabled rules remove it silently.
- **Pre-commit hooks are advisory, not enforcement.** They can be skipped with `--no-verify`. Back them with CI scanning that cannot be bypassed.
- **Honey tokens detect a different thing.** Scanning finds secrets that leaked; honey tokens tell you someone is *using* stolen credentials. They complement each other.
- **Never echo a discovered secret value** back to the user in full.
````

- Previous: [infisical-access-control](https://syn4pse.dev/terminal/infisical-access-control.md)
- Next: [infisical-app-connections](https://syn4pse.dev/terminal/infisical-app-connections.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
