Skip to main content

Cyware Orchestrate

Panorays

App Vendor: Panorays

Connector Category: Third-Party Risk Assessment

Connector Version : 1.0.2

API Version: 1.0.0

About App

Panorays is dedicated to eliminating third-party security risks so that organizations can quickly and securely do business together. Security teams can automate, accelerate and scale customers' vendor security evaluation and risk management processes.

The Panorays app allows security teams to integrate with the Panorays enterprise application and help automate the entire security lifecycle management.

The Panorays app is configured with the Orchestrate application to perform the following actions:

Action Name

Description

Send an inquiry

This action sends an inquiry to a particular supplier.

Get supplier tests

This action retrieves tests of a particular supplier.

Get tests

This action retrieves all the tests from the user's portfolio.

Get supplier assets

This action retrieves the assets of a particular supplier.

Get the assets

This action retrieves all the assets from the user's portfolio.

Get supplier posture

This action retrieves the posture of a particular supplier.

Get posture

This action retrieves the portfolio posture.

Get supplier single finding

This action retrieves supplier details of a finding.

Get supplier findings

This action retrieves all the findings from a particular supplier.

Get single finding

The action retrieves details of a finding.

Get all findings

This action retrieves all the findings from your own portfolio.

Get business information template

This action retrieves all business information templates from their portfolio.

Update supplier

This action updates the data of a supplier.

Add new supplier

This action adds a new supplier to the portfolio.

Get supplier data

This action retrieves a list of all suppliers and their respective data.

Get Files

This action retrieves files that are related to the company or its suppliers.

Configuration parameters

The following configuration parameters are required for the Panorays app to communicate with the Panorays enterprise application. The parameters can be configured by creating instances in the app.

Parameter

Description

Field Type

Required / Optional

Comments

API Key

Enter the Panorays API Key.

Example:

402xx0824ff93xxxxx4ff9345d7xxx02

Password

Required

Action: Send an inquiry

This action sends an inquiry message to a particular supplier.

Input parameters

Parameter

Description

Field Type

Required / Optional

Comments

Supplier ID

Enter the supplier ID.

Example:

"58axxxx30d7145e5xxbfb36"

Text

Required

Inquiry

Enter the array of POC emails from the connection to send.

Example:

"Sample Inquiry Message"

Text

Required

Example Request
[
  {
    "supplier_id": "58axxxx30d7145e5xxbf",
    "inquiry_message": "Sample Inquiry Message"
  }
]
Action: Get supplier tests

This action retrieves tests of a particular supplier.

Input parameters

Parameter

Description

Field Type

Required / Optional

Comments

Supplier ID

Enter the supplier ID.

Example:

"58axxxx30d7145e5xxbf"

Text

Required

Example Request
[
  {
    "supplier_id": "58axxxx30d7145e5xxbf"
  }
]
Action: Get supplier assets

This action retrieves the assets of a particular supplier.

Input parameters

Parameter

Description

Field Type

Required / Optional

Comments

Supplier ID

Enter the supplier ID.

Example:

"58axxxx30d7145e5xxbf"

Text

Required

Example Request
[
  {
    "supplier_id": "exampleSupplierID"
  }
]
Action: Get the assets

This action retrieves all the assets from the user's portfolio.

Input parameters

No input parameters are required for this action.

Action: Get supplier posture

This action retrieves the posture of a particular supplier.

Input parameters

Parameter

Description

Field Type

Required / Optional

Comments

Supplier ID

Enter the supplier ID.

Example:

"58axxxx30d7145e5xxbf"

Text

Required

Example Request
[
  {
    "supplier_id": "58axxxx30d7145e5xxbf"
  }
]
Action: Get posture

This action retrieves the portfolio posture.

Input parameters

No input parameters are required for this action.

Action: Get supplier single finding

This action retrieves single finding information from a particular supplier.

Input parameters

Parameter

Description

Field Type

Required / Optional

Comments

Supplier ID

Enter the supplier ID.

Example:

"58axxxx30d7145e5xxbf"

Text

Required

Finding ID

Enter the finding ID to retrieve the data.

Example:

"58axxxx30d7145e5xxbf"

Text

Required

Example Request
[
  {
    "supplier_id": "58axxxx30d7145e5xxbf",
    "finding_id": "76axxxx30d1234e5xxbf"
  }
]
Action: Get supplier findings

This action retrieves all the findings from a particular supplier.

Input parameters

Parameter

Description

Field Type

Required / Optional

Comments

Supplier ID

Enter the supplier ID.

Example:

"58axxxx30d7145e5xxbf"

Text

Required

Extra parameters

Enter the extra parameters to filter results in the form of key-value pairs.

Key-Value

Optional

You can also pass additional parameters such as limit, severity, status, asset_name,sub_category, skip, and many more.

Example Request
[
  {
    "supplier_id": "58axxxx30d7145e5xxbf",
    "extra_params":
            {
                "severity": "Low",
            }
  }
]
Action: Get a single finding

The action retrieves details of a finding.

Input parameters

Parameter

Description

Field Type

Required / Optional

Comments

Finding ID

Enter the finding ID to retrieve the data.

Example:

"58axxxx30d7145e5xxbf"

Text

Required

Example Request
[
  {
    "finding_id": "55axxxx30d5574e5xxbf",
  }
]
Action: Get all findings

This action retrieves all the findings from your own portfolio or self-assessment.

Input parameters

Parameter

Description

Field Type

Required / Optional

Comments

Extra parameters

Enter the extra parameters to filter results in the form of key-value pairs.

Key-Value

Optional

You can also pass additional parameters such as limit, severity, status, asset_name, sub_category, skip, and many more.

Action: Get business information template

This action retrieves all business information templates from their portfolio.

Input parameters

No input parameters are required for this action.

Action: Update supplier

This action updates the data of a supplier.

Input parameters

Parameter

Description

Field Type

Required / Optional

Comments

Supplier ID

Enter the supplier ID.

Example:

"58axxxx30d7145e5xxbf"

Text

Required

Assets

Enter an array of assets associated with the supplier.

Example:

outlook.com

Text

Required

Example Request
[
    {
        "assets": "outlook.com",
        "supplier_id": "5d9079e4afa3xxxcc571"
    }
]
Action: Add new supplier

This action adds a new supplier to the portfolio.

Input parameters

Parameter

Description

Field Type

Required / Optional

Comments

Asset name

Enter the asset name of the supplier company.

Example:

“ExampleAsset”

Text

Required

Supplier name

Enter the name of the supplier.

Example:

“SampleSupplier”

Text

Required

Tags

Enter an array of tags to be added.

Example:

"exampleTag"

Any

Optional

Business impact

Enter the business impact, ranging from 1 - 5. The lowest impact value is 1 and the highest is 5.

Example:

"2"

Integer

Optional

By default, the impact score is 1.

Example Request
[
  {
    "asset": "ExampleAsset",
    "name": "SampleSupplier",
    "business_impact": 2
  }
]
Action: Get supplier data

This action retrieves a list of all suppliers and their respective data.

Input parameters

No input parameters are required for this action.

Action: Get Files

This action retrieves files that are related to the company or its suppliers.

Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

File ID

Specify the File ID to the details of the File.

Example:

"Example File ID"

Text

Required

Example Request
[
  {
    "file_id": "Example File ID",
  }
]