Cohesity
Cohesity is a data management platform that consolidates and manages data across various environments, enhancing data protection and accessibility.
Cohesity is a leading data management platform that simplifies data protection and management across hybrid and multi-cloud environments. The Cohesity connector for Swimlane Turbine enables users to seamlessly integrate Cohesity's robust data protection capabilities into their security automation workflows. By leveraging this integration, users can efficiently retrieve protection summaries and node lists from Cohesity clusters, enhancing their ability to monitor and manage data protection activities. This integration empowers security teams to automate data protection tasks, ensuring comprehensive coverage and streamlined operations within the Swimlane Turbine platform.
The Connector integrates Cohesity's REST API with Swimlane turbine.
Prerequisites
Before you can use the Cohesity connector for Turbine, you'll need access to the Cohesity API. This requires the following:
- an API key authentication using the following parameters:
- URL: The endpoint URL for accessing the Cohesity API.
- API Key: A unique key provided by Cohesity to authenticate API requests.
Capabilities
This Connector provides the following capabilities:
- Get Protection Summary
- List Nodes
Notes
Additional Documentation
Configurations
Cohesity API Key Authentication
Authenticates using an API Key
Configuration Parameters
Parameter | Description | Type | Required |
|---|---|---|---|
url | A URL to the target host. | string | Required |
apiKey | API key | string | Required |
verify_ssl | Verify SSL certificate | boolean | Optional |
http_proxy | A proxy to route requests through. | string | Optional |
Actions
Get Protection Summary
Compute and retrieve the protection summary of clusters in Cohesity.
Endpoint
- URL: /irisservices/api/v1/public/mcm/stats/protectionSummary
- Method: GET
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
numObjectsProtected | number | Output field: numObjectsProtected |
numObjectsUnprotected | number | Output field: numObjectsUnprotected |
statsByEnv | array | Output field: statsByEnv |
statsByEnv.file_name | string | Name of the resource |
statsByEnv.file | string | Output field: statsByEnv.file |
protectedSizeBytes | number | Output field: protectedSizeBytes |
unprotectedSizeBytes | number | Output field: unprotectedSizeBytes |
Output Example
{"status_code":200,"response_headers":{"Date":"Mon, 05 Feb 2024 09:24:20 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"close","x-frame-options":"SAMEORIGIN","x-prisma-event-id":"91244f24-846b-f0fa-9e3c-f079bb160e5f","content-encoding":"gzip","vary":"Accept-Encoding","content-security-policy":"frame-ancestors 'self';","x-xss-protection":"1; mode=block","x-content-type-options":"nosniff","referrer-policy":"strict-origin-when-cross-origin","x-download-options":"...
List Nodes
Retrieve a list of nodes within the Cohesity cluster.
Endpoint
- URL: /irisservices/api/v1/public/nodes
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
headers | object | Optional | HTTP headers for the request |
headers.accessClusterId | string | Optional | HTTP headers for the request |
Input Example
{"headers":{"accessClusterId":"askd2234"}}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Date":"Mon, 05 Feb 2024 09:23:55 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"close","x-frame-options":"SAMEORIGIN","x-prisma-event-id":"580f3388-f1bb-d6bd-15e8-b8ddcf7dba55","content-encoding":"gzip","vary":"Accept-Encoding","content-security-policy":"frame-ancestors 'self';","x-xss-protection":"1; mode=block","x-content-type-options":"nosniff","referrer-policy":"strict-origin-when-cross-origin","x-download-options":"...
Response Headers
Header | Description | Example |
|---|---|---|
Connection | HTTP response header: Connection | close |
content-encoding | HTTP response header: content-encoding | gzip |
content-security-policy | HTTP response header: content-security-policy | frame-ancestors 'self'; |
Content-Type | The media type of the resource | application/json |
Date | The date and time at which the message was originated | Mon, 05 Feb 2024 09:24:20 GMT |
feature-policy | HTTP response header: feature-policy | camera 'none';microphone 'none';geolocation 'none';encrypted-media 'none';payment 'none';usb 'none'; |
referrer-policy | HTTP response header: referrer-policy | strict-origin-when-cross-origin |
strict-transport-security | HTTP response header: strict-transport-security | max-age=31536000; includeSubDomains |
Transfer-Encoding | HTTP response header: Transfer-Encoding | chunked |
vary | HTTP response header: vary | Accept-Encoding |
x-content-type-options | HTTP response header: x-content-type-options | nosniff |
x-dns-prefetch-control | HTTP response header: x-dns-prefetch-control | off |
x-download-options | HTTP response header: x-download-options | noopen |
x-frame-options | HTTP response header: x-frame-options | SAMEORIGIN |
x-prisma-event-id | HTTP response header: x-prisma-event-id | 580f3388-f1bb-d6bd-15e8-b8ddcf7dba55 |
x-xss-protection | HTTP response header: x-xss-protection | 1; mode=block |