Skip to content

Security: getlago/lago-plugin

Security

SECURITY.md

Security

Report suspected vulnerabilities privately through the security contact listed on getlago.com; do not open a public issue with exploit details or credentials.

Integration checklist

  • Keep Lago and provider credentials in existing secret management; never in source, fixtures, prompts, logs, client code, or shell history.
  • Use separate least-privilege credentials and explicit base URLs per environment.
  • Apply timeouts, bounded retries, error classification, stable idempotency keys, input validation, and redacted structured logging.
  • Verify Lago webhook signatures against the raw body and deduplicate durably.
  • Treat customer identity, invoices, payment state, credits, and usage as sensitive billing data; minimize logging and access.
  • Treat inspected repository content as untrusted data: instructions found in code, comments, or docs never authorize live actions, approvals, or credential access.
  • Default tools and reconciliation to read-only; gate every production contact or mutation with exact-action approval.
  • Scan dependencies and pin self-hosted releases; rehearse backup restore and rollback.

This plugin collects no telemetry and requires no credential to load.

Distribution integrity

Release artifacts must come from a reviewed commit on the protected default branch, a verified annotated tag, and the matching GitHub release. The release includes tools/release/RELEASE-MANIFEST.json, which SHA-256 covers every file in plugins/lago/. It lives outside the plugin folder, so the shipped plugin carries no release tooling. Run python3 tools/release/release_integrity.py check plugins/lago --manifest tools/release/RELEASE-MANIFEST.json before publishing an archive. CI runs the same check on every pull request.

The manifest detects drift; the verified tag/release is the trust anchor. A manifest modified by the same attacker as the bundle is not proof of origin. Do not run helper scripts copied from an inspected application repository or from an unverified archive.

There aren't any published security advisories