// DOCUMENTATION
Documentation.
How Veyra connects, what it requests, how assessments run, and how to read what comes out. Published openly wherever doing so does not expose sensitive implementation detail.
Overview
Veyra is a continuous application security platform. It analyzes the repositories, applications, APIs, and external assets you explicitly authorize, correlates the results, and delivers findings ranked by the risk they create for your business.
This documentation covers onboarding and integration. Deeper reference material — the assessment methodology, the severity model, and the data-handling architecture — lives on dedicated pages linked in the sidebar.
How onboarding works
Six steps, typically completed in under an hour of your time.
-
01
Create your organization
Company name, website, industry, number of developers, and a primary technical contact. This establishes the tenant that everything else is scoped to.
-
02
Authorize assets
Before any testing begins, you explicitly authorize what Veyra may assess: repositories, domains, applications, and APIs, together with testing limitations and environment restrictions. Veyra records the authorizing individual, a timestamp, and the agreement version.
-
03
Connect your repository
Install the Veyra GitHub App and select specific repositories. Read-only. See GitHub integration.
-
04
Add applications
Provide the authorized domains that make up each application — for example
app.customer.comandapi.customer.com— and confirm ownership or authorization for each. -
05
Configure the scan
Choose environments (production, staging, development), allowed domains, excluded endpoints, maximum request rate, and maintenance windows. These limits are enforced on every run.
-
06
Begin the assessment
Progress is visible in the dashboard as each stage completes: repository mapped, dependencies analyzed, secrets analyzed, API routes mapped, authentication analyzed, authorization analyzed, external surface analyzed, findings correlated, report generated.
Core concepts
- ORGANIZATION
- Your tenant. All assets, findings, users, and audit records belong to exactly one organization, and isolation is enforced at the data layer.
- AUTHORIZATION AGREEMENT
- The record that permits Veyra to assess specific assets. Testing cannot begin without one, and changing scope creates a new version.
- ASSET
- A repository, application, domain, or API that Veyra monitors. Plan limits are counted in applications and repositories.
- ASSESSMENT
- One complete analysis run across your authorized assets, producing a set of findings and a report.
- FINDING
- A single security issue with severity, confidence, evidence, an attack path where relevant, and remediation guidance. Identified as
VYR-nnnn. - SECURITY SCORE
- A 0–100 summary of observed posture across eight weighted categories. Not a guarantee — see the model.
Finding lifecycle
Findings move through a defined set of states. Every transition is recorded in your audit log with the actor and timestamp.
| State | Meaning | Who sets it |
|---|---|---|
| Open | Detected and awaiting triage. | Veyra |
| Verified | Evidence confirmed, and where included, reviewed by a security engineer. | Veyra |
| Investigating | Your team has picked it up. | You |
| Fixed | You believe remediation has shipped. Triggers a rescan. | You |
| Resolved | Rescan confirmed the issue is no longer present. | Veyra |
| Regressed | A previously resolved finding has reappeared. | Veyra |
| False positive | Marked by you as not a real issue, with a reason recorded. | You |
| Accepted risk | Acknowledged and deliberately not being fixed, with a reason and optional review date. | You |