Cybereason offers an endpoint protection platform. It delivers antivirus software, endpoint detection and response with one agent, and a suite of managed services.
First, create a Cybereason resource in Tines
Login to your Tines tenant
Navigate to the team that will be using the API and click "Resource"
Click "+ New Resource"
Input the values for the Cybereason resource
Name: cybereason_username
Description: Optional
Builder: Your Cybereason username
Optional
Access: What other teams can also use the resource
Click "Save resource"
Lastly, create Cybereason credentials in Tines
You will need to create two credentials:
One Text type: "cybereason_password"
One HTTP request type: "cybereason_cookie"
Text type
Navigate to the team that will be using the API and click "Credential"
Click "+ New Credential" and select "Text"
Input the values for the Cybereason credential
Name: cybereason_password
Description: Optional
Value: Your Cybereason password
Optional
Domains: Ensure this credential can only be used when making HTTP requests to specific domains
Access: What other teams can also use the API
Click "Save"
HTTP request type
Click "+ New Credential" and select "HTTP Request"
Input the values for the Cybereason credential
Name: cybereason_ccokie
Description: Optional
URL:
https://integration.cybereason.net:8443/login.html
Content-Type:
"Custom": "application/x-www-form-urlencoded"
Method: post
Payload: Copy the below object and paste into the "Plain code" section:
{
"username": "<<RESOURCE.cybereason_username>>",
"password": "<<CREDENTIAL.cybereason_password>>"
}Disable redirect follow: Click the "+ Option" button, select choose "Disable redirect follow" and ensure the box remains ticked:
Click "Run options" and make sure you get a successful response like the following:
Location of token from response:
SPLIT(cybereason_cookie.headers["set-cookie"], ";") |> FIRST(%)
Optional
Domains: Ensure this credential can only be used when making HTTP requests to specific domains
Access: What other teams can also use the API
Click "Save"
Your credential should look like the following:
For more on creating credentials in Tines, click here.
You can find a selection of Cybereason stories in the story library.
Using the credential in an action
The Header configuration for your Cybereason credential should be:
"Cookie": "<<CREDENTIAL.cybereason_cookie>>"
Here is an example Cybereason action you can copy and paste onto your storyboard in Tines:
{"standardLibVersion":"35","actionRuntimeVersion":"4","agents":[{"disabled":false,"name":"Retrieve Cybereason Sensor Information","description":"Retrieve sensor infomration","options":"{\"url\":\"https://<<RESOURCE.cybereason_url>>/rest/sensors/query\",\"method\":\"post\",\"content_type\":\"json\",\"payload\":{\"limit\":1000,\"offset\":0,\"filters\":[]},\"headers\":{\"Cookie\":\"<<CREDENTIAL.cybereason_cookie>>\"}}","position":{"x":375,"y":1095},"type":"httpRequest","timeSavedUnit":"minutes","timeSavedValue":0,"monitorAllEvents":false,"monitorFailures":false,"monitorNoEventsEmitted":null,"recordType":null,"recordWriters":[],"form":null,"cardIconName":"httpRequest","createdFromTemplateGuid":"2dca49465829825a3f4f5ddaee6b1321c9667ffa07d713ab8186b60a9be3d607","createdFromTemplateVersion":1,"originStoryIdentifier":"cloud:aa47f8215c6f30a0dcdb2a36a9f4168e:d4c15df0f02ba4789095426607003199"}],"links":[],"diagramNotes":[]}