Documentation Index

Fetch the complete documentation index at: https://docs.safe.security/llms.txt

Use this file to discover all available pages before exploring further.

Exporting Digital Footprint

Prev Next

Overview

The SAFE platform supports exporting Digital Footprint data as CSV reports from the TPRM → Organization Details → Digital Footprint page. Reports are generated asynchronously — once initiated, the report is processed in the background and becomes available for download from the Reports page when ready.

Supported export types:

Export Type

Description

Max Rows

Column Selection

Assets Only

One row per asset

250,000

Asset columns

Assets with Findings

One row per asset-finding combination

250,000

Asset + Finding columns

Prerequisites:

  • Feature flag S0-93203-digital-footprint-export must be enabled

  • Feature flag tprm-new-oi must be enabled

  • User must have the required export permission

  • User must have access to the organization being exported

Assets Only Export

Export Digital Footprint asset data for a third-party organization. One row per unique asset.

  1. Navigate to TPRM > Organizations from the left navigation menu.

  2. Click on the organization you want to export data for.

  3. Navigate to the Digital Footprint tab on the organization details page.

  4. Apply any filters to narrow down the assets (e.g., location, asset type, findings count range).

  5. Click the Download button (↓) in the top-right area of the Digital Footprint assets table.

  6. Select Export Assets from the dropdown menu.

  7. In the Export Digital Footprint dialog:

    • Review the Assets tab with available columns.

    • Select or deselect columns as needed. The modal pre-selects columns currently visible in the table.

    • Note: Max Export Limit: 250,000 rows. If data exceeds the limit, only the first 250,000 rows will be exported.

  8. Click Download to initiate the export.

  9. A success notification will appear confirming the report is being generated.

  10. Navigate to Reports from the left navigation menu to check the status and download the report once ready.

Asset Columns

Display Name

Column Key

Default

Name

name

Yes

IP Address

ip_address

Yes

Location

location

Yes

Findings Count

findings_count

Yes

Updated At

updated_at

Yes

Category

category

No

Products

products

No

Notes

  • Default columns are pre-selected when the export modal opens (unless overridden by the currently visible table columns).

  • IP Address and Products fields display comma-separated values when an asset has multiple entries.

  • The export respects all applied filters (location, asset type, findings count range) and search text

Assets with Findings Export

Export Digital Footprint assets along with their associated findings. One row per asset-and-finding combination. Assets without findings are included with blank finding fields.

  1. Navigate to TPRM > Organizations from the left navigation menu.

  2. Click on the organization you want to export data for.

  3. Navigate to the Digital Footprint tab on the organization details page.

  4. Apply any filters to narrow down the assets.

  5. Click the Download button (↓) in the top-right area of the Digital Footprint assets table.

  6. Select Export Assets with Findings from the dropdown menu.

  7. In the Export Digital Footprint with Findings dialog:

    • Switch between Assets and Findings tabs to select columns from each category.

    • The Assets tab pre-selects columns currently visible in the Digital Footprint table.

    • The Findings tab pre-selects columns currently visible in the asset findings drawer.

    • Note: Max Export Limit: 250,000 rows. If data exceeds the limit, only the first 250,000 rows will be exported.

  8. Click Download to initiate the export.

  9. A success notification will appear confirming the report is being generated.

  10. Navigate to Reports from the left navigation menu to check the status and download the report once ready.

Asset Columns (for With-Findings Export)

Display Name

Column Key

Default

Name

asset_name

Yes

IP Address

ip_address

Yes

Location

location

Yes

Findings Count

findings_count

Yes

Updated At

updated_at

Yes

Category

category

No

Products

products

No

Display Name

Column Key

Default

Finding Name

finding_name

Yes

Security Domain

security_domain

Yes

Finding Severity

finding_severity

Yes

Finding Exposure Score

finding_exposure_score

Yes

Asset Name

asset_name

No

IP Address

ip_address

No

Apex Domain

apex_domain

No

Port

port

No

CVE ID

cve_id

No

CVSS Score

cvss_score

No

CVSS Severity

cvss_severity

No

Status

status

No

First Seen

first_seen

No

Finding ID

finding_id

No

Notes

  • Assets with no findings are still included in the export with blank finding fields.

  • The export defaults to negative (active) findings only.

  • Finding Severity is only populated for CVE-based findings.

  • The export respects all applied filters and search text from the Digital Footprint table.

Reports History Page

All generated reports are accessible from the Reports page in the left navigation.

The Reports page shows:

  • Name — auto-generated report name with timestamp

  • Requested By — email of the user who initiated the export

  • Requested At — timestamp of when the export was initiated

  • Status — current status (In Progress / Success / Failed)

  • Download — download button (available when status is Success)

You can toggle between My Reports and All Reports (admin only) views.

Reports are retained for 7 days after generation, after which they expire and are no longer downloadable.

Export Limits

Export Type

Maximum Rows

Assets Only

250,000

Assets with Findings

250,000

Notes

  • If the data exceeds the row limit, only the first 250,000 rows (sorted by findings count descending for assets, finding score descending for with-findings) are included.

  • A warning message is displayed in the export modal: "Max Export Limit: 250,000 rows. If data exceeds the limit, only the first 250,000 rows will be exported."

  • Reports are exported in CSV format.

  • The export button is disabled when the filtered dataset returns no results.