Documentation

How to use TensorShield

Connect your stack, read what it finds, approve the fixes, and hand your auditor the evidence. Every step below says what it needs before it will do anything — including the ones that need a model or a scan.

Getting started

Five minutes from sign-up to your first finding. Nothing here needs a credit card, and nothing writes to your systems until you approve it.

  1. 1
    Create your workspace

    Sign up with your work email. That creates a workspace and makes you its owner — you can invite the rest of your team later from Settings → Team. Members you invite get a one-time password they must change on first sign-in.

  2. 2
    Tell us your stage

    Seed, Series A, B or C+. This is the only onboarding question we ask, and it decides which practices you are measured against on the Readiness page — a seed company held to a Series C bar closes the tab. You can preview another stage at any time without committing to it.

  3. 3
    Connect a system

    GitHub, GitLab, Bitbucket or Azure DevOps for code. AWS, Google Cloud or Azure for infrastructure. Google Workspace, Microsoft 365 or Okta for identity. OAuth is read-only by default — we ask for write scopes only when you enable a fix path that needs them.

  4. 4
    Or add a target you own

    For a domain, web app, API or IP range that no connector covers, add it directly. You must confirm you are authorized to scan it, and for standalone targets you can prove control with a DNS TXT record or a well-known file before active testing is allowed.

    Needs: A confirmation that you are authorized to scan the target.

  5. 5
    Read the first results

    Findings land on Issues — deduplicated across tools, ranked, and each one explained in plain English: what it is, why it matters, and the fix. The Coverage page shows exactly which tools ran on which asset, so you never have to take coverage on trust.

The two agents

The scanning, correlation and compliance mapping are deterministic and always run. The two AI agents sit on top of that and need a model — bring your own key under Settings → LLM, or pick a plan that includes one.

  1. AI
    AI Security Engineer — defence

    Reads across code, cloud, SaaS and identity to find what is genuinely exploitable, explains it in your terms, and writes the fix. It works the estate as a graph, so it can say that a key leaked in a repo reaches a specific cloud role — not just that both exist.

    Needs: An LLM key. Without one, scanning, correlation and compliance mapping still run; triage, investigation and proposed fixes do not.

  2. AI
    AI Pentester — offence

    Scoped by rules of engagement you authorize, it works your findings as leads and proves the real ones with a benign proof-of-concept. A finding is only marked exploitation-proven when a deterministic check confirms the demonstration — the model proposes, the framework disposes.

    Needs: An engagement with authorized targets. Active exploitation additionally needs your explicit, named consent.

Approvals — how changes actually happen

Nothing consequential happens without a person. Every proposed change arrives at the Inbox with the finding that justifies it, the diff it would apply, and a plain-English statement of whether it can be undone.

Tier 0–1
Low-risk and reversible — a ticket, a notification. Applied automatically, still recorded in the ledger.
Tier 2
Reversible but consequential — a pull request, a config change. Queued for a human; nothing is applied until someone approves it.
Tier 3
Irreversible or legal — a breach notification draft. Refuses to execute without a named human's signature. It can never auto-apply.
Request changes
Not just approve or reject. Leave a note and the agent re-proposes against it, and the desk shows the thread rather than two unrelated rows.
Kill switch
Halts every autonomous action for the whole workspace at once. It fails closed: the switch beats a pending approval, queued actions wait, and scans are refused with a reason rather than silently doing nothing.

Compliance and evidence

Findings map to controls across 27 frameworks as they are emitted. The mapping is annotation, not judgement — we record which controls a technical finding affects, and never tell you that you are compliant.

Coverage, not a score
Each framework reports how many of its technically-assessable controls we have actually assessed — for example "2 of 9 assessed". Controls no scanner can evaluate need an auditor, and the report says so.
Reports
A Markdown report per framework, listing each gap with the findings that cite it. It opens with an explicit statement that an automated assessment is not a certification.
Evidence pack
Signed with ed25519 over canonical JSON, covering the findings and the state they were assessed against — so an auditor can re-run the proof rather than trust a screenshot.
Access review
The periodic review SOC 2 CC6.2/CC6.3 asks for. Accounts are rebuilt from current findings each time you open it, and a named person keeps or removes each one. A review with nobody in it is never reported as complete.
Trust Center
A shareable page for your own customers, showing assessment coverage per framework. It only makes claims we can back — a workspace that has not been scanned does not advertise continuous monitoring.

Bringing in what we cannot reach

Some surfaces need data from a system we do not have a connector for yet. Each of these accepts a posted snapshot and assesses it with the same grounded checks, and each tells you which checks it could not run on what you sent.

POST /v1/devices/ingest
Laptop and phone posture from your MDM export — disk encryption, screen lock, OS support, EDR.
POST /v1/identity/events
IdP audit events. Detection is correlation-based, so the response names any rule your batch had no material to exercise.
POST /v1/tprm/ingest
Vendor inventory — certifications, data access, DPAs, review dates.
POST /v1/cloud/inventory
Raw cloud state when you would rather post it than grant a role. An inventory with no resources is refused, not stored.
POST /v1/saas/{provider}/snapshot
SaaS configuration for GitHub org, Slack, Zoom, Atlassian, Salesforce, M365 or Google Workspace.
POST /v1/import
Your existing Snyk, Dependabot or SARIF backlog, so day one is not an empty dashboard.

What we do not do

The fastest way to lose your trust is to let you discover a limit on your own. These are the ones worth knowing before you start.

We are not a SIEM
We export findings as newline-delimited JSON for Splunk, Datadog, Panther or Elastic. We do not ingest and triage your logs.
Mobile is source-only
We scan Android and iOS source in a connected repo. We do not decompile a built APK or IPA.
Compliance is not certification
We produce the evidence and the gap list. An auditor issues the report, and a named human signs anything that carries accountability.
Agents need a model
The deterministic engine runs on every plan. The AI Security Engineer and AI Pentester need an LLM key, and their quality depends on the model you configure.

Start with one system

Connect a repo or a cloud account and you will have real findings, mapped to controls, within a scan. The free tier runs the scanning engine; add your own model key when you want the agents.