The CloudRadial AutomationAI SentinelOne extension lets a workflow or agent investigate and respond to endpoint threats in SentinelOne Singularity: inventory agents and installed software, triage threats and the activity log, and, with approval, isolate an endpoint, run a scan, mitigate threats, and set a threat's verdict or status. This article covers what the extension can do, the API token it needs, which tools require approval, and the skills that ship with it. It is for workspace users who build automations (Admin or Owner Role).
- What the Extension Covers
- Creating the API Token
- Providing the Credentials to Your Runner
- Reads and Approval-Gated Changes
- Skills
- Tips for Working With SentinelOne Data
What the Extension Covers
The extension calls the SentinelOne management API on your management console and provides 15 tools across these areas:
| Area | What you can automate |
| Agents and endpoints | List and read agents, isolate an endpoint from the network, reconnect it, and start an on-demand full disk scan |
| Threats | List and read threats, apply a mitigation action, set the analyst verdict, and set the incident status, for example to mark a threat resolved |
| Activity log | List activity-log entries such as agent state changes, threat events, and admin actions, by date range, agent, or activity type |
| Sites and groups | List sites and groups to scope other queries |
| Software and vulnerabilities | List installed applications across endpoints, with their risk level, and the application CVEs that Application Risk detects |
Install it from Extensions like any other catalog extension. It appears in the catalog as SentinelOne. See Browsing and installing extensions for the general install flow.
Creating the API Token
The extension signs in to SentinelOne with an API token. Generate one in your SentinelOne management console for the user the automations should act as:
- For your own user, go to My User > Options > Generate API Token
- For a service user, go to Settings > Users > Service Users
Scope the token to the least privilege your workflows need.
Providing the Credentials to Your Runner
Store two secrets in your runner's Key Vault with these exact names:
| Secret | Value |
SentinelOne-ApiUrl |
The full management API base URL for your console, including the /web/api/v2.1 path, for example https://usea1-partners.sentinelone.net/web/api/v2.1. Replace the host with your own console's host. |
SentinelOne-ApiToken |
The API token you generated |
Store the token on its own. SentinelOne expects the word ApiToken, not Bearer, in front of the token, and the extension adds it for you. For how to add secrets, see Accessing and updating your runner's Key Vault.
Reads and Approval-Gated Changes
Of the 15 tools, 9 are read-only and run without interruption. The other 6 act on endpoints or threats, and every one of them is approval-gated: the run pauses and the request appears as an Action Required item in the Inbox until someone approves it. See Handling Action Required items in the Inbox.
| Tool behavior | Tools |
| Approval-gated | Isolate an endpoint; reconnect an endpoint; start a full disk scan; mitigate threats; set the analyst verdict; set the incident status |
| Read-only | List and read agents and threats; list activities, sites, groups, installed applications, and application CVEs |
Each action targets the specific agents or threats named in the request. The extension always sends explicit ids, because a SentinelOne action with no ids applies to everything the token can see. Check the targets listed in the approval request before you approve it.
Isolating an endpoint disconnects it from the network while leaving the SentinelOne agent reachable, so you can still scan, mitigate, and reconnect it.
Skills
The extension ships four skills that guide an agent through common SentinelOne tasks:
| Skill | Use it to |
| Investigate Threats | Find threats, read a threat's detail, set an analyst verdict, or mark a threat resolved. Reads run freely; verdict, status, and mitigation steps are approval-gated. |
| Isolate or Contain an Endpoint | Contain a compromised endpoint: isolate it, run a scan, mitigate the threats on it, and reconnect it once it is clean. Every action step is approval-gated. |
| Inventory Agents and Software | Inventory endpoints, sites, and groups, or report installed applications and their CVEs. Read-only. |
| Review Activity Log | Audit agent state changes, threat events, or admin actions over a date range or for one endpoint. Read-only. |
To give an agent these skills, see Creating custom agents and using them in workflows.
Tips for Working With SentinelOne Data
- Refer to endpoints by computer name and let the agent look up the agent id. It resolves ids with the list tools before it isolates, scans, or mitigates.
- The mitigation actions are kill, quarantine, un-quarantine, remediate, and rollback remediation. Static threats support only kill and quarantine.
- The analyst verdict is one of true positive, false positive, suspicious, or undefined
- List tools return the complete result in one call. Filter by site, group, agent, or date range to keep large results focused.
- If every call fails, check that
SentinelOne-ApiUrluses your own console host and ends in/web/api/v2.1, and that the token is stored without a prefix
If you are still having trouble, we’re here to help! Submit a ticket here for assistance, and don’t forget to check our status page to ensure there are no outages in your area.
Comments
0 comments
Please sign in to leave a comment.