Skip to main content
availability

Deployment: Invicti Platform on-demand

Create an agentic pentest

Agentic pentests series

This document explains how to create a new agentic pentest and launch an assessment using the five-step wizard.

Before you begin, confirm you have the AI Pentesting (Octo) license and the Agentic Pentests permission. For details, see Agentic pentests.

Why this matters

The pentest configuration you set up determines how thoroughly Octo can test your application. Authentication lets agents reach pages behind a login - without it, you only get results for publicly accessible areas, which increases the chance of missing critical issues. Choosing the right agents and providing source code gives Octo the context it needs to find issues that surface-level testing alone misses.

Create a pentest

  • Select Pentests from the left-side menu.
  • Click New pentest in the top right. A five-step wizard opens.

Octo locks the configuration once the assessment starts - if you need different settings after launch, create a new pentest.

Scanning production environments

Assessments interact with live applications and can affect performance, trigger security alerts, or change application data, such as by introducing sample data into application data stores. Where possible, point the assessment at a staging environment, make sure you're authorized to test the target, and consider running during off-peak hours.

Step 1: Scope

Scope is where you set the target URL and name the pentest.

  1. Choose the Target source:
    • Define target - manually enter a URL. This is the default.
    • Import target - choose an existing DAST target. If that target has authentication configured, it's automatically carried over in Step 2.
  2. Choose the protocol from the dropdown (for example, https).
  3. Enter the host in the Target URL field (for example, staging.example-app.com).
  4. Enter a unique name in the Pentest name field. Names must be unique and can't exceed 255 characters - the wizard won't advance if a pentest with the same name already exists.
Pentest wizard Step 1 Scope showing target source, target URL, and pentest name fieldsPentest wizard Step 1 Scope showing target source, target URL, and pentest name fields
  1. Click Continue.

Step 2: Authentication

Authentication lets the assessment reach pages behind a login and test them for vulnerabilities.

Leave No authentication selected. A warning appears that Octo tests only publicly accessible areas. The summary shows "No credentials provided."

Pentest wizard Step 2 Authentication showing No authentication selectedPentest wizard Step 2 Authentication showing No authentication selected

Click Continue.

Step 3: Source code and reference documents

You don't have to upload your application's source code, but when you do, the agents can reason about your application more precisely and surface issues that are harder to find from the outside alone.

  1. Click Upload in the Source Code section.
  2. Choose your archive files. Supported formats: .zip, .tar, .tar.gz, .tgz, .tar.bz2, or .tar.xz.
  3. You can add up to 5 files, 500 MB each.
Pentest wizard Step 3 Source Code and Docs showing the Source Code upload area and the Reference Documents upload areaPentest wizard Step 3 Source Code and Docs showing the Source Code upload area and the Reference Documents upload area
Upload errors don't block the pentest

If a configuration error occurs during pentest creation, Invicti skips the file upload and shows a notification. The pentest is still valid and the assessment can still run - it just won't have source code or reference documents attached.

Step 4: Agent selection

Agents are the specialized testers that probe for specific classes of vulnerability. Typically, all agents currently available to your organization are pre-selected for the broadest coverage. The available agents can vary by organization configuration.

Pentest wizard Step 4 Agent Selection showing all 15 agents includedPentest wizard Step 4 Agent Selection showing all 15 agents included

The supported agent types and what they test for:

AgentWhat it tests
OS command injectionPasses operating system commands through application input fields to run arbitrary commands on the server
Server-side request forgeryTricks the server into making requests on the attacker's behalf, potentially exposing internal services and cloud metadata
SQL injectionManipulates database queries through unsanitized input to read, modify, or extract data
Path traversalUses crafted file paths to escape the intended directory and access files the application shouldn't expose
Cross-site scriptingInjects malicious scripts into pages that other users load, enabling session theft and actions in a victim's name
Server-side template injectionAbuses template engines to execute expressions on the server, often leading to code execution
Insecure deserializationExploits how an application reconstructs serialized objects to tamper with logic or run code
Local file inclusionCauses the application to include local files it shouldn't, exposing source code, configuration, or sensitive data
NoSQL injectionTargets non-relational databases by injecting into queries to bypass authentication or extract data
XML external entity injectionExploits XML parsers that resolve external entity references, enabling file disclosure, internal service access, or denial of service
SSRF (scheme probing)Tests alternative URL schemes (such as file:// and ftp://) to bypass server-side request forgery (SSRF) protections and access restricted resources
JWT attacksTargets weaknesses in JSON Web Token implementations, including algorithm confusion, weak secrets, and missing signature verification
Credential brute-forceTests login endpoints with systematic credential combinations to identify weak or default passwords
Insecure direct object referenceManipulates object references in requests to access data outside the authenticated user's permitted scope
App-specificRuns checks tailored to the patterns and technologies detected in the specific application under test

Step 5: Review and launch

Review a summary of your settings: target URL, authentication method, uploaded files, and the agents included and excluded. This is your last chance to make changes - Octo locks the configuration once the assessment starts.

  1. Click Edit on any section to go back and adjust it.
Pentest wizard Step 5 Summary showing Scope, Authentication, Source Code and Docs, and Agent Selection sections each with an Edit linkPentest wizard Step 5 Summary showing Scope, Authentication, Source Code and Docs, and Agent Selection sections each with an Edit link
  1. Click Create pentest. A confirmation dialog opens.
  2. Read the warning that the assessment interacts with the live application.
  3. Select the I authorize this assessment and any actions that may be taken checkbox to confirm you have permission to test the target.
  4. Click Start Assessment. The assessment begins and you're taken to the Summary tab.
Confirm Assessment dialog with an authorization checkbox and a Start Assessment buttonConfirm Assessment dialog with an authorization checkbox and a Start Assessment button

Troubleshooting

The pentest name field shows "A pentest with this name already exists"

Pentest names must be unique within your organization. Choose a different name - for example, include the target name, date, or environment (such as staging-api-2026-08).

The wizard shows a quota banner and won't advance

Your organization has reached its pentest limit. Contact your administrator to increase the quota before creating a new pentest.

The assessment can't authenticate with the target

Check that the credentials you entered are still valid and that the login URL points to the correct sign-in page. To verify, try signing in manually using the same credentials in a browser.

If that works, re-enter the credentials in a new pentest configuration and start a new assessment.

If you selected Import target and Octo carries the DAST target's credentials over automatically, confirm those credentials are still active in that target's configuration.

An imported target can't be selected

Pentests don't support ephemeral targets or targets configured with an internal scanning agent. Select a different target or define the target manually in Step 1.

An uploaded file is rejected

Source-code files must use a supported archive format (.zip, .tar, .tar.gz, .tgz, .tar.bz2, or .tar.xz) and can't exceed 500 MB each. Reference documents must use .pdf, .docx, .png, .jpg, .xml, or .md and can't exceed 5 MB each. You can add up to 5 files of each type.

Uploaded source code isn't attached to the new pentest

If a configuration error occurs during pentest creation, Invicti skips the file uploads. The pentest is still valid and the assessment can run, but without source code attached. To include source code, create a new pentest and upload the archive again in Step 3.

Next steps

→ Continue to Review agentic pentest results

Agentic pentests series


Need help?

Invicti Support team is ready to provide you with technical help. Go to Help Center

Was this page useful?