LogoLogo
API DocumentationIntegrationsPlexTrac.com
  • Product Documentation
    • Using This Site
    • Security Advisories
    • Deployment and Maintenance Policy
    • Supported Applications
  • PlexTrac Modules
    • Dashboard
    • Clients
      • Clients Components
      • Creating a Client
      • Managing Clients
      • Managing Client Users
      • Adding Assets to a Client
      • Managing Assets
    • Schedule
      • Schedule Components
      • Creating an Engagement
      • Requesting an Engagement
      • Managing Engagements
      • Engagement Status
    • Assessments
      • Assessment Components
      • Managing Questionnaires
      • Starting an Assessment
      • Taking an Assessment
      • Reviewing an Assessment
      • Submitting an Assessment
    • Reports
      • Report Components
      • Creating a Report
      • Adding from NarrativesDB
      • Editing a Report
      • Using Short Codes in Reports
      • Findings
        • Creating a Finding
        • Collaborative Editing
        • Importing Findings from a File
        • CSV Findings Templates
          • Using Report Findings CSV Template
        • Importing Findings via an Integration
        • Importing Findings from WriteupsDB
        • Finding Status
        • Creating Jira Tickets
        • CVSS Scoring
        • Affected Assets
      • Importing a Report
      • Exporting a Report
    • Priorities
      • Priorities Components
      • Creating a Priority
      • Linking Findings and Assets
      • Managing Priorities
      • Priorities Metrics
    • Content Library
      • Types of Repositories
      • NarrativesDB
        • NarrativesDB Home Page
        • Managing Repositories
        • Managing Users
        • Creating a Repository
        • Managing Sections
        • Creating a Section
      • WriteupsDB
        • WriteupsDB Home Page
        • Managing Repositories
        • Managing Users
        • Creating a Repository
        • Creating a Writeup
        • Copying a Writeup
        • Adding to a Report
        • Importing via CSV Template
      • RunbooksDB
        • RunbooksDB Home Page
        • Managing Repositories
        • Managing Users
        • Creating a Repository
        • Creating a Procedure
        • Creating a Technique
        • Creating a Tactic
        • Creating a Methodology
    • Analytics
      • Findings
      • Assets
      • Runbooks
      • Trends & SLAs
    • Runbooks
      • Managing Engagements
        • Starting an Engagement
        • Submitting an Engagement
      • Managing Test Plans
        • Creating a Test Plan
        • Exporting a Test Plan
  • Tenant Management
    • Account Management
      • Profile (Personal Settings)
        • Managing User Profile
        • Managing Password
        • Setting Up Two-Factor Authentication
      • Account Admin
        • Tenant Settings
          • Account Information
          • General Settings
          • Email Settings
          • Tags Settings
          • Service-Level Agreements (SLAs)
          • Short Codes
        • Customizations
          • Layouts
          • Templates
            • Report Templates
            • Export Templates
            • Style Guides
          • Theme
        • Automations
          • Risk Scoring
            • Creating Equations
            • Managing Priority Equations
          • Parser Actions
        • Integrations & Webhooks
          • Integrations (API)
            • Cobalt
            • Edgescan
            • HackerOne
            • Jira
            • ServiceNow
            • Tenable Vulnerability Management
            • Tenable Security Center
          • Webhooks
        • Security & User Management
          • Audit Log
          • Security
            • Authentication Methods
              • OAuth/OpenID Setup
                • Microsoft Entra ID
                • Google OAuth
                • Okta
                • OpenID Connect
              • SAML Setup
            • General Authentication Settings
            • Authorization
            • Role Based Access (RBAC)
              • Custom Roles
            • Classification Tiers
          • Users
            • Adding Users
            • Managing Users
        • Licensing
          • Licensing
          • Priorities
          • Plex AI
            • Using AI
        • White Labeling
      • Help Center
      • Logout
    • Integrations and File Imports
      • Acunetix
      • BlindSPOT
      • Burp Suite
      • Checkmarx
      • Core Impact
      • HCL AppScan
      • Invicti
      • Nessus
      • Nexpose
      • Nipper
      • Nmap (Assets)
      • Nmap Vulners NSE
      • Nodeware
      • NodeZero
      • OpenVAS
      • OWASP ZAP
      • Pentera
      • Qualys (VM Parser)
      • Qualys (Web App Scanner)
      • RapidFire
      • Scythe
      • Veracode
  • API Documentation
    • Overview
    • Concept Definitions
    • Getting Started
    • Retrieving Parameter IDs
    • Object Structures
      • Client Object
      • Report Object
      • Finding Object
      • Asset Object
      • Evidence Object
    • Use Cases
    • API Change Policy
      • API Change Log
    • Webhooks
      • Webhook Payload Structure
      • Verifying Sender Requests
Powered by GitBook

Resources

  • Privacy Policy
  • Terms of Use
  • Vulnerability Policy

© 2025 PlexTrac, Inc. All rights reserved.

On this page
  • Creating an Asset
  • Adding Assets via Bulk Paste
  • Importing Assets to Clients
  • CSV Asset Template Rules
  • Importing Assets

Was this helpful?

Export as PDF
  1. PlexTrac Modules
  2. Clients

Adding Assets to a Client

PreviousManaging Client UsersNextManaging Assets

Last updated 1 month ago

Was this helpful?

Assets within PlexTrac are stored outside of reports at the client level within the platform. An asset can exist as a standalone file in the Clients module or associated with a finding, referred to as an affected asset.

Organizations can efficiently manage and track their cybersecurity resources by organizing and storing assets in PlexTrac. This centralized approach ensures that important files and information are readily accessible when necessary, facilitating collaboration, efficient vulnerability management, and streamlined remediation efforts.

Creating an Asset

Step 1: From the Clients module home page, click the client's row or View under the "Actions" column.

Step 2: Click the Assets tab.

Step 3: Click the Add assets pulldown menu and select Create asset.

Step 4: The "New Asset" modal appears. Enter the desired information into the appropriate fields.

Asset Name is the only required field.

Step 5: Click Save at the bottom of the modal.

The asset now appears in the Assets tab.

Adding Assets via Bulk Paste

Step 1: From the Clients module home page, click the client's row or View under the "Actions" column.

Step 2: Click the Assets tab.

Step 3: Click Add assets, then select Bulk paste assets from the pulldown menu.

Step 4: Paste asset information into the provided box as a return- or comma-separated list. PlexTrac will parse the assets and add them to the finding. URLs with paths (i.e., www.plextrac.com/test/) will be separated into parent and child assets.

Step 5: Click Next.

Step 6: PlexTrac will search for assets in the bulk paste that match existing assets and identify them separately from new assets on the Review tab. This provides the option to deselect any assets before import.

Step 7: Click Next.

Step 8: Add any tags (optional). Click Add X assets.

A message confirming the import and assets are viewable from the Assets tab will appear.

Importing Assets to Clients

PlexTrac supports asset imports using an NMAP file or a CSV template:

  • CSV: PlexTrac provides a template for uploading assets to a client. Click the file below to download the template:

CSV Asset Template Rules

The template is prepopulated with all permitted fields and sample values.

Do not add additional columns or some data may not be imported.

Column Header
Description
Sample Value
Comments

name

Asset Name

temp-asset-1

ip addresses

IP address of the asset

10.0.0.10

criticality

Importance level of the asset

High

data owner

Person responsible for the data

Jane Pentester

physical location

Geographic location of the asset

Boise

system owner

Person responsible for the system

John

ports

Open/closed ports and associated services

22/open/tcp//ssh//OpenSSH 4.3 (protocol 2.0)/

Each port can have up to eight values, separated by a slash. See the Ports section below after the table for more information.

tags

Categorization tags

Karbo

description

Brief description of the asset

csv-desc1

parent

Hierarchical relationship

Child 1

type

Asset type

Workstation

The value for this field must be one of the following: Workstation, Server, Network Device, Application, or General. If another value is used, it will be ignored, and the Asset Type value will display in PlexTrac as "Not Set."

This field is not case-sensitive.

host fqdn

Fully Qualified Domain Name

hostname

Name of the host

temp-asset-1

host rdns

Reverse DNS lookup

4.3.2.1.in-addr.arpa

dns name

DNS name associated with the asset

192.0.2.44

mac address

Media Access Control address

00-B0-D0-63-C2-26

netbios name

NetBIOS name of the asset

temp-asset-1

total cves

Total number of Common Vulnerabilities and Exposures

8

pci status

Payment Card Industry compliance status

Fail

The value for this field must be blank, Passor Fail. If another value is used, it will be ignored, and the Asset Type value will display in PlexTrac as "Not Set."

This field is not case-sensitive.

operating system

OS running on the asset

Windows 11

Ports

Column G ingests port information imported and found in the asset's Notes/Description tab.

Multiple values for the ports cell are separated by commas, such as:

22/open/tcp//ssh//OpenSSH 4.3 (protocol 2.0)/, 25/open/tcp//smtp///, 53/closed/tcp//domain///, 70/open/tcp//gopher///, 80/open/tcp//http//Apache http 2.2.3 ((CentOS))/, 113/open/tcp//auth///, 31337/open/tcp//Elite///

Each port can have up to eight values, separated by a slash. This means there must be seven slash characters (/) for each port ingested, even if no data exists within the slashes. If the correct number of slashes is not used, an import error will appear, and the file will not be accepted.

Examples of valid data values for the ports field:

  • 80///////

  • 80/open//////

  • 80/open/tcp/////

  • 80/closed/tcp/auth////

  • 80/open/tcp/auth/ssh///

  • 80/open/tcp/auth/ssh/test 6//

  • 80/open/tcp/auth/ssh/test 6/Apache http 2.2.3 (CentOS)/

The first value captures the port number. The second value captures the port status (any ports with a status of Closed will not be imported). The third value captures the protocol. The fifth value captures the service, and the seventh value captures the version.

If the port has a defined closed status, the cell is left blank entirely (the field is optional), or just one value is entered (such as 15.22.161.22), then it is not necessary to include all seven slashes.

Importing Assets

Step 1: From the Clients module home page, click the report row or View under the "Actions" column.

Step 2: Click the Assets tab.

Step 3: Click Add assets, then select Bulk paste assets from the pulldown menu.

Step 4: Drag a file into the modal or click the box to navigate to the file on the computer.

Step 5: Click Import.

A message will appear confirming import.

The new assets are displayed on the Assets tab. To view imported values, click View of the imported asset.

To view imported port information, click Notes/Descriptions.

Check "Preserve pasted assets" to treat the pasted content as a monolithic asset. The parser will not attempt to break down the asset into its constituent parts (child assets) or identify potentially vulnerable parameters.

NMAP files: Network Mapper is a network discovery and security auditing utility. More information on NMAP can be found on PlexTrac's section of this site.

free, open-source
Integrations
www.plextrac.com
892B
CSV Asset Upload Template.csv
updated 4-20-2023