SecureGraph Documentation
User Guide & Admin Guide · the security command centre for small security teams · Last updated
Contents
1. What is SecureGraph?
SecureGraph (also called SecureGraph AI) is a cybersecurity command centre made by Phantix Labs Ltd in Lagos, Nigeria. It combines vulnerability assessment and penetration testing (VAPT), continuous security testing and a governed AI pentest agent. Every result is verified before it reaches a report, and your security data stays in your own database or in one that we provision.
It is built for organizations that do security work alongside their main work. It tests your systems the way an attacker would, checks every result before you are asked to trust it, and keeps the record of your security position in your own database or in one that we provision. It runs in the browser; there is nothing to install on your computers.
SecureGraph is a set of applications that share one sign-in, one inventory and one findings register:
| Application | What it is for | Address |
|---|---|---|
| Platform | Your organization: people, roles, dual control, the security database, keys, billing. | platform.phantixlabs.com |
| Core | The Command Centre: assets, findings, risk, assurance, reports and the AI assistant. | app.phantixlabs.com |
| Attack | Offensive testing: scopes, scans, VAPT campaigns, mobile testing and the Autonomous Pentest Agent. | attack.phantixlabs.com |
| Defend | Defensive posture: cloud, compliance, risks, incidents, alerts and security operations. | defend.phantixlabs.com |
| Code | Code security: repositories, pull-request review, AutoFix, pipelines and threat models. | code.phantixlabs.com |
2. Core concepts: tests vs. the record
A test is an active check that you start on demand, on a schedule or from your pipeline. It runs against assets in your agreed scope and produces candidate findings for that run.
The record is what SecureGraph builds from your tests over time: the asset inventory, the security graph, the findings register, the risk register and the audit trail. Findings from every test area share one model, so the same weakness found two ways is one finding, and a fix is tracked until a retest confirms it.
3. The test areas: what each one checks
| Area | What it checks | Where in the product |
|---|---|---|
| Asset discovery | Domains, subdomains, IP addresses, APIs, web apps, repositories and mobile builds that belong to you, with exposure and relations. | Core → Assets |
| Network & vulnerability scans | Exposed services and known weaknesses on assets in scope. | Attack → Testing → Scans |
| VAPT campaigns | Multi-step assessments with a fixed scope, approval gates and an optional schedule. | Attack → VAPT → Campaigns |
| Autonomous pentest | Multi-step investigations of web apps and APIs, including access control and business-logic faults, chained into attack paths. | Attack → Agent |
| API security | Object- and function-level authorization, token handling, rate limits and logic flaws. Imports OpenAPI and Postman files. | Attack → Scope |
| Mobile | Android and iOS packages: permissions, exported components and hardcoded secrets. Runtime testing by engagement. | Attack → Mobile |
| Cloud posture | Misconfiguration and exposure in connected cloud accounts, using only the access you grant. | Defend → Cloud |
| Code security | Pull-request and merge-request review, secrets, vulnerable dependencies and code flaws. | Code → Review |
| Pipelines | Pushes and deployments reviewed as they happen. | Code → Automation → Pipelines |
| Threat models | Threats per product, generated from its architecture and requirements. | Code → Threat models |
| Compliance | Controls mapped to the frameworks that apply to you, with evidence and gaps. | Defend → Oversight → Compliance |
Which areas you can use depends on your plan. A locked page says which plan opens it.
4. Before your first test: what to set up
SecureGraph does not test anything until three things are in place. Each one protects you, and the product tells you which one is missing.
| Set up | Why | Where |
|---|---|---|
| Security database | Findings, assets and evidence are written only to your database. Tests stay blocked until it reads ready. | Platform → Database |
| Dual control | Sensitive actions need an initiator and a different authorizer. Assign both before you operate. | Platform → People |
| A verified asset | You prove that you own a target before it can be tested. Unverified assets stay out of scope. | Core → Assets |
The first time you test a target you own, SecureGraph also asks you to accept the Acceptable Use Policy and the Rules of Engagement. It asks once.
5. Running a test: how to
- Open Attack and choose a test: a scan, a VAPT campaign or the Autonomous Pentest Agent.
- Select the targets. A target filter (for example, every asset tagged
external) keeps the scope explicit. - Unlock operate when the dual-control prompt appears. Starting a test is a protected action.
- Watch progress live. You can leave the page; the test continues, and the run is in the job history.
- Approve or decline when the test pauses at a gate. Authentication steps and anything that changes the state of a system wait for a person.
- Open the results. Each finding has its evidence, its impact and its verification state.
- Stopped runs can be resumed from the job history. Completed work is not repeated.
6. Graph, correlation & attack paths
Every asset and finding is placed on the security graph, which shows how your systems relate to each other and where a weakness on one reaches another.
- Correlation merges findings that share a root cause, across test areas, into one tracked finding.
- Attack paths join single weaknesses into the route an attacker would take. A completed chain is recorded as one finding with evidence for each link, and a severity that reflects the whole chain.
- Asset intelligence gives each asset a risk score, an exposure level and its related findings.
- Living context: the product context you describe (projects, components, data flows) keeps threat models and priorities current as your systems change.
7. Dashboards
| Dashboard | Shows | Where |
|---|---|---|
| Overview | Posture score and trend, open findings, open risks, fix rate and findings by surface. | Core → Overview |
| Findings tracker | The live remediation board: owner, due date, evidence and status of every finding. | Core → Findings → Tracker |
| Analytics | Posture, regressions and coverage across every surface over time. | Core → Analytics |
| Assurance | Audit readiness, attestations and continuous control monitoring. | Core → Assurance |
| Posture | Exposure, accepted risks and drift for defensive teams. | Defend → Surface → Posture |
| Platform home | Organization health: setup checklist, database status, people and keys. | Platform → Home |
8. Findings lifecycle
A finding has two separate properties: its evidence (how sure we are) and its status (where the fix is).
Evidence
| Evidence | Means |
|---|---|
| Verified (auto) | SecureGraph confirmed the finding by testing it again independently. |
| Verified (human) | A person on your team reviewed the evidence and confirmed it. |
| Unverified | Waiting for a decision. Stays on the board as work, but appears in reports only as an appendix. |
| Rejected | Ruled out as a false positive. Excluded from reports. |
Status
| Status | Means |
|---|---|
| Open | Not started. |
| In progress | A fix is under way. |
| Fixed | A retest confirmed the fix. The finding is closed. |
| Accepted | Your organization accepted the risk on purpose, with an approval. |
| Retest failed | The fix did not hold. The finding stays open. |
| Regressed | The finding was fixed and has appeared again. |
9. The report types
Reports are generated from verified findings only. The list of types comes from the product, so a new type appears without an update on your side.
| Report | For | Scope |
|---|---|---|
| Executive summary | Boards and leadership | Whole organization |
| Organization security overview | Executives and the board | Whole organization |
| VAPT campaign report | Security and engineering teams | One campaign |
| Compliance report | Auditors and risk owners | Whole organization |
| Findings tracker export | Engineering managers | Whole organization |
| Autonomous pentest report | Security teams | One agent session |
Formats: PDF and DOCX (following the standard VAPT layout), a PPTX board deck, HTML, Markdown, JSON, CSV and XLSX. Markdown and JSON are on every plan; the board-ready packages are on paid plans.
10. Reading a report
- Executive summary first. It is written in plain language from the stored evidence, in both business and technical terms.
- The verification gate panel states how many findings were reportable, and how many were left out as unverified or rejected. A report never hides what it excluded.
- Each finding has its severity, the affected asset, the evidence, the business impact and the steps to fix it.
- Attack paths appear as one finding with each link shown in order.
- The appendix holds unverified candidates for transparency. They never count towards a severity total.
11. What to expect
- SecureGraph supports your security program. It is not a certification and does not replace an auditor.
- Verification removes noise, but no tool guarantees zero false positives or full coverage. Where a category cannot be tested from the outside, the product says so.
- The AI plans and explains. It never invents a finding, changes a risk score or skips an approval.
- The Autonomous Pentest Agent is not unsupervised: authentication and state-changing actions wait for a person.
- Areas marked in development (for example, parts of security operations) say so in the product.
Organization & plans
- Create the organization at platform.phantixlabs.com/register with a work email. A 6-digit code confirms the address.
- The setup wizard asks for the essentials: dual control, your domain, your plan and which applications your company uses.
- Finish the profile from the checklist on Platform → Home. Verification and branding unlock the full experience.
- Free: asset inventory with fair-use limits, light checks, dual control, MFA, the audit trail and JSON/Markdown exports.
- Starter and Growth: VAPT campaigns, verified findings with remediation, pull-request review and the Autonomous Pentest Agent (credit-metered); Growth adds continuous and recurring testing, cloud posture and the compliance workbench.
- Enterprise: multi-company groups, custom branding and retention, white-label reports and an agreed SLA.
Current prices are on the pricing page.
Connecting your security database
Your findings, assets, risks and evidence live in a dedicated PostgreSQL database that you control. Use an empty database or a dedicated schema; SecureGraph never needs your application tables.
Publicly hosted database
- Open Platform → Database and select Connect database, then Publicly hosted.
- Add each SecureGraph address shown on the page to your database allowlist, and tick it.
- Paste the connection string, select Test connection, then Prepare security database.
Database on a private network
- Select On a private network and create a Connector named after where it runs.
- Run the install command shown on the page next to your database. The connector reaches out; nothing needs to reach in.
- When it reads Online, add the database, test it and prepare it.
People, roles & dual control
Add people on Platform → People. Each person gets a role, and access to each application is set per person.
| Slot | How many | Duty |
|---|---|---|
| Initiator | One or more | Proposes and starts protected actions: tests, asset changes, reports. |
| Authorizer | Exactly one | Approves pending actions and risk treatments. Must be a different person from the initiator. |
- Both must use an address on your organization's domain. Personal webmail addresses cannot complete a dual-control sign-in.
- To act, a person unlocks operate with a one-time code. The session expires on its own.
- Reassigning a slot ends the live operate sessions of the previous assignment.
Scope & authorization
- Ownership: an asset is tested only after you prove ownership, for example with a DNS record or an HTTP check.
- Scope is fixed per engagement: once a campaign or agent session starts, its scope cannot be widened.
- Authorization is yours: you confirm that you own, or are authorized to test, every target you connect. SecureGraph supplies the controls; you supply the authorization.
- Scope documents for an external pentest can be drafted in Attack → Scope. Drafts are watermarked as not authorized until the authorizer approves them.
Configuring tests
Test modes
| Mode | What the test is given |
|---|---|
| Blackbox | Nothing. The view of an external attacker. |
| Greybox | Test accounts, API documentation and the inventory. |
| Whitebox | Source, configuration and infrastructure definitions that you supply. |
Autonomy (Autonomous Pentest Agent)
| Level | Behaviour |
|---|---|
| Low | Tight guardrails and short phases. Stops early when idle. |
| Medium | The default. Reconnaissance first, then the agent plans and acts within limits. |
| High | Long, self-directed runs that stop only at a hard limit. |
Approval gates apply at every level. Budgets for time, turns and AI credits are set per session.
Schedules
Recurring VAPT runs are set on Attack → VAPT → Schedules. Pick a window outside your busy hours. Continuous reassessment can also re-run a scope when your product context changes.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| Tests are blocked: security database not ready | The database is not connected or not prepared. | Finish Platform → Database until it reads ready. |
| "Your database allowlist is out of date" | SecureGraph added an address your database does not accept yet. | Add the new address to the allowlist and tick it. |
| An action asks for a code | Operate mode is locked. | Unlock operate with the code sent to you, or ask your authorizer to approve. |
| Cannot assign the authorizer | The address is personal webmail, or it is the same person as the initiator. | Use two different people on your organization's domain. |
| A target is not offered for testing | The asset is unverified or outside the scope. | Verify ownership on the asset, or widen the scope before the engagement starts. |
| "Another scan is running" | One scan job runs at a time per organization. | Wait for it to finish, or cancel it from the job banner. |
| A report has fewer findings than the tracker | Reports include verified findings only. | Verify findings in the tracker, then generate again. |
| "Session ended" card | Your sign-in expired while you were away. | Sign in again; you return to the same page. |
AI governance & audit
- The AI acts as the signed-in person and can do only what that person's role allows.
- Every action that changes something needs a fresh, single-use authorization bound to that action.
- Personal data is removed before any request leaves SecureGraph, and your raw security content is not sent out by default.
- Every AI action, decision and denial is recorded. Review them on Core → Activity and the audit trail.
- AI governance settings, budgets and credits are on Platform → AI.
Integrations & alerts
- GitHub, GitLab and Gitea connect through an app installation or OAuth. Public repositories work on Free; private ones on paid plans.
- Alert channels: email on every plan; Slack, Microsoft Teams, WhatsApp and Telegram when configured.
- Severity routing decides which severities reach which channel.
- Cloud accounts connect with the read access you grant, on Defend → Cloud.
- Browse and install integrations from the Core → Integrations hub.
Privacy & data protection
SecureGraph is designed around data-protection law, including the Nigeria Data Protection Act. Analytics on our sites are first-party, cookieless and off until you accept them. Tenant identifiers are removed before a successful procedure is shared as a reusable skill. Read the privacy notice and the Trust page.
Data & storage
| SecureGraph keeps | Your security database keeps |
|---|---|
| Organization, people and roles | Assets and inventory |
| Billing and entitlements | Test results and findings |
| Dual-control and audit records | Risks and remediation |
| The tooling catalog | Compliance evidence and report sources |
SecureGraph never reads production business data such as ERP or CRM rows, customer personal data or your application tables. Repository analysis happens in a temporary workspace that is removed afterwards.
Remediation & retest
- Verified findings enter the fix queue on the Findings tracker, with step-by-step guidance beside the board.
- Give every row an owner and a due date. Overdue and regressed findings are counted at the top of the board.
- After a fix, retest the single finding from its row. A fix that is not retested stays open.
- Retests replay the original evidence against the same scope and return fixed, still vulnerable or inconclusive.
- In Code, AutoFix can propose a patch as a pull request for you to review.
Support
- Raise a ticket from Core → Support or Platform → Support. Quote your tenant ID for a faster answer.
- Step-by-step how-tos for every page are inside each application under Docs.
- Email [email protected], or use the contact page.
Frequently asked questions
What is SecureGraph?
SecureGraph (also called SecureGraph AI) is a cybersecurity command centre made by Phantix Labs Ltd in Lagos, Nigeria. It combines vulnerability assessment and penetration testing (VAPT), continuous security testing and a governed AI pentest agent. Every result is verified before it reaches a report, and your security data stays in your own database or in one that we provision.
Is SecureGraph AI the same as SecureGraph?
Yes. SecureGraph AI is the name used on our social channels for the same product: SecureGraph by Phantix Labs Ltd. The product lives at securegraph.io and its applications at app.phantixlabs.com, attack.phantixlabs.com, defend.phantixlabs.com, code.phantixlabs.com and platform.phantixlabs.com.
Who makes SecureGraph?
Phantix Labs Ltd, a cybersecurity company based in Lagos, Nigeria, builds and operates SecureGraph.
Do I need to install SecureGraph?
No. SecureGraph runs in the browser. You connect your own security database, or use one that SecureGraph provisions. A database on a private network uses a small connector that reaches out, so nothing needs to reach in.
Does the SecureGraph AI invent findings?
No. The AI plans and explains. It never invents a finding, changes a risk score or skips an approval. Only findings verified by an independent retest or by a person on your team reach an executive report.
Where is my security data stored?
Assets, findings, risks and compliance evidence are written only to your own dedicated PostgreSQL security database. SecureGraph keeps your organization, people, billing and audit records.
Is there a free plan?
Yes. The Free plan includes the asset inventory with fair-use limits, light checks, dual control, MFA, the audit trail and JSON and Markdown exports. No card is needed. Paid plans add VAPT campaigns and the Autonomous Pentest Agent.
What does SecureGraph test?
Web applications, APIs, mobile apps, cloud accounts, code repositories and pipelines, plus asset discovery and compliance mapping. Each test runs only on assets you have verified and placed in scope.