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", } ]