61 articles and 126 questions, and none of them is yours. Write to us.
support@appscan.shBrowse all 61 articles
Documentation
How AppScan works, what it checks, what it stores and what it costs - 61 articles and 126 questions, all of it public.
Getting started
What AppScan is, how to run the first scan, and what to do with what comes back.
- What AppScan is
An application security platform for people who ship faster than they can review: deterministic detection, one finding per problem, AI only where you ask for it.
- Your first scan, without an account
A URL and an email start a bounded runtime scan. Progress streams live; the report arrives by email and stays at a private link.
- Reading a report
What the headline, the fix-first list, coverage and the finding detail each tell you, and the order to read them in.
- Accounts and organizations
Everything belongs to an organization: sites, scans, findings, credits and people. Here is how that fits together.
- Adding a site
A site is one application. Adding one takes a URL; everything else - repositories, policy, monitoring - hangs off it.
- Connecting GitHub
Installing the GitHub App turns on the source, dependency and infrastructure rules, pull request checks and Fix with AI.
Scanning
How a scan is put together, what each stage looks at, and the limits that keep it bounded.
- The scan pipeline
Nineteen deterministic stages, each producing structured evidence. Not one model reading everything at once.
- Kinds of scan
Free runtime, manual runtime, source inventory, source change, pull request, history and advisory review - what triggers each.
- Coverage and partial scans
Every scan records which steps completed, failed and were skipped. A scan that could not finish says so.
- The real-browser pass
A headless Chromium walks your routes cold and through client navigation, and records every request the page makes.
- Limits, cooldowns and the queue
How many scans can run at once, how long to wait between manual rescans, and how work is prioritized.
- Watching a scan run
Progress streams over server-sent events, in the app and on the free-scan page.
Findings
What a finding is made of, how it is ranked, how it moves through its lifecycle, and how duplicates are avoided.
- The anatomy of a finding
Five questions, a rule id, a location and masked evidence - written deterministically by the rule before any model is asked anything.
- Severity, confidence and domains
Three separate numbers, used together. Severity is impact, confidence is certainty, and the domain says what kind of problem it is.
- The lifecycle of a finding
Open, confirmed, fixing, resolved, verified - and what moves a finding between them.
- Accepted risk and false positives
Two ways to close something you are not going to fix, both recorded, both permanent until you reopen them.
- Why one problem is one finding
A runtime observation and the source that caused it are joined. The code finding is canonical; the live observation is attached as proof.
- The rule catalogue
249 rules across four groups, each with an id that is stamped onto every finding it raises - 110 of them on the free scan.
Code and GitHub
Change sets, pull request verdicts, invariants, dependencies, secrets and deploy files.
- Pushes and change sets
Rapid pushes are coalesced into one change set, classified by what they touched, and scanned once.
- Pull request checks
Findings on a branch are compared with its base: NEW is what this change introduced, UNCHANGED is what it inherited.
- Security invariants
The rules your own code already follows, derived once and re-checked on every commit.
- Dependencies and advisories
Exact versions from your lockfiles, direct and transitive, matched against public advisories and re-checked daily.
- Secret scanning
Sixteen named credential patterns across bundles, diffs, commit messages and a bounded walk of git history.
- Infrastructure and pipelines
Dockerfile, Compose, nginx, Kubernetes, Terraform and GitHub Actions - the files that decide how your app is really exposed.
AI
What AI is used for, what each task costs, and the guards between a model and your bill.
- What AI does, and what it costs
Seven tasks, each with a fixed price in credits and a per-call money cap.
- Fix with AI
A fix written against your file and opened as a draft pull request on a branch of its own.
- Budgets, caps and model routing
Every task is estimated, reserved, capped and routed by difficulty - and refunded when it fails.
- Deep review
The whole application judged at once on the premium tier, paid for once and kept afterwards.
Reports and alerts
What a report contains, how to get the data out, and how you hear about things without being flooded.
- Reports
A report is one application at one moment, with coverage, findings and what changed since last time.
- Exports
CSV, JSON and PDF for reports and issue lists, plus scheduled audit-log exports.
- Alerts, grouping and digests
Instant for what cannot wait, grouped and cooled down so one bad deploy is one message; a digest for the rest.
- Slack
One incoming webhook per organization, carrying the same grouped alerts.
- Notification preferences
The organization sets the baseline; each person narrows it for themselves.
API
The JSON API the app is a client of: base path, authentication, and every endpoint by resource.
- The JSON API
Everything the app does is available over the API, with the same permissions and the same tenancy rules.
- Auth and account
Registering, signing in, refreshing, two-factor, verification, passwords and personal notification preferences.
- Organizations and team
The organization, its members and invitations, notification settings and the AI usage summary.
- Sites and scans
Sites, manual scans, domain verification, monitoring mode, the profile and the overview.
- Free scans
The public scan from the landing page: submit, watch, and read the report by token.
- Findings and reports
Findings with their five answers, status changes, reports and every export format.
- GitHub and change sets
Installing the App, connecting repositories, and reading commits, change sets, dependencies and pull requests.
- AI
Explanations, fixes, the draft pull request, deep scans and what each task costs.
- Billing
The plan, the subscription, checkout, the portal, the trial, invoices, and the public pricing endpoint.
- Audit log and live streams
The append-only audit trail, its sinks and schedules, and the scan event streams.
Team and account
Roles, invitations, two-factor authentication, sessions and the audit trail.
- Roles and invitations
Owner, admin, member and viewer, with invitations that expire and an audit trail.
- Two-factor authentication
TOTP with recovery codes, enforced at the login challenge.
- Passwords, email and sessions
Verification, password changes, resets and how sessions are held.
- The audit log
Append-only, readable by owners and admins, exportable and streamable.
Plans and billing
What each plan includes, how credits work, and what happens when a payment fails.
- Plans and entitlements
Free, Pro at $29, Studio at $49, Agency at $99 and Team by arrangement - with the limits the product actually enforces.
- Credits and usage windows
The unit AI work and manual scans are priced in. Plans include credits per window; top-ups never expire.
- The free trial
Fourteen days of Pro, no card, once per organization.
- Payments, grace, cancellation and refunds
What happens when a card fails, how cancelling works, and how refunds affect credits.
Security and privacy
What a scan is allowed to do, what we keep, and how to report something to us.
- What a scan is allowed to do
Reads only, nothing written, nobody logged in - and one bounded active probe, with its rules written down.
- What we store, and what we never store
Findings, facts, paths and masked evidence. Not your source, not your secrets, not your users’ data.
- Reporting a vulnerability to us
Email security@appscan.sh. What to include, what we will do, and what not to do.
Troubleshooting
When a scan will not run, finds nothing, or does not see what you expected.
- The site will not scan
Why discovery fails, and what to check in order.
- The scan found nothing
Sometimes that is real. Here is how to tell.
- Source findings are missing
Usually the repository is not connected, the language is not analyzed, or inventory has not finished.
- GitHub problems
Missing checks, a repository that will not appear, and installations that vanish.
- Credits went somewhere I did not expect
How to see exactly what spent what, and what can and cannot spend on its own.
Reference
The metrics endpoints, audit streaming, and what every term on this site means.