Fortinet white logo
Fortinet white logo

Fortinet FortiRecon EASM

Fortinet FortiRecon EASM v1.2.1

About the connector

FortiRecon is a Digital Risk Protection Service (DRPS) product that provides an outside-the-network view of the risks posed to your enterprise.

This document provides information about the Fortinet FortiRecon EASM Connector, which facilitates automated interactions with a Fortinet FortiRecon EASM server using FortiSOARâ„¢ playbooks. Add the Fortinet FortiRecon EASM Connector as a step in FortiSOARâ„¢ playbooks and perform automated operations with Fortinet FortiRecon EASM.

Version information

Connector Version: 1.2.1

FortiSOARâ„¢ Version Tested on: 7.6.4-5623

Fortinet FortiRecon EASM Version Tested on: Version: v25.4.a

Authored By: Fortinet

Contributor: Ramkrushna Pathade

Certified: Yes

Release Notes for version 1.2.1

The following enhancements have been made to the Fortinet FortiRecon EASM Connector in version 1.2.1:

  • Added a new query parameter Show Plaintext Password in the action Get Leaked Credentials
  • Added new query parameters Recon Severity and NVD Severity in the action Get Issues Discovered
  • Updated the output schemas of following actions. Also added Created Time and Modified Time date-range filters to these actions:
    • Get Issues Discovered
    • Get Archived Issues
    • Get IPs
    • Get Domains
    • Get Subdomains
    • Get Prefixes
    • Get Asset ASNs
    • Get Exposed Services
    • Get Archived Assets
    • Get Cloud Integrations
    • Get FortiGate Integrations
    • Get Archived Issue Comments
    • Get Issue Comments
    • Get Tags
    • Get Groups

Installing the connector

Use the Content Hub to install the connector. For the detailed procedure to install a connector, click here.

You can also use the following yum command to install connectors from an SSH session:

sudo yum install cyops-connector-fortinet-fortirecon-easm

Prerequisites for configuring the connector

  • You must have the URL of the Fortinet FortiRecon EASM server to which you will connect and perform automated operations, and credentials to access that server.
  • The FortiSOAR™ server should have outbound connectivity to port 443 on the Fortinet FortiRecon EASM server.

Minimum Permissions Required

  • Not applicable

Configuring the connector

For the procedure to configure a connector, click here.

Configuration parameters

In FortiSOAR™, on the Connectors page, click the Fortinet FortiRecon EASM connector row (if you are in the Grid view on the Connectors page) and in the Configurations tab, enter the required configuration details:

Parameter Description
Server URL Server name or IP address to which you will connect and perform the automated operations.
API Key API key to access the endpoint server to which you connect and perform the automated operations.
Organization ID The organization ID on which FortiRecon operations are to be performed.
Verify SSL Specifies whether the SSL certificate for the server is to be verified.
By default, this option is selected, i.e., set to True.

Actions supported by the connector

The following automated operations can be included in playbooks and you can also use the annotations to access operations:

Function Description Annotation and Category
Get Leaked Credentials Retrieves a list of leaked credentials related to the organization ID based on the keyword to search, breach ID, and date-time range you have specified. get_leaked_credentials
Investigation
Get Scan Statistics Retrieves statistics related to the EASM scan related to the organization ID specified in the configuration parameters. The response includes a count of the total, online, and newly discovered assets for the current and previous scans. get_scan_statistics
Investigation
Get Issues Discovered Retrieves a list of security issues related to assets discovered in the most recent EASM scan based on the filter criteria like issue status, severity, and the country codes (US, IN) you have specified. get_issues_discovered
Investigation
Get Issue By ID Retrieves details about a specific security issue based on the unique issue ID you have specified. get_issue_by_id
Investigation
Get Issue Summary Retrieves the statistics related to security issues discovered in the most recent EASM scan. The response includes a count of the total discovered issues, along with the severity-wise count. get_issue_summary
Investigation
Get Archived Issues Retrieves a list of security issues that have been marked as either Risk Accepted or False Positive based on the asset you have specified. get_archived_issues
Investigation
Get Archived Assets Retrieves a list of assets that have been marked as either Risk Accepted or False Positive. get_archived_assets
Investigation
Get Asset ASNs Retrieves a list of Autonomous System Numbers (ASNs) discovered in the latest EASM scan based on the asset you have specified. get_asset_asns
Investigation
Get ASNs by Asset ID Retrieves details about a specific Autonomous System Number(ASN) based on the asset ID you have specified. get_asns_by_asset_id
Investigation
Get Domains Retrieves a list of domains discovered in the latest EASM scan based on the filter criteria like ports, technologies, and assets you have specified. get_domains
Investigation
Get Domain by Asset ID Retrieves domain details based on the asset ID you have specified. get_domain_by_asset_id
Investigation
Get IPs Retrieves a list of IP addresses discovered in the latest EASM scan based on the filter criteria like ports, country codes, and assets you have specified. get_ips
Investigation
Get IP by Asset ID Retrieves IP address details based on the asset ID you have specified. get_ips_by_asset_id
Investigation
Get Prefixes Retrieves a list of IP prefixes discovered in the latest EASM scan based on the filter criteria, like ASN and assets you have specified. get_prefixes
Investigation
Get Prefixes by Asset ID Retrieves details about a specific IP prefix based on the asset ID you have specified. get_prefixes_by_asset_id
Investigation
Get Subdomains Retrieves a list of subdomains discovered in the latest EASM scan based on the filter criteria like ports, technologies, and assets you have specified. get_subdomains
Investigation
Get Subdomain by Asset ID Retrieves subdomain details based on the asset ID you have specified. get_subdomain_by_asset_id
Investigation
Get Asset Statistics Retrieves the statistics related to assets discovered in the most recent EASM scan. The response includes a count of the total discovered and online assets. get_asset_statistics
Investigation
Get Breaches Retrieves a list of credential breaches related to the organization ID based on the keyword to search and other details you have specified. get_breaches
Investigation
Get Breaches by ID Retrieves details about a specific credential breach based on the breach ID you have specified. get_breaches_by_id
Investigation
Generate Report Initiates the report generation for the latest EASM scan. generate_report
Investigation
Get Report Checks the status of the generated EASM report based on the report ID you have specified. The response contains the S3 URL of the report to download if generated. get_report
Investigation
Get Exposed Services Retrieves a list of exposed services in the latest EASM scan based on the filter criteria like asset, ports, services, and products etc. get_exposed_services
Investigation
Get Cloud Integrations Retrieves a list of cloud integrations based on the filter criteria like provider, connection_status. get_cloud_integrations
Investigation
Get FortiGate Integrations Retrieves a list of FortiGate integrations based on the input parameters specified. get_fgt_integrations
Investigation
Get Security Insights Retrieves the security insights on DNS configurations for the given domain. get_security_insights
Investigation
Get Archived Issue Comments Retrieves a list of comments for the given archived issue ID. get_archived_issue_comments
Investigation
Get Issue Comments Retrieves a list of comments for the given issue ID. get_issue_comments
Investigation
Get Tags Retrieves a list of tags based on scope, name, and other parameters specified. get_tags
Investigation
Get Tag Details Retrieves specific tag details based on the tag ID specified. get_tag_by_id
Investigation
Get Groups Retrieves a list of groups based on scope, name, and other parameters specified. get_groups
Investigation
Get Group Details Retrieves a specific group's details based on the group ID specified. get_group_by_id
Investigation
Update Archived Asset Updates a specific asset's status to Active based on the asset ID specified.
This action removes the specified asset from archived assets; however, its linked assets remain in the archive. The asset will be shown immediately in the profile settings seed section. However, the asset gets scanned again within 24 hours and will then be shown in active assets. If any issues are found during the scan, they are shown on the issues page.
update_archived_asset
Investigation
Mark Archived Issue as Active Updates the status of a specific archived security issue record to Active based on the issue ID specified. update_archived_issue
Investigation
Update Issue Status Updates the status of a specific security issue record based on the security issue ID specified.
If the specified issue status is updated to false_positive or risk_accepted, it will appear in the archived issues.
update_issue_status
Investigation
Update ASN Asset To False Positive Marks a specific ASN asset as a false positive based on the asset ID specified.
This action also marks the specified ASN asset's linked assets as false positives. Once marked, these assets will appear in the archived assets. All issues associated with the specified ASN asset will be removed.
update_asn_asset_status_to_false_positive
Investigation
Update IP Prefix Asset To False Positive Marks a specific IP Prefix asset as a false positive based on the asset ID specified.
This action also marks the specified IP Prefix asset's linked assets as false positives. Once marked, these assets will appear in the archived assets. All issues associated with the specified IP Prefix asset are also removed.
update_prefix_asset_status_to_false_positive
Investigation
Update IP Asset To False Positive Marks a specific IP asset as a false positive based on the asset ID specified.
This action also marks the specified IP asset's linked assets as false positives. Once marked, these assets will appear in the archived assets. All issues associated with the specified IP asset are also removed.
update_ip_asset_status_to_false_positive
Investigation
Update Domain Asset To False Positive Marks a specific domain asset as a false positive based on the asset ID specified.
This action also marks the specified domain asset's linked assets as false positives. Once marked, these assets will appear in the archived assets. All issues associated with the specified domain asset are also removed.
update_domain_asset_status_to_false_positive
Investigation
Update Sub-Domain Asset To False Positive Marks a specific subdomain asset as a false positive based on the asset ID specified.
This action also marks the specified subdomain asset's linked assets as false positives. Once marked, these assets will appear in the archived assets. All issues associated with the specified subdomain asset are also removed.
update_subdomain_asset_status_to_false_positive
Investigation
Update Leaked Credential Status Updates the status of a specific leaked credential record to Active or Resolved, based on the leaked credential ID specified. update_leaked_credential_status
Investigation

operation: Get Leaked Credentials

Input parameters

Parameter Description
Keyword (Optional) Specify the text to search in the email address and the breach name. Specified keywords are searched in these fields: email, breach name, and domain. For example, if you specify user@example.com, the response filters out results and fetches credentials exposed for user@example.com.
Breach ID (Optional) Specify the breach ID to filter the leaked credentials received.
Email ID (Optional) Specify the email ID to filter the leaked credentials retrieved.
Domain (Optional) Specify the domain to filter the leaked credentials retrieved.
Status (Optional) Specify the status to filter the leaked credentials retrieved.
Has Password (Optional) Specify whether to filter the leaked credential list based on whether the credentials contain passwords.
Show Plaintext Password (Optional) Select to show password in plaintext in the response.
Start Date (Optional) Specify the start date to filter the credential leak discovery date. The default is set as the last 6 months.
End Date (Optional) Specify the end date to filter the credential leak discovery date. The default is the current day's date.
Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "total": "",
    "page": "",
    "size": "",
    "hits": [
        {
            "email": "",
            "domain": "",
            "status": "",
            "added_on": "",
            "breach_id": "",
            "breach_date": "",
            "breach_name": "",
            "has_password": "",
            "plaintext_passwords": []
        }
    ]
}

operation: Get Scan Statistics

Input parameters

Parameter Description
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.

Output

The output contains the following populated JSON schema:

{
    "current_scan": {
        "assets": {
            "disappeared": {
                "asn": "",
                "domain": "",
                "ip_address": "",
                "ip_block": "",
                "sub_domain": ""
            },
            "live": "",
            "newly_discovered": {
                "asn": "",
                "domain": "",
                "ip_address": "",
                "ip_block": "",
                "sub_domain": ""
            },
            "total": ""
        },
        "completed_ts": ""
    },
    "previous_scan": {
        "assets": {
            "live": "",
            "total": ""
        },
        "completed_ts": ""
    }
}

operation: Get Issues Discovered

Input parameters

Parameter Description
Status (Optional) Select the status to filter the results. You can choose from the following options:
  • Active
  • Resolved
  • Risk Accepted
  • False Positive
Severity (Optional) Select the severity to filter the results. You can choose from the following options:
  • Critical
  • High
  • Medium
  • Low
NVD Severity (Optional) Select the NVD severity to filter the results. You can choose from the following options:
  • Critical
  • High
  • Medium
  • Low
Recon Severity (Optional) Select the Recon severity to filter the results. You can choose from the following options:
  • Critical
  • High
  • Medium
  • Low
Countries (Optional) Specify the country code to filter the discovered issues. Specify the countries as comma-separated values to get all those results that have any of the specified countries. For example: IN,US
Bucket ID (Optional) Specify the bucket IDs to filter the results. You can choose from the following options:
  • Exposed Remote Service
  • Vulnerable Software
  • Exposed Management Service
  • Certificate Issues
  • DNS Health (email)
  • DNS Health
  • Exposed Database Service
  • Reputation
  • Mis Configuration
  • Missing Encryption
  • Exposed Insecure Service
Issue Name Identifier (Optional) Specify the issue name identifiers to filter the results, as comma-separated values. For example: ip_blacklist,cve_2019_1234
Asset Type (Optional) Select the asset type to filter the discovered issues. You can choose from the following options:
  • IP Address
  • ASN Number
  • Domain Name
  • Sub Domain
  • IP Prefix
Asset (Optional) Specify the asset to filter the results. For example: test.example.com
Search Type (Optional) Specify the search type to filter the retrieved issues.

NOTE: Use the Asset parameter, along with this parameter, to search.

Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "issue_name": "",
            "asset": "",
            "asset_type": "",
            "country": "",
            "severity": "",
            "nvd_severity": "",
            "recon_severity": "",
            "port": "",
            "bucket": "",
            "status": "",
            "user_name": "",
            "issue_name_identifier": "",
            "bucket_id": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Issue By ID

Input parameters

Parameter Description
Issue ID Specify the issue ID to get details about that specific security issue.

Output

The output contains the following populated JSON schema:

{
    "total": "",
    "page": "",
    "size": "",
    "hits": [
        {
            "email": "",
            "domain": "",
            "status": "",
            "added_on": "",
            "breach_id": "",
            "breach_date": "",
            "breach_name": "",
            "has_password": "",
            "plaintext_passwords": []
        }
    ]
}

operation: Get Issue Summary

Input parameters

Parameter Description
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "asset": "",
            "asset_type": "",
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "issue_name": "",
            "port": "",
            "status": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "created_ts": "",
            "modified_ts": "",
            "user_name": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Archived Issues

Input parameters

Parameter Description
Status (Optional) Select the status to filter the retrieved archived issues. You can choose from the following options:
  • Risk Accepted
  • False Positive
Asset Type (Optional) Select the asset type to filter the retrieved archived issues. You can choose from the following options:
  • IP Address
  • ASN Number
  • Domain Name
  • Sub Domain
  • IP Prefix
Asset (Optional) Specify the asset to filter the retrieved archived issues. For example: asset.example.com
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "asset": "",
            "asset_type": "",
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "user_action": "",
            "user_name": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Archived Assets

Input parameters

Parameter Description
User Action (Optional) Select the user action based on which to filter the fetched archived assets. You can choose from the following options:
  • False Positive
  • Deleted
Asset Type (Optional) Select the asset type to filter the archived assets. You can choose from the following options:
  • IP Address
  • ASN Number
  • Domain Name
  • Sub Domain
  • IP Prefix
Asset (Optional) Specify the asset to filter the retrieved archived assets. For example: asset.example.com
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "asset": "",
            "asset_type": "",
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "user_action": "",
            "user_name": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Asset ASNs

Input parameters

Parameter Description
Search Type (Optional) Specify the search type to filter the results.

NOTE: Use the Asset parameter to search along with this parameter.

Asset (Optional) Specify the asset to filter the results. For example: AS0000.
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Discovered By FortiGate Integration (Optional) Select whether to fetch assets discovered via FortiGate integrations. You can choose from the following options:
  • True: Select this option to fetch assets discovered via FortiGate integrations.
  • False: Select this option to fetch assets not discovered via FortiGate integrations.
Cloud Metadata (Optional) Specify the cloud metadata in JSON format to filter the results. Available fields are: integration_id, cloud_provider, account_id, resource_id, resource_group, resource_name, resource_type, region, and subscription_id. For example:
  {
      "cloud_provider": [
        "azure"
      ],
      "region": [
        "westus2"
      ],
      "integration_id": [
        "777408f550e5rrdd1hjf3w90"
      ],
      "resource_name": [
        "TestAssetsPublic"
      ]
  }
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "asset": "",
            "assets_linked_count": "",
            "company_name": "",
            "fgt_metadata": {},
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "created_ts": "",
            "modified_ts": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ]
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get ASNs by Asset ID

Input parameters

Parameter Description
Asset ID Specify the asset ID to retrieve the ASN details.
Linked Assets (Optional) Select to retrieve linked assets. By default, it is unchecked and set to False.

Output

The output contains the following populated JSON schema:

Output schema when you choose Linked Assets as false:

{
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "asset": "",
    "assets_linked_count": "",
    "company_name": "",
    "fgt_metadata": {},
    "created_ts": "",
    "modified_ts": "",
    "discovery_path": [
        {
            "source": "",
            "module": "",
            "name": "",
            "target": "",
            "data_type": ""
        }
    ]
}

Output schema when you choose Linked Assets as true:

{
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "asset": "",
    "assets_linked_count": "",
    "company_name": "",
    "fgt_metadata": {},
    "discovery_path": [
        {
            "source": "",
            "module": "",
            "name": "",
            "target": "",
            "data_type": ""
        }
    ],
    "assets_linked": []
}

operation: Get Domains

Input parameters

Parameter Description
Ports (Optional) Specify the ports to filter retrieved domains. Specify the ports as comma-separated values to get only those results that have all of the specified ports. For example 8080,443
Technologies (Optional) Specify the ports to filter retrieved domains. Specify a comma-separated string or a single string. For example MySQL,Bootstrap
Asset (Optional) Specify the asset to filter retrieved domains.
Search Type (Optional) Specify the search type to filter retrieved domains.

NOTE: Use the Asset parameter to search along with this parameter.

Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Discovered By FortiGate Integration (Optional) Select whether to fetch domains discovered via FortiGate integrations. You can choose from the following options:
  • True: Select this option to fetch domains discovered via FortiGate integrations.
  • False: Select this option to fetch domains not discovered via FortiGate integrations.
Is Live (Optional) Select whether to fetch domains that are live. You can choose from the following options:
  • True: Select this option to fetch domains that are live.
  • False: Select this option to fetch domains that are not live, i.e., offline.
Discovered By Cloud Integration (Optional) Select whether to fetch domains discovered via Cloud integrations. You can choose from the following options:
  • True: Select this option to fetch domains discovered via Cloud integrations.
  • False: Select this option to fetch domains not discovered via Cloud integrations.
Cloud Metadata (Optional) Specify the cloud metadata in JSON format to filter the results. Available fields are: integration_id, cloud_provider, account_id, resource_id, resource_group, resource_name, resource_type, region, and subscription_id. For example:
  {
      "cloud_provider": [
          "azure"
      ],
      "region": [
          "westus2"
      ],
      "integration_id": [
          "777408f550e5rrdd1hjf3w90"
      ],
      "resource_name": [
          "TestAssetsPublic"
      ]
  }
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "asset": "",
            "assets_linked_count": "",
            "cloud_metadata": {
                "region": "",
                "resource_id": "",
                "resource_name": "",
                "resource_type": "",
                "cloud_provider": "",
                "resource_group": "",
                "customer_integration_name": ""
            },
            "confidence": "",
            "domain_expiry": "",
            "fgt_metadata": {
                "virtual_ip": [
                    {
                        "name": "",
                        "protocol": "",
                        "mapped_ip": "",
                        "mapped_ports": "",
                        "external_ports": "",
                        "mapped_device_mac": "",
                        "mapped_device_os_name": ""
                    }
                ],
                "interface_id": "",
                "integration_id": "",
                "interface_name": "",
                "integration_type": "",
                "customer_integration_name": ""
            },
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "ip_address": "",
            "nameserver": [],
            "original_ip": [],
            "ports": [],
            "ssl_cert_org": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "technologies": [],
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Domain by Asset ID

Input parameters

Parameter Description
Asset ID Specify the asset ID to retrieve its associated domain details.
Linked Assets (Optional) Select to retrieve linked assets. By default, it is unchecked and set to false.

Output

The output contains the following populated JSON schema:

Output schema when you choose Linked Assets as false:

{
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "asset": "",
    "ports": [],
    "ssl_cert_org": "",
    "ip_address": "",
    "technologies": [],
    "confidence": "",
    "domain_expiry": "",
    "nameserver": [],
    "original_ip": [],
    "cloud_metadata": {
        "region": "",
        "resource_id": "",
        "resource_name": "",
        "resource_type": "",
        "cloud_provider": "",
        "resource_group": "",
        "customer_integration_name": ""
    },
    "fgt_metadata": {
        "customer_integration_name": "",
        "integration_id": "",
        "integration_type": "",
        "interface_id": "",
        "interface_name": "",
        "virtual_ip": [
            {
                "external_ports": "",
                "mapped_device_mac": "",
                "mapped_device_os_name": "",
                "mapped_ip": "",
                "mapped_ports": "",
                "name": "",
                "protocol": ""
            }
        ]
    },
    "assets_linked_count": "",
    "issue_count": "",
    "created_ts": "",
    "modified_ts": "",
    "discovery_path": [
        {
            "source": "",
            "module": "",
            "name": "",
            "target": "",
            "data_type": ""
        }
    ]
}

Output schema when you choose Linked Assets as true:

{
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "asset": "",
    "ports": [],
    "ssl_cert_org": "",
    "ip_address": "",
    "technologies": [],
    "confidence": "",
    "domain_expiry": "",
    "nameserver": [],
    "original_ip": [],
    "cloud_metadata": {
        "region": "",
        "resource_id": "",
        "resource_name": "",
        "resource_type": "",
        "cloud_provider": "",
        "resource_group": "",
        "customer_integration_name": ""
    },
    "fgt_metadata": {
        "customer_integration_name": "",
        "integration_id": "",
        "integration_type": "",
        "interface_id": "",
        "interface_name": "",
        "virtual_ip": [
            {
                "external_ports": "",
                "mapped_device_mac": "",
                "mapped_device_os_name": "",
                "mapped_ip": "",
                "mapped_ports": "",
                "name": "",
                "protocol": ""
            }
        ]
    },
    "assets_linked_count": "",
    "issue_count": "",
    "discovery_path": [
        {
            "source": "",
            "module": "",
            "name": "",
            "target": "",
            "data_type": ""
        }
    ],
    "assets_linked": []
}

operation: Get IPs

Input parameters

Parameter Description
Ports (Optional) Specify the ports to filter the retrieved IP addresses. Specify the ports as comma-separated values to get only those results that have ALL of the specified ports. For example: 8080,443.
Countries (Optional) Specify the country code to filter the discovered issues. Specify the countries as comma-separated values to get all those results that have ANY of the specified countries. For example: IN,US
Asset (Optional) Specify the asset to filter the retrieved IP addresses.
Search Type (Optional) Select the search type to filter the retrieved IPs. You can choose from the following options:
  • Exact
  • Begins with
  • Ends with
  • Wildcard

NOTE: Use the Asset parameter to search along with this parameter.

IP Prefix (Optional) Specify an IP address prefix to filter the retrieved IP addresses.
Version (Optional) Select the IP version by which to retrieve records. You can choose from the following options:
  • 4: Select to retrieve IPv4 IP addresses.
  • 6: Select to retrieve IPv6 IP addresses.
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Discovered By FortiGate Integration (Optional) Select whether to fetch IP addresses discovered via FortiGate integrations. You can choose from the following options:
  • True: Select this option to fetch IP addresses discovered via FortiGate integrations.
  • False: Select this option to fetch IP addresses not discovered via FortiGate integrations.
Is Live (Optional) Select whether to fetch IP addresses that are live. You can choose from the following options:
  • True: Select this option to fetch IP addresses that are live.
  • False: Select this option to fetch IP addresses that are not live, i.e., offline.
Discovered By Cloud Integration (Optional) Select whether to fetch IP addresses discovered via Cloud integrations. You can choose from the following options:
  • True: Select this option to fetch IP addresses discovered via Cloud integrations.
  • False: Select this option to fetch IP addresses not discovered via Cloud integrations.
Cloud Metadata (Optional) Specify the cloud metadata in JSON format to filter the results. Available fields are: integration_id, cloud_provider, account_id, resource_id, resource_group, resource_name, resource_type, region, and subscription_id. For example:
  {
      "cloud_provider": [
          "azure"
      ],
      "region": [
          "westus2"
      ],
      "integration_id": [
          "777408f550e5rrdd1hjf3w90"
      ],
      "resource_name": [
          "TestAssetsPublic"
      ]
  }
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "total": "",
    "page": "",
    "size": "",
    "hits": [
        {
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "ip_prefix": "",
            "asset": "",
            "ports": [],
            "cloud_metadata": {},
            "fgt_metadata": {},
            "discovery_path": [],
            "assets_linked_count": "",
            "version": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ]
}

operation: Get IP by Asset ID

Input parameters

Parameter Description
Asset ID Specify the asset ID to retrieve the IP address details.
Linked Assets (Optional) Select to retrieve linked assets. By default, it is unchecked and set to False.

Output

The output contains the following populated JSON schema:

Output schema when you choose Linked Assets as false:

{
    "tags": [],
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "ip_prefix": "",
    "asset": "",
    "ports": [],
    "cloud_metadata": {},
    "fgt_metadata": {},
    "assets_linked_count": "",
    "version": "",
    "issue_count": "",
    "created_ts": "",
    "modified_ts": "",
    "discovery_path": [
        {
            "source": "",
            "module": "",
            "name": "",
            "target": "",
            "data_type": ""
        }
    ]
}

Output schema when you choose Linked Assets as true:

{
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "ip_prefix": "",
    "asset": "",
    "ports": [],
    "cloud_metadata": {},
    "fgt_metadata": {},
    "assets_linked_count": "",
    "version": "",
    "issue_count": "",
    "discovery_path": [
        {
            "source": "",
            "module": "",
            "name": "",
            "target": "",
            "data_type": ""
        }
    ],
    "assets_linked": []
}

operation: Get Prefixes

Input parameters

Parameter Description
Asset (Optional) Specify the asset to filter the retrieved IP address prefix. For example: 185.161.83.0/24.
Search Type (Optional) Specify the search type to filter the retrieved prefixes.

NOTE: Use the Asset parameter to search along with this parameter.

ASN (Optional) Specify the ASN to filter the retrieved IP address prefixes. For example: AS207180
Version (Optional) Select the IP version by which to filter retrieved records. You can choose from the following options:
  • 4: Select to retrieve IPv4 IP addresses.
  • 6: Select to retrieve IPv6 IP addresses.
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Discovered By FortiGate Integration (Optional) Select whether to fetch IP addresses discovered via FortiGate integrations. You can choose from the following options:
  • True: Select this option to fetch IP addresses discovered via FortiGate integrations.
  • False: Select this option to fetch IP addresses not discovered via FortiGate integrations.
Cloud Metadata (Optional) Specify the cloud metadata in JSON format to filter the results. Available fields are: integration_id, cloud_provider, account_id, resource_id, resource_group, resource_name, resource_type, region, and subscription_id. For example:
  {
      "cloud_provider": [
          "azure"
      ],
      "region": [
          "westus2"
      ],
      "integration_id": [
          "777408f550e5rrdd1hjf3w90"
      ],
      "resource_name": [
          "TestAssetsPublic"
      ]
  }
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "asn_number": "",
            "asset": "",
            "assets_linked_count": "",
            "company_name": "",
            "fgt_metadata": {},
            "discovery_path": [],
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "ip_count": "",
            "live_ip_count": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "version": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Prefixes by Asset ID

Input parameters

Parameter Description
Asset ID Specify the asset ID to retrieve the IP prefix details.
Linked Assets (Optional) Select to retrieve linked assets. By default, it is unchecked and set to false.

Output

The output contains the following populated JSON schema:

Output schema when you choose Linked Assets as false:

{
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "asn_number": "",
    "asset": "",
    "company_name": "",
    "ip_count": "",
    "assets_linked_count": "",
    "version": "",
    "live_ip_count": "",
    "fgt_metadata": {},
    "discovery_path": [
        {
            "name": "",
            "module": "",
            "source": "",
            "target": "",
            "data_type": ""
        }
    ],
    "created_ts": "",
    "modified_ts": ""
}

Output schema when you choose Linked Assets as true:

{
    "id": "",
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "asset": "",
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "version": "",
    "ip_count": "",
    "asn_number": "",
    "company_name": "",
    "fgt_metadata": {},
    "assets_linked": [],
    "live_ip_count": "",
    "discovery_path": [
        {
            "name": "",
            "module": "",
            "source": "",
            "target": "",
            "data_type": ""
        }
    ],
    "assets_linked_count": "",
    "created_ts": "",
    "modified_ts": ""
}

operation: Get Subdomains

Input parameters

Parameter Description
Ports (Optional) Specify the ports to filter the retrieved subdomains. Specify the ports as comma-separated values to get only those results that have ALL of the specified ports. For example: 8080,443.
Technologies (Optional) Specify the technology discovered on the subdomain to filter the retrieved subdomains. Specify a comma-separated string or a single string. For example MySQL,Bootstrap.
Domain (Optional) Specify a domain to filter the retrieved subdomains.
Asset (Optional) Specify the asset to filter the retrieved subdomains.
Search Type (Optional) Specify the search type to filter the retrieved subdomains.

NOTE: Use Asset parameter to search along with this parameter.

Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Discovered By FortiGate Integration (Optional) Select whether to fetch subdomains discovered via FortiGate integrations. You can choose from the following options:
  • True: Select this option to fetch subdomains discovered via FortiGate integrations.
  • False: Select this option to fetch subdomains not discovered via FortiGate integrations.
Is Live (Optional) Select whether to fetch subdomains that are live. You can choose from the following options:
  • True: Select this option to fetch subdomains that are live.
  • False: Select this option to fetch subdomains that are not live, i.e., offline.
Discovered By Cloud Integration (Optional) Select whether to fetch subdomains discovered via Cloud integrations. You can choose from the following options:
  • True: Select this option to fetch subdomains discovered via Cloud integrations.
  • False: Select this option to fetch subdomains not discovered via Cloud integrations.
Cloud Metadata (Optional) Specify the cloud metadata in JSON format to filter the results. Available fields are: integration_id, cloud_provider, account_id, resource_id, resource_group, resource_name, resource_type, region, and subscription_id. For example:
  {
      "cloud_provider": [
          "azure"
      ],
      "region": [
          "westus2"
      ],
      "integration_id": [
          "777408f550e5rrdd1hjf3w90"
      ],
      "resource_name": [
          "TestAssetsPublic"
      ]
  }
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "id": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "asset": "",
            "ports": [],
            "groups": [],
            "ip_address": "",
            "domain_name": "",
            "fgt_metadata": {},
            "technologies": [],
            "discovery_path": [],
            "cloud_metadata": {},
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Subdomain by Asset ID

Input parameters

Parameter Description
Asset ID Specify the asset ID to retrieve the subdomain details.

Output

The output contains the following populated JSON schema:

{
    "id": "",
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "asset": "",
    "ports": [],
    "groups": [],
    "ip_address": "",
    "domain_name": "",
    "issue_count": "",
    "fgt_metadata": {},
    "technologies": [],
    "cloud_metadata": {},
    "discovery_path": [
        {
            "name": "",
            "module": "",
            "source": "",
            "target": "",
            "data_type": ""
        }
    ],
    "created_ts": "",
    "modified_ts": ""
}

operation: Get Asset Statistics

Input parameters

Parameter Description
Ports (Optional) Specify the ports to filter the asset statistics. Specify the ports as comma-separated values to get only those results that have ALL of the specified ports. For example: 8080,443.
Countries (Optional) Specify the country code to filter the discovered issues. Specify the countries as comma-separated values to get all those results that have ANY of the specified countries. For example: IN,US
Technologies (Optional) Specify the technologies to filter the asset statistics. Specify a comma-separated string or a single string. For example MySQL,Bootstrap.
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.

Output

The output contains the following populated JSON schema:

{
    "org_name": "",
    "asn_count": "",
    "ip_prefix_count": "",
    "live_domain_count": "",
    "total_domain_count": "",
    "billable_assets_count": "",
    "live_ip_address_count": "",
    "live_sub_domain_count": "",
    "total_ip_address_count": "",
    "total_sub_domain_count": ""
}

operation: Get Breaches

Input parameters

Parameter Description
Breach Name (Optional) Specify the breach name to retrieve specific breach details. For example: test-org. The response filters out results and fetches credentials exposed for test-org.
Keyword (Optional) Specify the text to search in the breach name, details, and list of compromised data. For example:test-org. The response filters out results and fetches credentials exposed for test-org.
Has Password (Optional) Select to filter the leaked credential list based on whether the credentials contain passwords.
Is Relevant (Optional) Select to filter the leaked credential list related to an organization.
Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "id": "",
            "date": "",
            "name": "",
            "details": "",
            "added_on": "",
            "has_password": "",
            "affected_domains": "",
            "compromised_data": "",
            "compromised_accounts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Breaches by ID

Input parameters

Parameter Description
Breach ID Specify the breach ID to retrieve the breach details.

Output

The output contains the following populated JSON schema:

{
    "id": "",
    "date": "",
    "name": "",
    "details": "",
    "added_on": "",
    "has_password": "",
    "compromised_data": "",
    "compromised_accounts": ""
}

operation: Generate Report

Input parameters

Parameter Description
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.

Output

The output contains the following populated JSON schema:

{
    "report_id": ""
}

operation: Get Report

Input parameters

Parameter Description
Report ID Specify the report ID to retrieve the report details.
Get Report Link (Optional) Select the checkbox to get an S3 link to a report file. Clear the checkbox to retrieve file data. By default, this checkbox is cleared, i.e., set to false.

Output

The output contains the following populated JSON schema:

The output schema when you choose *Get Report Link* as `true`:

{
    "report_url": ""
}

The output schema when you choose *Get Report Link* as `false`:

{
    "asn": [],
    "domain": [
        {
            "tags": "",
            "asset": "",
            "groups": "",
            "ip_address": "",
            "open_ports": "",
            "technologies": "",
            "total_issues": "",
            "discovery_path": "",
            "subdomain_count": ""
        }
    ],
    "issues": [
        {
            "port": "",
            "tags": "",
            "asset": "",
            "groups": "",
            "severity": "",
            "issue_name": "",
            "issue_status": "",
            "linked_assets": "",
            "issue_category": "",
            "recommendations": "",
            "additional_details": ""
        }
    ],
    "ip_block": [],
    "ip_address": [
        {
            "tags": "",
            "asset": "",
            "groups": "",
            "country": "",
            "open_ports": "",
            "total_issues": "",
            "linked_assets": "",
            "discovery_path": ""
        }
    ],
    "sub_domain": [
        {
            "tags": "",
            "asset": "",
            "groups": "",
            "open_ports": "",
            "technologies": "",
            "total_issues": "",
            "linked_assets": "",
            "discovery_path": ""
        }
    ],
    "organization": [],
    "disappeared_assets": [
        {
            "asset": "",
            "asset_type": ""
        }
    ],
    "newly_discovered_assets": [
        {
            "asset": "",
            "asset_type": ""
        }
    ]
}

operation: Get Exposed Services

Input parameters

Parameter Description
Asset (Optional) Specify the asset to filter the retrieved exposed services.

NOTE: The only supported asset types are the IP address, domain, and subdomain.

Ports (Optional) Specify the ports to filter the retrieved exposed services. Specify the ports as comma-separated values to get only results with ALL the specified ports. For example: 8080,443.
Services (Optional) Specify the services to filter the retrieved exposed services. Specify the services as comma-separated values to get only those results that have ANY of the specified services. For example: http,https.
Products (Optional) Specify the products to filter the retrieved exposed services. Specify a comma-separated string or a single string. For example: nginx, Jetty.
Services Banner (Optional) Specify the keywords in the service banner to filter the retrieved exposed services.

NOTE: Do not use *; it is added implicitly.

After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Has SSL (Optional) Select whether to fetch assets that have SSL. You can choose from the following options:
  • True: Select this option to fetch assets that have SSL.
  • False: Select this option to fetch assets that do not have SSL.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "cpe": [],
            "domains": [],
            "ip_address": "",
            "os": "",
            "port": "",
            "product": "",
            "service": "",
            "service_banner": "",
            "ssl": {},
            "subdomains": [],
            "version": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Cloud Integrations

Input parameters

Parameter Description
Provider (Optional) Specify the provider to filter the retrieved cloud integrations.
Connection Status (Optional) Select the connection status to filter the retrieved cloud integrations. You can choose from the following options:
  • Success
  • Failed
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "name": "",
            "provider": "",
            "account_id": "",
            "policy_errors": [],
            "connection_status": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get FortiGate Integrations

Input parameters

Parameter Description
Connection Status (Optional) Select the connection status to filter the retrieved FortiGate integrations.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "host": "",
            "name": "",
            "port": "",
            "is_ssl": "",
            "verify_ssl": "",
            "policy_errors": [],
            "connection_status": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Security Insights

Input parameters

Parameter Description
Domain Specify the domain for which you want security insights to be retrieved.

Output

The output contains the following populated JSON schema:

{
    "authoritative": [
        {
            "comments": "",
            "info": "",
            "severity_on_fail": "",
            "status": "",
            "title": ""
        }
    ],
    "parent": [
        {
            "comments": "",
            "info": "",
            "severity_on_fail": "",
            "status": "",
            "title": ""
        }
    ],
    "soa": [
        {
            "comments": "",
            "info": "",
            "severity_on_fail": "",
            "status": "",
            "title": ""
        }
    ]
}

operation: Get Archived Issue Comments

Input parameters

Parameter Description
Issue ID Specify the ID of the issue whose comments are to be retrieved.
Comment Type (Optional) Select the comment type that is to be retrieved for the specified issue. You can choose from User or System
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "text": "",
            "user_name": "",
            "comment_type": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Issue Comments

Input parameters

Parameter Description
Issue ID Specify the ID of the issue whose comments are to be retrieved.
Comment Type (Optional) Select the comment type that is to be retrieved for the specified issue. You can choose from User or System
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "text": "",
            "user_name": "",
            "comment_type": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Tags

Input parameters

Parameter Description
Scope (Optional) Select the scope for which you want to retrieve the tags. You can choose from the following options:
  • System
  • Client
Name (Optional) Specify the name of tag to retrieve. Names are matched partially.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "id": "",
            "name": "",
            "scope": "",
            "description": "",
            "linked_assets_count": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Tag Details

Input parameters

Parameter Description
Tag ID Specify the ID of the tag that is to be retrieved.
Linked Asset (Optional) Select to retrieve linked assets. By default, it is unchecked and set to False.

Output

The output contains the following populated JSON schema:

Output schema when you choose Linked Asset as true:

{
    "id": "",
    "name": "",
    "scope": "",
    "description": "",
    "linked_assets_count": "",
    "created_ts": "",
    "modified_ts": ""
}

Output schema when you choose Linked Asset as false:

{
    "id": "",
    "name": "",
    "scope": "",
    "description": "",
    "linked_assets_count": "",
    "created_ts": "",
    "modified_ts": ""
}

operation: Get Groups

Input parameters

Parameter Description
Scope (Optional) Specify the scope for which you want to retrieve the groups. You can choose from System, Client
Group Name (Optional) Specify the name of the group that you want to retrieve. Names are matched partially.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "id": "",
            "name": "",
            "scope": "",
            "description": "",
            "linked_assets_count": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Group Details

Input parameters

Parameter Description
Group ID Specify the ID of the group that is to be retrieved.
Linked Asset (Optional) Select to retrieve linked assets. By default, it is unchecked and set to False.

Output

The output contains the following populated JSON schema:

Output schema when you choose Linked Asset as false:

{
    "id": "",
    "name": "",
    "scope": "",
    "description": "",
    "linked_assets_count": "",
    "created_ts": "",
    "modified_ts": ""
}

Output schema when you choose Linked Asset as true:

{
    "id": "",
    "name": "",
    "scope": "",
    "description": "",
    "linked_assets": [],
    "linked_assets_count": "",
    "created_ts": "",
    "modified_ts": ""
}

operation: Update Archived Asset

Input parameters

Parameter Description
Asset ID Specify the ID of the archived asset you want to update to Active.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Mark Archived Issue as Active

Input parameters

Parameter Description
Issue ID Specify the ID of the archived issue you want to update to Active.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update Issue Status

Input parameters

Parameter Description
Issue ID Specify the ID of the security issue you want to update.
Status Select the status to which you want to update the specified security issue. You can choose from the following options: ACTIVE, RESOLVED, FALSE_POSITIVE, or RISK_ACCEPTED.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update ASN Asset To False Positive

Input parameters

Parameter Description
Asset ID Specify the ID of the ASN asset you want to update to False Positive.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update IP Prefix Asset To False Positive

Input parameters

Parameter Description
Asset ID Specify the ID of the IP Prefix asset you want to update to False Positive.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update IP Asset To False Positive

Input parameters

Parameter Description
Asset ID Specify the ID of the IP asset you want to update to False Positive.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update Domain Asset To False Positive

Input parameters

Parameter Description
Asset ID Specify the ID of the domain asset you want to update to False Positive.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update Sub-Domain Asset To False Positive

Input parameters

Parameter Description
Asset ID Specify the ID of the subdomain asset you want to update to False Positive.
Note: This operation is not allowed on the same asset_id.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update Leaked Credential Status

Input parameters

Parameter Description
Leaked Credential ID Specify the ID of the leaked credential you want to update.
Status Select the status to which you want to update the specified leaked credential. You can choose either ACTIVE or RESOLVED.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

Included playbooks

The Sample - Fortinet FortiRecon EASM - 1.2.1 playbook collection comes bundled with the Fortinet FortiRecon EASM connector. These playbooks contain steps using which you can perform all supported actions. You can see bundled playbooks in the Automation > Playbooks section in FortiSOAR™ after importing the Fortinet FortiRecon EASM connector.

  • Generate Report
  • Get ASNs by Asset ID
  • Get Archived Assets
  • Get Archived Issue Comments
  • Get Archived Issues
  • Get Asset ASNs
  • Get Asset Statistics
  • Get Breaches
  • Get Breaches by ID
  • Get Cloud Integrations
  • Get Domain by Asset ID
  • Get Domains
  • Get Exposed Services
  • Get FortiGate Integrations
  • Get Group Details
  • Get Groups
  • Get IP by Asset ID
  • Get IPs
  • Get Issue By ID
  • Get Issue Comments
  • Get Issue Summary
  • Get Issues Discovered
  • Get Leaked Credentials
  • Get Prefixes
  • Get Prefixes by Asset ID
  • Get Report
  • Get Scan Statistics
  • Get Security Insights
  • Get Subdomain by Asset ID
  • Get Subdomains
  • Get Tag Details
  • Get Tags
  • Mark Archived Issue as Active
  • Update ASN Asset To False Positive
  • Update Archived Asset
  • Update Domain Asset To False Positive
  • Update IP Asset To False Positive
  • Update IP Prefix Asset To False Positive
  • Update Issue Status
  • Update Leaked Credential Status
  • Update Sub-Domain Asset To False Positive

Note: If you are planning to use any of the sample playbooks in your environment, ensure that you clone those playbooks and move them to a different collection since the sample playbook collection gets deleted during the connector upgrade and deletion.


Previous
Next

Fortinet FortiRecon EASM v1.2.1

About the connector

FortiRecon is a Digital Risk Protection Service (DRPS) product that provides an outside-the-network view of the risks posed to your enterprise.

This document provides information about the Fortinet FortiRecon EASM Connector, which facilitates automated interactions with a Fortinet FortiRecon EASM server using FortiSOARâ„¢ playbooks. Add the Fortinet FortiRecon EASM Connector as a step in FortiSOARâ„¢ playbooks and perform automated operations with Fortinet FortiRecon EASM.

Version information

Connector Version: 1.2.1

FortiSOARâ„¢ Version Tested on: 7.6.4-5623

Fortinet FortiRecon EASM Version Tested on: Version: v25.4.a

Authored By: Fortinet

Contributor: Ramkrushna Pathade

Certified: Yes

Release Notes for version 1.2.1

The following enhancements have been made to the Fortinet FortiRecon EASM Connector in version 1.2.1:

Installing the connector

Use the Content Hub to install the connector. For the detailed procedure to install a connector, click here.

You can also use the following yum command to install connectors from an SSH session:

sudo yum install cyops-connector-fortinet-fortirecon-easm

Prerequisites for configuring the connector

Minimum Permissions Required

Configuring the connector

For the procedure to configure a connector, click here.

Configuration parameters

In FortiSOAR™, on the Connectors page, click the Fortinet FortiRecon EASM connector row (if you are in the Grid view on the Connectors page) and in the Configurations tab, enter the required configuration details:

Parameter Description
Server URL Server name or IP address to which you will connect and perform the automated operations.
API Key API key to access the endpoint server to which you connect and perform the automated operations.
Organization ID The organization ID on which FortiRecon operations are to be performed.
Verify SSL Specifies whether the SSL certificate for the server is to be verified.
By default, this option is selected, i.e., set to True.

Actions supported by the connector

The following automated operations can be included in playbooks and you can also use the annotations to access operations:

Function Description Annotation and Category
Get Leaked Credentials Retrieves a list of leaked credentials related to the organization ID based on the keyword to search, breach ID, and date-time range you have specified. get_leaked_credentials
Investigation
Get Scan Statistics Retrieves statistics related to the EASM scan related to the organization ID specified in the configuration parameters. The response includes a count of the total, online, and newly discovered assets for the current and previous scans. get_scan_statistics
Investigation
Get Issues Discovered Retrieves a list of security issues related to assets discovered in the most recent EASM scan based on the filter criteria like issue status, severity, and the country codes (US, IN) you have specified. get_issues_discovered
Investigation
Get Issue By ID Retrieves details about a specific security issue based on the unique issue ID you have specified. get_issue_by_id
Investigation
Get Issue Summary Retrieves the statistics related to security issues discovered in the most recent EASM scan. The response includes a count of the total discovered issues, along with the severity-wise count. get_issue_summary
Investigation
Get Archived Issues Retrieves a list of security issues that have been marked as either Risk Accepted or False Positive based on the asset you have specified. get_archived_issues
Investigation
Get Archived Assets Retrieves a list of assets that have been marked as either Risk Accepted or False Positive. get_archived_assets
Investigation
Get Asset ASNs Retrieves a list of Autonomous System Numbers (ASNs) discovered in the latest EASM scan based on the asset you have specified. get_asset_asns
Investigation
Get ASNs by Asset ID Retrieves details about a specific Autonomous System Number(ASN) based on the asset ID you have specified. get_asns_by_asset_id
Investigation
Get Domains Retrieves a list of domains discovered in the latest EASM scan based on the filter criteria like ports, technologies, and assets you have specified. get_domains
Investigation
Get Domain by Asset ID Retrieves domain details based on the asset ID you have specified. get_domain_by_asset_id
Investigation
Get IPs Retrieves a list of IP addresses discovered in the latest EASM scan based on the filter criteria like ports, country codes, and assets you have specified. get_ips
Investigation
Get IP by Asset ID Retrieves IP address details based on the asset ID you have specified. get_ips_by_asset_id
Investigation
Get Prefixes Retrieves a list of IP prefixes discovered in the latest EASM scan based on the filter criteria, like ASN and assets you have specified. get_prefixes
Investigation
Get Prefixes by Asset ID Retrieves details about a specific IP prefix based on the asset ID you have specified. get_prefixes_by_asset_id
Investigation
Get Subdomains Retrieves a list of subdomains discovered in the latest EASM scan based on the filter criteria like ports, technologies, and assets you have specified. get_subdomains
Investigation
Get Subdomain by Asset ID Retrieves subdomain details based on the asset ID you have specified. get_subdomain_by_asset_id
Investigation
Get Asset Statistics Retrieves the statistics related to assets discovered in the most recent EASM scan. The response includes a count of the total discovered and online assets. get_asset_statistics
Investigation
Get Breaches Retrieves a list of credential breaches related to the organization ID based on the keyword to search and other details you have specified. get_breaches
Investigation
Get Breaches by ID Retrieves details about a specific credential breach based on the breach ID you have specified. get_breaches_by_id
Investigation
Generate Report Initiates the report generation for the latest EASM scan. generate_report
Investigation
Get Report Checks the status of the generated EASM report based on the report ID you have specified. The response contains the S3 URL of the report to download if generated. get_report
Investigation
Get Exposed Services Retrieves a list of exposed services in the latest EASM scan based on the filter criteria like asset, ports, services, and products etc. get_exposed_services
Investigation
Get Cloud Integrations Retrieves a list of cloud integrations based on the filter criteria like provider, connection_status. get_cloud_integrations
Investigation
Get FortiGate Integrations Retrieves a list of FortiGate integrations based on the input parameters specified. get_fgt_integrations
Investigation
Get Security Insights Retrieves the security insights on DNS configurations for the given domain. get_security_insights
Investigation
Get Archived Issue Comments Retrieves a list of comments for the given archived issue ID. get_archived_issue_comments
Investigation
Get Issue Comments Retrieves a list of comments for the given issue ID. get_issue_comments
Investigation
Get Tags Retrieves a list of tags based on scope, name, and other parameters specified. get_tags
Investigation
Get Tag Details Retrieves specific tag details based on the tag ID specified. get_tag_by_id
Investigation
Get Groups Retrieves a list of groups based on scope, name, and other parameters specified. get_groups
Investigation
Get Group Details Retrieves a specific group's details based on the group ID specified. get_group_by_id
Investigation
Update Archived Asset Updates a specific asset's status to Active based on the asset ID specified.
This action removes the specified asset from archived assets; however, its linked assets remain in the archive. The asset will be shown immediately in the profile settings seed section. However, the asset gets scanned again within 24 hours and will then be shown in active assets. If any issues are found during the scan, they are shown on the issues page.
update_archived_asset
Investigation
Mark Archived Issue as Active Updates the status of a specific archived security issue record to Active based on the issue ID specified. update_archived_issue
Investigation
Update Issue Status Updates the status of a specific security issue record based on the security issue ID specified.
If the specified issue status is updated to false_positive or risk_accepted, it will appear in the archived issues.
update_issue_status
Investigation
Update ASN Asset To False Positive Marks a specific ASN asset as a false positive based on the asset ID specified.
This action also marks the specified ASN asset's linked assets as false positives. Once marked, these assets will appear in the archived assets. All issues associated with the specified ASN asset will be removed.
update_asn_asset_status_to_false_positive
Investigation
Update IP Prefix Asset To False Positive Marks a specific IP Prefix asset as a false positive based on the asset ID specified.
This action also marks the specified IP Prefix asset's linked assets as false positives. Once marked, these assets will appear in the archived assets. All issues associated with the specified IP Prefix asset are also removed.
update_prefix_asset_status_to_false_positive
Investigation
Update IP Asset To False Positive Marks a specific IP asset as a false positive based on the asset ID specified.
This action also marks the specified IP asset's linked assets as false positives. Once marked, these assets will appear in the archived assets. All issues associated with the specified IP asset are also removed.
update_ip_asset_status_to_false_positive
Investigation
Update Domain Asset To False Positive Marks a specific domain asset as a false positive based on the asset ID specified.
This action also marks the specified domain asset's linked assets as false positives. Once marked, these assets will appear in the archived assets. All issues associated with the specified domain asset are also removed.
update_domain_asset_status_to_false_positive
Investigation
Update Sub-Domain Asset To False Positive Marks a specific subdomain asset as a false positive based on the asset ID specified.
This action also marks the specified subdomain asset's linked assets as false positives. Once marked, these assets will appear in the archived assets. All issues associated with the specified subdomain asset are also removed.
update_subdomain_asset_status_to_false_positive
Investigation
Update Leaked Credential Status Updates the status of a specific leaked credential record to Active or Resolved, based on the leaked credential ID specified. update_leaked_credential_status
Investigation

operation: Get Leaked Credentials

Input parameters

Parameter Description
Keyword (Optional) Specify the text to search in the email address and the breach name. Specified keywords are searched in these fields: email, breach name, and domain. For example, if you specify user@example.com, the response filters out results and fetches credentials exposed for user@example.com.
Breach ID (Optional) Specify the breach ID to filter the leaked credentials received.
Email ID (Optional) Specify the email ID to filter the leaked credentials retrieved.
Domain (Optional) Specify the domain to filter the leaked credentials retrieved.
Status (Optional) Specify the status to filter the leaked credentials retrieved.
Has Password (Optional) Specify whether to filter the leaked credential list based on whether the credentials contain passwords.
Show Plaintext Password (Optional) Select to show password in plaintext in the response.
Start Date (Optional) Specify the start date to filter the credential leak discovery date. The default is set as the last 6 months.
End Date (Optional) Specify the end date to filter the credential leak discovery date. The default is the current day's date.
Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "total": "",
    "page": "",
    "size": "",
    "hits": [
        {
            "email": "",
            "domain": "",
            "status": "",
            "added_on": "",
            "breach_id": "",
            "breach_date": "",
            "breach_name": "",
            "has_password": "",
            "plaintext_passwords": []
        }
    ]
}

operation: Get Scan Statistics

Input parameters

Parameter Description
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.

Output

The output contains the following populated JSON schema:

{
    "current_scan": {
        "assets": {
            "disappeared": {
                "asn": "",
                "domain": "",
                "ip_address": "",
                "ip_block": "",
                "sub_domain": ""
            },
            "live": "",
            "newly_discovered": {
                "asn": "",
                "domain": "",
                "ip_address": "",
                "ip_block": "",
                "sub_domain": ""
            },
            "total": ""
        },
        "completed_ts": ""
    },
    "previous_scan": {
        "assets": {
            "live": "",
            "total": ""
        },
        "completed_ts": ""
    }
}

operation: Get Issues Discovered

Input parameters

Parameter Description
Status (Optional) Select the status to filter the results. You can choose from the following options:
  • Active
  • Resolved
  • Risk Accepted
  • False Positive
Severity (Optional) Select the severity to filter the results. You can choose from the following options:
  • Critical
  • High
  • Medium
  • Low
NVD Severity (Optional) Select the NVD severity to filter the results. You can choose from the following options:
  • Critical
  • High
  • Medium
  • Low
Recon Severity (Optional) Select the Recon severity to filter the results. You can choose from the following options:
  • Critical
  • High
  • Medium
  • Low
Countries (Optional) Specify the country code to filter the discovered issues. Specify the countries as comma-separated values to get all those results that have any of the specified countries. For example: IN,US
Bucket ID (Optional) Specify the bucket IDs to filter the results. You can choose from the following options:
  • Exposed Remote Service
  • Vulnerable Software
  • Exposed Management Service
  • Certificate Issues
  • DNS Health (email)
  • DNS Health
  • Exposed Database Service
  • Reputation
  • Mis Configuration
  • Missing Encryption
  • Exposed Insecure Service
Issue Name Identifier (Optional) Specify the issue name identifiers to filter the results, as comma-separated values. For example: ip_blacklist,cve_2019_1234
Asset Type (Optional) Select the asset type to filter the discovered issues. You can choose from the following options:
  • IP Address
  • ASN Number
  • Domain Name
  • Sub Domain
  • IP Prefix
Asset (Optional) Specify the asset to filter the results. For example: test.example.com
Search Type (Optional) Specify the search type to filter the retrieved issues.

NOTE: Use the Asset parameter, along with this parameter, to search.

Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "issue_name": "",
            "asset": "",
            "asset_type": "",
            "country": "",
            "severity": "",
            "nvd_severity": "",
            "recon_severity": "",
            "port": "",
            "bucket": "",
            "status": "",
            "user_name": "",
            "issue_name_identifier": "",
            "bucket_id": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Issue By ID

Input parameters

Parameter Description
Issue ID Specify the issue ID to get details about that specific security issue.

Output

The output contains the following populated JSON schema:

{
    "total": "",
    "page": "",
    "size": "",
    "hits": [
        {
            "email": "",
            "domain": "",
            "status": "",
            "added_on": "",
            "breach_id": "",
            "breach_date": "",
            "breach_name": "",
            "has_password": "",
            "plaintext_passwords": []
        }
    ]
}

operation: Get Issue Summary

Input parameters

Parameter Description
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "asset": "",
            "asset_type": "",
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "issue_name": "",
            "port": "",
            "status": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "created_ts": "",
            "modified_ts": "",
            "user_name": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Archived Issues

Input parameters

Parameter Description
Status (Optional) Select the status to filter the retrieved archived issues. You can choose from the following options:
  • Risk Accepted
  • False Positive
Asset Type (Optional) Select the asset type to filter the retrieved archived issues. You can choose from the following options:
  • IP Address
  • ASN Number
  • Domain Name
  • Sub Domain
  • IP Prefix
Asset (Optional) Specify the asset to filter the retrieved archived issues. For example: asset.example.com
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "asset": "",
            "asset_type": "",
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "user_action": "",
            "user_name": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Archived Assets

Input parameters

Parameter Description
User Action (Optional) Select the user action based on which to filter the fetched archived assets. You can choose from the following options:
  • False Positive
  • Deleted
Asset Type (Optional) Select the asset type to filter the archived assets. You can choose from the following options:
  • IP Address
  • ASN Number
  • Domain Name
  • Sub Domain
  • IP Prefix
Asset (Optional) Specify the asset to filter the retrieved archived assets. For example: asset.example.com
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "asset": "",
            "asset_type": "",
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "user_action": "",
            "user_name": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Asset ASNs

Input parameters

Parameter Description
Search Type (Optional) Specify the search type to filter the results.

NOTE: Use the Asset parameter to search along with this parameter.

Asset (Optional) Specify the asset to filter the results. For example: AS0000.
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Discovered By FortiGate Integration (Optional) Select whether to fetch assets discovered via FortiGate integrations. You can choose from the following options:
  • True: Select this option to fetch assets discovered via FortiGate integrations.
  • False: Select this option to fetch assets not discovered via FortiGate integrations.
Cloud Metadata (Optional) Specify the cloud metadata in JSON format to filter the results. Available fields are: integration_id, cloud_provider, account_id, resource_id, resource_group, resource_name, resource_type, region, and subscription_id. For example:
  {
      "cloud_provider": [
        "azure"
      ],
      "region": [
        "westus2"
      ],
      "integration_id": [
        "777408f550e5rrdd1hjf3w90"
      ],
      "resource_name": [
        "TestAssetsPublic"
      ]
  }
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "asset": "",
            "assets_linked_count": "",
            "company_name": "",
            "fgt_metadata": {},
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "created_ts": "",
            "modified_ts": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ]
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get ASNs by Asset ID

Input parameters

Parameter Description
Asset ID Specify the asset ID to retrieve the ASN details.
Linked Assets (Optional) Select to retrieve linked assets. By default, it is unchecked and set to False.

Output

The output contains the following populated JSON schema:

Output schema when you choose Linked Assets as false:

{
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "asset": "",
    "assets_linked_count": "",
    "company_name": "",
    "fgt_metadata": {},
    "created_ts": "",
    "modified_ts": "",
    "discovery_path": [
        {
            "source": "",
            "module": "",
            "name": "",
            "target": "",
            "data_type": ""
        }
    ]
}

Output schema when you choose Linked Assets as true:

{
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "asset": "",
    "assets_linked_count": "",
    "company_name": "",
    "fgt_metadata": {},
    "discovery_path": [
        {
            "source": "",
            "module": "",
            "name": "",
            "target": "",
            "data_type": ""
        }
    ],
    "assets_linked": []
}

operation: Get Domains

Input parameters

Parameter Description
Ports (Optional) Specify the ports to filter retrieved domains. Specify the ports as comma-separated values to get only those results that have all of the specified ports. For example 8080,443
Technologies (Optional) Specify the ports to filter retrieved domains. Specify a comma-separated string or a single string. For example MySQL,Bootstrap
Asset (Optional) Specify the asset to filter retrieved domains.
Search Type (Optional) Specify the search type to filter retrieved domains.

NOTE: Use the Asset parameter to search along with this parameter.

Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Discovered By FortiGate Integration (Optional) Select whether to fetch domains discovered via FortiGate integrations. You can choose from the following options:
  • True: Select this option to fetch domains discovered via FortiGate integrations.
  • False: Select this option to fetch domains not discovered via FortiGate integrations.
Is Live (Optional) Select whether to fetch domains that are live. You can choose from the following options:
  • True: Select this option to fetch domains that are live.
  • False: Select this option to fetch domains that are not live, i.e., offline.
Discovered By Cloud Integration (Optional) Select whether to fetch domains discovered via Cloud integrations. You can choose from the following options:
  • True: Select this option to fetch domains discovered via Cloud integrations.
  • False: Select this option to fetch domains not discovered via Cloud integrations.
Cloud Metadata (Optional) Specify the cloud metadata in JSON format to filter the results. Available fields are: integration_id, cloud_provider, account_id, resource_id, resource_group, resource_name, resource_type, region, and subscription_id. For example:
  {
      "cloud_provider": [
          "azure"
      ],
      "region": [
          "westus2"
      ],
      "integration_id": [
          "777408f550e5rrdd1hjf3w90"
      ],
      "resource_name": [
          "TestAssetsPublic"
      ]
  }
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "asset": "",
            "assets_linked_count": "",
            "cloud_metadata": {
                "region": "",
                "resource_id": "",
                "resource_name": "",
                "resource_type": "",
                "cloud_provider": "",
                "resource_group": "",
                "customer_integration_name": ""
            },
            "confidence": "",
            "domain_expiry": "",
            "fgt_metadata": {
                "virtual_ip": [
                    {
                        "name": "",
                        "protocol": "",
                        "mapped_ip": "",
                        "mapped_ports": "",
                        "external_ports": "",
                        "mapped_device_mac": "",
                        "mapped_device_os_name": ""
                    }
                ],
                "interface_id": "",
                "integration_id": "",
                "interface_name": "",
                "integration_type": "",
                "customer_integration_name": ""
            },
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "ip_address": "",
            "nameserver": [],
            "original_ip": [],
            "ports": [],
            "ssl_cert_org": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "technologies": [],
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Domain by Asset ID

Input parameters

Parameter Description
Asset ID Specify the asset ID to retrieve its associated domain details.
Linked Assets (Optional) Select to retrieve linked assets. By default, it is unchecked and set to false.

Output

The output contains the following populated JSON schema:

Output schema when you choose Linked Assets as false:

{
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "asset": "",
    "ports": [],
    "ssl_cert_org": "",
    "ip_address": "",
    "technologies": [],
    "confidence": "",
    "domain_expiry": "",
    "nameserver": [],
    "original_ip": [],
    "cloud_metadata": {
        "region": "",
        "resource_id": "",
        "resource_name": "",
        "resource_type": "",
        "cloud_provider": "",
        "resource_group": "",
        "customer_integration_name": ""
    },
    "fgt_metadata": {
        "customer_integration_name": "",
        "integration_id": "",
        "integration_type": "",
        "interface_id": "",
        "interface_name": "",
        "virtual_ip": [
            {
                "external_ports": "",
                "mapped_device_mac": "",
                "mapped_device_os_name": "",
                "mapped_ip": "",
                "mapped_ports": "",
                "name": "",
                "protocol": ""
            }
        ]
    },
    "assets_linked_count": "",
    "issue_count": "",
    "created_ts": "",
    "modified_ts": "",
    "discovery_path": [
        {
            "source": "",
            "module": "",
            "name": "",
            "target": "",
            "data_type": ""
        }
    ]
}

Output schema when you choose Linked Assets as true:

{
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "asset": "",
    "ports": [],
    "ssl_cert_org": "",
    "ip_address": "",
    "technologies": [],
    "confidence": "",
    "domain_expiry": "",
    "nameserver": [],
    "original_ip": [],
    "cloud_metadata": {
        "region": "",
        "resource_id": "",
        "resource_name": "",
        "resource_type": "",
        "cloud_provider": "",
        "resource_group": "",
        "customer_integration_name": ""
    },
    "fgt_metadata": {
        "customer_integration_name": "",
        "integration_id": "",
        "integration_type": "",
        "interface_id": "",
        "interface_name": "",
        "virtual_ip": [
            {
                "external_ports": "",
                "mapped_device_mac": "",
                "mapped_device_os_name": "",
                "mapped_ip": "",
                "mapped_ports": "",
                "name": "",
                "protocol": ""
            }
        ]
    },
    "assets_linked_count": "",
    "issue_count": "",
    "discovery_path": [
        {
            "source": "",
            "module": "",
            "name": "",
            "target": "",
            "data_type": ""
        }
    ],
    "assets_linked": []
}

operation: Get IPs

Input parameters

Parameter Description
Ports (Optional) Specify the ports to filter the retrieved IP addresses. Specify the ports as comma-separated values to get only those results that have ALL of the specified ports. For example: 8080,443.
Countries (Optional) Specify the country code to filter the discovered issues. Specify the countries as comma-separated values to get all those results that have ANY of the specified countries. For example: IN,US
Asset (Optional) Specify the asset to filter the retrieved IP addresses.
Search Type (Optional) Select the search type to filter the retrieved IPs. You can choose from the following options:
  • Exact
  • Begins with
  • Ends with
  • Wildcard

NOTE: Use the Asset parameter to search along with this parameter.

IP Prefix (Optional) Specify an IP address prefix to filter the retrieved IP addresses.
Version (Optional) Select the IP version by which to retrieve records. You can choose from the following options:
  • 4: Select to retrieve IPv4 IP addresses.
  • 6: Select to retrieve IPv6 IP addresses.
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Discovered By FortiGate Integration (Optional) Select whether to fetch IP addresses discovered via FortiGate integrations. You can choose from the following options:
  • True: Select this option to fetch IP addresses discovered via FortiGate integrations.
  • False: Select this option to fetch IP addresses not discovered via FortiGate integrations.
Is Live (Optional) Select whether to fetch IP addresses that are live. You can choose from the following options:
  • True: Select this option to fetch IP addresses that are live.
  • False: Select this option to fetch IP addresses that are not live, i.e., offline.
Discovered By Cloud Integration (Optional) Select whether to fetch IP addresses discovered via Cloud integrations. You can choose from the following options:
  • True: Select this option to fetch IP addresses discovered via Cloud integrations.
  • False: Select this option to fetch IP addresses not discovered via Cloud integrations.
Cloud Metadata (Optional) Specify the cloud metadata in JSON format to filter the results. Available fields are: integration_id, cloud_provider, account_id, resource_id, resource_group, resource_name, resource_type, region, and subscription_id. For example:
  {
      "cloud_provider": [
          "azure"
      ],
      "region": [
          "westus2"
      ],
      "integration_id": [
          "777408f550e5rrdd1hjf3w90"
      ],
      "resource_name": [
          "TestAssetsPublic"
      ]
  }
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "total": "",
    "page": "",
    "size": "",
    "hits": [
        {
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "ip_prefix": "",
            "asset": "",
            "ports": [],
            "cloud_metadata": {},
            "fgt_metadata": {},
            "discovery_path": [],
            "assets_linked_count": "",
            "version": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ]
}

operation: Get IP by Asset ID

Input parameters

Parameter Description
Asset ID Specify the asset ID to retrieve the IP address details.
Linked Assets (Optional) Select to retrieve linked assets. By default, it is unchecked and set to False.

Output

The output contains the following populated JSON schema:

Output schema when you choose Linked Assets as false:

{
    "tags": [],
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "ip_prefix": "",
    "asset": "",
    "ports": [],
    "cloud_metadata": {},
    "fgt_metadata": {},
    "assets_linked_count": "",
    "version": "",
    "issue_count": "",
    "created_ts": "",
    "modified_ts": "",
    "discovery_path": [
        {
            "source": "",
            "module": "",
            "name": "",
            "target": "",
            "data_type": ""
        }
    ]
}

Output schema when you choose Linked Assets as true:

{
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "ip_prefix": "",
    "asset": "",
    "ports": [],
    "cloud_metadata": {},
    "fgt_metadata": {},
    "assets_linked_count": "",
    "version": "",
    "issue_count": "",
    "discovery_path": [
        {
            "source": "",
            "module": "",
            "name": "",
            "target": "",
            "data_type": ""
        }
    ],
    "assets_linked": []
}

operation: Get Prefixes

Input parameters

Parameter Description
Asset (Optional) Specify the asset to filter the retrieved IP address prefix. For example: 185.161.83.0/24.
Search Type (Optional) Specify the search type to filter the retrieved prefixes.

NOTE: Use the Asset parameter to search along with this parameter.

ASN (Optional) Specify the ASN to filter the retrieved IP address prefixes. For example: AS207180
Version (Optional) Select the IP version by which to filter retrieved records. You can choose from the following options:
  • 4: Select to retrieve IPv4 IP addresses.
  • 6: Select to retrieve IPv6 IP addresses.
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Discovered By FortiGate Integration (Optional) Select whether to fetch IP addresses discovered via FortiGate integrations. You can choose from the following options:
  • True: Select this option to fetch IP addresses discovered via FortiGate integrations.
  • False: Select this option to fetch IP addresses not discovered via FortiGate integrations.
Cloud Metadata (Optional) Specify the cloud metadata in JSON format to filter the results. Available fields are: integration_id, cloud_provider, account_id, resource_id, resource_group, resource_name, resource_type, region, and subscription_id. For example:
  {
      "cloud_provider": [
          "azure"
      ],
      "region": [
          "westus2"
      ],
      "integration_id": [
          "777408f550e5rrdd1hjf3w90"
      ],
      "resource_name": [
          "TestAssetsPublic"
      ]
  }
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "asn_number": "",
            "asset": "",
            "assets_linked_count": "",
            "company_name": "",
            "fgt_metadata": {},
            "discovery_path": [],
            "groups": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "id": "",
            "ip_count": "",
            "live_ip_count": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "version": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Prefixes by Asset ID

Input parameters

Parameter Description
Asset ID Specify the asset ID to retrieve the IP prefix details.
Linked Assets (Optional) Select to retrieve linked assets. By default, it is unchecked and set to false.

Output

The output contains the following populated JSON schema:

Output schema when you choose Linked Assets as false:

{
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "id": "",
    "asn_number": "",
    "asset": "",
    "company_name": "",
    "ip_count": "",
    "assets_linked_count": "",
    "version": "",
    "live_ip_count": "",
    "fgt_metadata": {},
    "discovery_path": [
        {
            "name": "",
            "module": "",
            "source": "",
            "target": "",
            "data_type": ""
        }
    ],
    "created_ts": "",
    "modified_ts": ""
}

Output schema when you choose Linked Assets as true:

{
    "id": "",
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "asset": "",
    "groups": [
        {
            "id": "",
            "name": ""
        }
    ],
    "version": "",
    "ip_count": "",
    "asn_number": "",
    "company_name": "",
    "fgt_metadata": {},
    "assets_linked": [],
    "live_ip_count": "",
    "discovery_path": [
        {
            "name": "",
            "module": "",
            "source": "",
            "target": "",
            "data_type": ""
        }
    ],
    "assets_linked_count": "",
    "created_ts": "",
    "modified_ts": ""
}

operation: Get Subdomains

Input parameters

Parameter Description
Ports (Optional) Specify the ports to filter the retrieved subdomains. Specify the ports as comma-separated values to get only those results that have ALL of the specified ports. For example: 8080,443.
Technologies (Optional) Specify the technology discovered on the subdomain to filter the retrieved subdomains. Specify a comma-separated string or a single string. For example MySQL,Bootstrap.
Domain (Optional) Specify a domain to filter the retrieved subdomains.
Asset (Optional) Specify the asset to filter the retrieved subdomains.
Search Type (Optional) Specify the search type to filter the retrieved subdomains.

NOTE: Use Asset parameter to search along with this parameter.

Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Discovered By FortiGate Integration (Optional) Select whether to fetch subdomains discovered via FortiGate integrations. You can choose from the following options:
  • True: Select this option to fetch subdomains discovered via FortiGate integrations.
  • False: Select this option to fetch subdomains not discovered via FortiGate integrations.
Is Live (Optional) Select whether to fetch subdomains that are live. You can choose from the following options:
  • True: Select this option to fetch subdomains that are live.
  • False: Select this option to fetch subdomains that are not live, i.e., offline.
Discovered By Cloud Integration (Optional) Select whether to fetch subdomains discovered via Cloud integrations. You can choose from the following options:
  • True: Select this option to fetch subdomains discovered via Cloud integrations.
  • False: Select this option to fetch subdomains not discovered via Cloud integrations.
Cloud Metadata (Optional) Specify the cloud metadata in JSON format to filter the results. Available fields are: integration_id, cloud_provider, account_id, resource_id, resource_group, resource_name, resource_type, region, and subscription_id. For example:
  {
      "cloud_provider": [
          "azure"
      ],
      "region": [
          "westus2"
      ],
      "integration_id": [
          "777408f550e5rrdd1hjf3w90"
      ],
      "resource_name": [
          "TestAssetsPublic"
      ]
  }
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "id": "",
            "tags": [
                {
                    "id": "",
                    "name": ""
                }
            ],
            "asset": "",
            "ports": [],
            "groups": [],
            "ip_address": "",
            "domain_name": "",
            "fgt_metadata": {},
            "technologies": [],
            "discovery_path": [],
            "cloud_metadata": {},
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Subdomain by Asset ID

Input parameters

Parameter Description
Asset ID Specify the asset ID to retrieve the subdomain details.

Output

The output contains the following populated JSON schema:

{
    "id": "",
    "tags": [
        {
            "id": "",
            "name": ""
        }
    ],
    "asset": "",
    "ports": [],
    "groups": [],
    "ip_address": "",
    "domain_name": "",
    "issue_count": "",
    "fgt_metadata": {},
    "technologies": [],
    "cloud_metadata": {},
    "discovery_path": [
        {
            "name": "",
            "module": "",
            "source": "",
            "target": "",
            "data_type": ""
        }
    ],
    "created_ts": "",
    "modified_ts": ""
}

operation: Get Asset Statistics

Input parameters

Parameter Description
Ports (Optional) Specify the ports to filter the asset statistics. Specify the ports as comma-separated values to get only those results that have ALL of the specified ports. For example: 8080,443.
Countries (Optional) Specify the country code to filter the discovered issues. Specify the countries as comma-separated values to get all those results that have ANY of the specified countries. For example: IN,US
Technologies (Optional) Specify the technologies to filter the asset statistics. Specify a comma-separated string or a single string. For example MySQL,Bootstrap.
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.
After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.

Output

The output contains the following populated JSON schema:

{
    "org_name": "",
    "asn_count": "",
    "ip_prefix_count": "",
    "live_domain_count": "",
    "total_domain_count": "",
    "billable_assets_count": "",
    "live_ip_address_count": "",
    "live_sub_domain_count": "",
    "total_ip_address_count": "",
    "total_sub_domain_count": ""
}

operation: Get Breaches

Input parameters

Parameter Description
Breach Name (Optional) Specify the breach name to retrieve specific breach details. For example: test-org. The response filters out results and fetches credentials exposed for test-org.
Keyword (Optional) Specify the text to search in the breach name, details, and list of compromised data. For example:test-org. The response filters out results and fetches credentials exposed for test-org.
Has Password (Optional) Select to filter the leaked credential list based on whether the credentials contain passwords.
Is Relevant (Optional) Select to filter the leaked credential list related to an organization.
Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "id": "",
            "date": "",
            "name": "",
            "details": "",
            "added_on": "",
            "has_password": "",
            "affected_domains": "",
            "compromised_data": "",
            "compromised_accounts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Breaches by ID

Input parameters

Parameter Description
Breach ID Specify the breach ID to retrieve the breach details.

Output

The output contains the following populated JSON schema:

{
    "id": "",
    "date": "",
    "name": "",
    "details": "",
    "added_on": "",
    "has_password": "",
    "compromised_data": "",
    "compromised_accounts": ""
}

operation: Generate Report

Input parameters

Parameter Description
Tags In (Match Any) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches any of the specified tags, operating as an OR filter.
Tags In (Match All) (Optional) Specify the tag ID to filter retrieved results. You can specify multiple tag IDs as comma-separated values. It returns results if it matches all of the specified tags, operating as an AND filter.
Groups In (Match Any) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches any of the specified groups, operating as an OR filter.
Groups In (Match All) (Optional) Specify the group ID to filter retrieved results. You can specify multiple group IDs as comma-separated values. It returns results if it matches all of the specified groups, operating as an AND filter.

Output

The output contains the following populated JSON schema:

{
    "report_id": ""
}

operation: Get Report

Input parameters

Parameter Description
Report ID Specify the report ID to retrieve the report details.
Get Report Link (Optional) Select the checkbox to get an S3 link to a report file. Clear the checkbox to retrieve file data. By default, this checkbox is cleared, i.e., set to false.

Output

The output contains the following populated JSON schema:

The output schema when you choose *Get Report Link* as `true`:

{
    "report_url": ""
}

The output schema when you choose *Get Report Link* as `false`:

{
    "asn": [],
    "domain": [
        {
            "tags": "",
            "asset": "",
            "groups": "",
            "ip_address": "",
            "open_ports": "",
            "technologies": "",
            "total_issues": "",
            "discovery_path": "",
            "subdomain_count": ""
        }
    ],
    "issues": [
        {
            "port": "",
            "tags": "",
            "asset": "",
            "groups": "",
            "severity": "",
            "issue_name": "",
            "issue_status": "",
            "linked_assets": "",
            "issue_category": "",
            "recommendations": "",
            "additional_details": ""
        }
    ],
    "ip_block": [],
    "ip_address": [
        {
            "tags": "",
            "asset": "",
            "groups": "",
            "country": "",
            "open_ports": "",
            "total_issues": "",
            "linked_assets": "",
            "discovery_path": ""
        }
    ],
    "sub_domain": [
        {
            "tags": "",
            "asset": "",
            "groups": "",
            "open_ports": "",
            "technologies": "",
            "total_issues": "",
            "linked_assets": "",
            "discovery_path": ""
        }
    ],
    "organization": [],
    "disappeared_assets": [
        {
            "asset": "",
            "asset_type": ""
        }
    ],
    "newly_discovered_assets": [
        {
            "asset": "",
            "asset_type": ""
        }
    ]
}

operation: Get Exposed Services

Input parameters

Parameter Description
Asset (Optional) Specify the asset to filter the retrieved exposed services.

NOTE: The only supported asset types are the IP address, domain, and subdomain.

Ports (Optional) Specify the ports to filter the retrieved exposed services. Specify the ports as comma-separated values to get only results with ALL the specified ports. For example: 8080,443.
Services (Optional) Specify the services to filter the retrieved exposed services. Specify the services as comma-separated values to get only those results that have ANY of the specified services. For example: http,https.
Products (Optional) Specify the products to filter the retrieved exposed services. Specify a comma-separated string or a single string. For example: nginx, Jetty.
Services Banner (Optional) Specify the keywords in the service banner to filter the retrieved exposed services.

NOTE: Do not use *; it is added implicitly.

After Primary Scan (Optional) Select whether to fetch results for items created before or after the primary scan. You can choose from the following options:
  • True: Select this option to fetch results for items created after the primary scan.
  • False: Select this option to fetch results for items created before the primary scan.
Has SSL (Optional) Select whether to fetch assets that have SSL. You can choose from the following options:
  • True: Select this option to fetch assets that have SSL.
  • False: Select this option to fetch assets that do not have SSL.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "cpe": [],
            "domains": [],
            "ip_address": "",
            "os": "",
            "port": "",
            "product": "",
            "service": "",
            "service_banner": "",
            "ssl": {},
            "subdomains": [],
            "version": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Cloud Integrations

Input parameters

Parameter Description
Provider (Optional) Specify the provider to filter the retrieved cloud integrations.
Connection Status (Optional) Select the connection status to filter the retrieved cloud integrations. You can choose from the following options:
  • Success
  • Failed
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "name": "",
            "provider": "",
            "account_id": "",
            "policy_errors": [],
            "connection_status": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get FortiGate Integrations

Input parameters

Parameter Description
Connection Status (Optional) Select the connection status to filter the retrieved FortiGate integrations.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "host": "",
            "name": "",
            "port": "",
            "is_ssl": "",
            "verify_ssl": "",
            "policy_errors": [],
            "connection_status": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Security Insights

Input parameters

Parameter Description
Domain Specify the domain for which you want security insights to be retrieved.

Output

The output contains the following populated JSON schema:

{
    "authoritative": [
        {
            "comments": "",
            "info": "",
            "severity_on_fail": "",
            "status": "",
            "title": ""
        }
    ],
    "parent": [
        {
            "comments": "",
            "info": "",
            "severity_on_fail": "",
            "status": "",
            "title": ""
        }
    ],
    "soa": [
        {
            "comments": "",
            "info": "",
            "severity_on_fail": "",
            "status": "",
            "title": ""
        }
    ]
}

operation: Get Archived Issue Comments

Input parameters

Parameter Description
Issue ID Specify the ID of the issue whose comments are to be retrieved.
Comment Type (Optional) Select the comment type that is to be retrieved for the specified issue. You can choose from User or System
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "text": "",
            "user_name": "",
            "comment_type": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Issue Comments

Input parameters

Parameter Description
Issue ID Specify the ID of the issue whose comments are to be retrieved.
Comment Type (Optional) Select the comment type that is to be retrieved for the specified issue. You can choose from User or System
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "text": "",
            "user_name": "",
            "comment_type": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Tags

Input parameters

Parameter Description
Scope (Optional) Select the scope for which you want to retrieve the tags. You can choose from the following options:
  • System
  • Client
Name (Optional) Specify the name of tag to retrieve. Names are matched partially.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "id": "",
            "name": "",
            "scope": "",
            "description": "",
            "linked_assets_count": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Tag Details

Input parameters

Parameter Description
Tag ID Specify the ID of the tag that is to be retrieved.
Linked Asset (Optional) Select to retrieve linked assets. By default, it is unchecked and set to False.

Output

The output contains the following populated JSON schema:

Output schema when you choose Linked Asset as true:

{
    "id": "",
    "name": "",
    "scope": "",
    "description": "",
    "linked_assets_count": "",
    "created_ts": "",
    "modified_ts": ""
}

Output schema when you choose Linked Asset as false:

{
    "id": "",
    "name": "",
    "scope": "",
    "description": "",
    "linked_assets_count": "",
    "created_ts": "",
    "modified_ts": ""
}

operation: Get Groups

Input parameters

Parameter Description
Scope (Optional) Specify the scope for which you want to retrieve the groups. You can choose from System, Client
Group Name (Optional) Specify the name of the group that you want to retrieve. Names are matched partially.
Created Time (Optional) Specify the time range to filter results based on the created time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Modified Time (Optional) Specify the time range to filter results based on the modified time. The following are the accepted formats:
  • YYYY-MM-DDTHH:MM:SS TO YYYY-MM-DDTHH:MM:SS
  • YYYY-MM-DD TO YYYY-MM-DD

For example: (2022-03-25T09:50:21.770+00:00 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25T14:24:05.000+00:00, 2022-03-25 to 2022-03-25)

Page (Optional) Specify the page number from which you want to retrieve records. By default, it is set to 1.
Size (Optional) Specify the maximum number of records that this operation should return for the specified page. By default, this operation retrieves 10 records. Minimum permissible value is 0 and the maximum is 500.

Output

The output contains the following populated JSON schema:

{
    "hits": [
        {
            "id": "",
            "name": "",
            "scope": "",
            "description": "",
            "linked_assets_count": "",
            "created_ts": "",
            "modified_ts": ""
        }
    ],
    "page": "",
    "size": "",
    "total": ""
}

operation: Get Group Details

Input parameters

Parameter Description
Group ID Specify the ID of the group that is to be retrieved.
Linked Asset (Optional) Select to retrieve linked assets. By default, it is unchecked and set to False.

Output

The output contains the following populated JSON schema:

Output schema when you choose Linked Asset as false:

{
    "id": "",
    "name": "",
    "scope": "",
    "description": "",
    "linked_assets_count": "",
    "created_ts": "",
    "modified_ts": ""
}

Output schema when you choose Linked Asset as true:

{
    "id": "",
    "name": "",
    "scope": "",
    "description": "",
    "linked_assets": [],
    "linked_assets_count": "",
    "created_ts": "",
    "modified_ts": ""
}

operation: Update Archived Asset

Input parameters

Parameter Description
Asset ID Specify the ID of the archived asset you want to update to Active.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Mark Archived Issue as Active

Input parameters

Parameter Description
Issue ID Specify the ID of the archived issue you want to update to Active.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update Issue Status

Input parameters

Parameter Description
Issue ID Specify the ID of the security issue you want to update.
Status Select the status to which you want to update the specified security issue. You can choose from the following options: ACTIVE, RESOLVED, FALSE_POSITIVE, or RISK_ACCEPTED.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update ASN Asset To False Positive

Input parameters

Parameter Description
Asset ID Specify the ID of the ASN asset you want to update to False Positive.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update IP Prefix Asset To False Positive

Input parameters

Parameter Description
Asset ID Specify the ID of the IP Prefix asset you want to update to False Positive.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update IP Asset To False Positive

Input parameters

Parameter Description
Asset ID Specify the ID of the IP asset you want to update to False Positive.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update Domain Asset To False Positive

Input parameters

Parameter Description
Asset ID Specify the ID of the domain asset you want to update to False Positive.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update Sub-Domain Asset To False Positive

Input parameters

Parameter Description
Asset ID Specify the ID of the subdomain asset you want to update to False Positive.
Note: This operation is not allowed on the same asset_id.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

operation: Update Leaked Credential Status

Input parameters

Parameter Description
Leaked Credential ID Specify the ID of the leaked credential you want to update.
Status Select the status to which you want to update the specified leaked credential. You can choose either ACTIVE or RESOLVED.

Output

The output contains the following populated JSON schema:

{
    "message": ""
}

Included playbooks

The Sample - Fortinet FortiRecon EASM - 1.2.1 playbook collection comes bundled with the Fortinet FortiRecon EASM connector. These playbooks contain steps using which you can perform all supported actions. You can see bundled playbooks in the Automation > Playbooks section in FortiSOAR™ after importing the Fortinet FortiRecon EASM connector.


Note: If you are planning to use any of the sample playbooks in your environment, ensure that you clone those playbooks and move them to a different collection since the sample playbook collection gets deleted during the connector upgrade and deletion.


Previous
Next