Skip to content

Exciting News! Puaro is now part of the Google AI Startups Program

DOCUMENTATION

Getting started

Connect Puaro to your repositories in minutes. No agents or CLI required.

Puaro is a cloud SaaS secret scanner for GitHub and GitLab pull requests, merge requests, pushes, full repository scans, and historical commits. There are no agents, CLIs, or self-hosted runners to install. Connect GitHub or GitLab, then select repositories to scan.

Sign up: https://app.puaro.io/sign-up

Prerequisites

  • A Puaro account (free early access at https://app.puaro.io/sign-up)
  • Permission to install Git integrations on your organization or user account
  • For GitHub: org admin or permission to install GitHub Apps on target repos
  • For GitLab.com: access to the groups or projects you want to scan
  • For self-managed GitLab: the instance must be reachable over public HTTPS, plus a personal access token with access to those projects

GitHub (Active)

  1. Sign in at https://app.puaro.io/sign-up
  2. Create or join a Puaro organization in the dashboard
  3. Open Integrations → GitHub → Connect
  4. Authorize the Puaro GitHub App for your GitHub org or user
  5. Select repositories to scan (or enable all repositories)
  6. Open a pull request on a connected repo — Puaro runs a check automatically
  7. Optional: connect Slack under Integrations for real-time alerts
  8. Optional: set policy to block, warn, or notify on findings in repository settings

Verify: A Puaro status check appears on new pull requests within a few minutes of connecting. Optional: open Open fix PR from a finding in the dashboard.

GitLab (Active)

  1. Sign in at https://app.puaro.io/sign-up
  2. Open Integrations → GitLab
  3. For GitLab.com, complete OAuth for your group or namespace
  4. For self-managed GitLab, enter the instance URL and a personal access token. The instance must be reachable over public HTTPS.
  5. Select projects to scan
  6. Open a merge request. Puaro posts results on the MR and can report a commit status and MR notes.
  7. Optional: open Open fix MR from a finding in the dashboard

Scan the current tree and git history

Push scanning covers new commits on connected repositories, including changes outside a pull request or merge request.

Use Full repository scan in the dashboard to scan the current tree. Historical commit scans find credentials removed from the current branch but still present in past commits. These findings are labeled Found in history and include severity and a plain-English explanation.

For current-code findings, use Open fix PR on GitHub or Open fix MR on GitLab and rotate exposed credentials. For historical findings no longer in the current tree, rotate the credential and mark the finding as rotated. A code-edit fix does not remove the credential from git history.

Bitbucket

Bitbucket is not supported. Use GitHub or GitLab.

Slack notifications (optional)

  1. In the Puaro dashboard, go to Integrations → Slack
  2. Connect your workspace and choose a channel
  3. Alerts include severity, repository, and a link to the finding

Policies

  • Block: failing check prevents merge (when your Git provider allows required checks)
  • Warn: check passes with warnings; finding visible on the PR or MR
  • Notify: scan runs; alerts via Slack or email without blocking

Configure per repository in the Puaro dashboard after connecting.

What Puaro does not require

  • No daemon or agent in your infrastructure
  • No modification to application runtime
  • No storage of your source code by default (zero code retention policy)

Related pages

  • Integrations overview: https://puaro.io/integrations
  • Detection methodology: https://puaro.io/methodology
  • Pricing: https://puaro.io/pricing