SentinelOne Response Integration via API

Purpose

This guide explains how to configure the SentinelOne response integration in Logsign so that analysts can trigger endpoint containment and eradication actions directly from an Incident or Alarm, without switching to the SentinelOne Management Console. Once configured, you can terminate a malicious process, quarantine or kill a detected threat, suspend a threat, or isolate an agent from the network, all from within Logsign.

This is a separate feature from the SentinelOne log collection poller. The poller pulls Threats, Device Control, and Deep Visibility events from SentinelOne into Logsign on a schedule. This integration does the opposite: it sends action requests out to SentinelOne on demand, typically from a playbook or a manual action attached to an Incident or Alarm. If you already configured the poller for log collection, you still need to configure this integration separately under Responses, since they use different configuration screens in Logsign even though both talk to the same SentinelOne console.

Prerequisites

You need a SentinelOne Management Console with API access and an API token generated for a Service User with permission to mitigate threats and act on agents. You also need your console's management URL (referred to below as the API domain), and Logsign 6.3.17 or later, matching the minimum version used by other Responses-module integrations; this specific minimum was not independently verified against Logsign release notes for this integration.

Use least privilege, not the Admin role. SentinelOne's built-in roles are Viewer, C-Level, IT, SOC, IR Team, and Admin, plus fully Custom roles on Singularity Complete and higher plans. Viewer is read-only and will not work here, since this integration performs write actions (threat mitigation and agent network isolation), not just data collection. Based on SentinelOne's public documentation and blog material on role-based access control, the built-in IR Team role is intended for incident response actions of this kind and is a reasonable choice if Custom roles are not available on your plan. If your plan includes Custom roles, build one scoped to threat mitigation and agent action permissions only, rather than granting Admin. The exact names of the granular Custom Role permissions for threat mitigation and agent actions are not published in SentinelOne's public documentation and were not independently verified against a live console; if you use a Custom role, review the permission list on the Custom Role creation screen in your own console (Settings > Users > Roles) before assigning it.

Step 1: Generate a least-privilege API token in SentinelOne

Log in to your SentinelOne Management Console and go to Settings, then select the Users tab, then Service Users. Service Users are API-only accounts, not tied to a person's console login, which makes them easier to trace and revoke independently of any individual's credentials.

  • Click Actions, then Create New Service User.
  • Enter a Name and Description that identify this token as belonging to the Logsign response integration, and set an Expiration Date. SentinelOne API tokens are time-limited; plan to rotate the token before it expires, since an expired token will stop every method below from working until it is replaced.
  • Click Next, then choose the Scope (Global, Account, or Site) that matches which part of your SentinelOne environment Logsign should be able to act on, and select the Account(s) or Site(s) accordingly.
  • For the Role, select IR Team, or a Custom role scoped to threat mitigation and agent actions if your plan supports Custom roles. Do not select Admin.
  • Click Create User. In the confirmation window, click Copy API Token to copy the token to your clipboard, or Download API Token to save a copy. SentinelOne shows this token only once; if you close the window without copying it, you will need to create a new Service User (or rotate the existing one) to get a new token.

While you are in the console, note your API domain. This is the hostname shown in your browser's address bar when you are logged into the SentinelOne console, for example usea1-partners.sentinelone.net. You will need this in Step 2.

Step 2: Configure the integration in Logsign

In Logsign, go to Settings > Integrations > Responses, search for SentinelOne, click Configure, then +Device to add a new configuration. Fill in the following fields:

FieldRequiredDescription
HostYesYour SentinelOne API domain only, for example usea1-partners.sentinelone.net. Do not include the https:// scheme and do not include any trailing slash or path. Logsign builds the request URL by prepending https:// and appending the API path itself; entering a value that already includes https:// or a path will produce a broken URL and every method will fail to connect.
Api TokenYesThe API token from Step 1, entered as a masked/password field. It is stored encrypted and sent by Logsign as the value of the HTTP Authorization header on every request.
Insecure Skip VerifyYesBoolean, defaults to on. When enabled, Logsign skips TLS certificate validation on the connection to your SentinelOne console. Since SentinelOne's cloud console normally presents a certificate from a public CA, there is usually no need to leave this on; turn it off after saving unless you have a specific reason (such as a TLS-inspecting proxy in front of the console) to keep it enabled.

Click Create to save. Once saved, this configuration becomes available as a Device inside Logsign's Incident and Alarm response actions, where you pick one of the methods below and supply its parameters (typically a threat ID or agent ID pulled from the alarm itself).

Available Methods

All five methods below take a single ID parameter and issue one POST request to SentinelOne per call. Each parameter field supports Logsign's mention-input format, meaning you can reference a value from the triggering alarm or incident instead of typing it manually. None of the methods currently support acting on more than one threat or agent per call, even though SentinelOne's own API supports batch operations on multiple IDs at once.

Terminate (terminate)

Kills the malicious process associated with the threat and removes the underlying malicious file from the endpoint. This is classified in Logsign as an Eradication action.

ParameterRequiredDescription
threat_idYesThe SentinelOne threat ID to act on.

Returns a result object with success (boolean), message (text from SentinelOne describing the outcome), and threatId (echoes the ID you supplied).

Quarantine (quarantine)

Moves the detected threat into SentinelOne's quarantine, isolating the malicious file without necessarily terminating an already-running process. Classified as a Containment action.

ParameterRequiredDescription
threat_idYesThe SentinelOne threat ID to act on.

Returns success, message, and threatId, same shape as Terminate.

Kill Threat (kill_threat)

Kills the active malicious process tied to the threat without the broader file removal that Terminate performs. Classified as an Eradication action.

ParameterRequiredDescription
threat_idYesThe SentinelOne threat ID to act on.

Returns success, message, and threatId.

Suspend Threat (suspend_threat)

Suspends the threat's activity on the endpoint. Classified as a Containment action.

ParameterRequiredDescription
threat_idYesThe SentinelOne threat ID to act on.

Returns success, message, and threatId.

Network Quarantine (network_quarantine)

Intended to isolate a SentinelOne agent from the network while leaving the SentinelOne agent itself able to communicate with the Management Console, so the endpoint can still be investigated and remediated remotely. Classified as a Containment action. Unlike the four methods above, this one acts on an agent, not a threat.

ParameterRequiredDescription
agent_idYesThe SentinelOne agent ID to isolate.

Returns a result object with success, message, and agentId instead of threatId.

Notes and Limits

  • This integration is a Response (Action) integration for on-demand threat and agent actions during Incident/Alarm handling. It does not collect or ingest SentinelOne data as a log source; that is handled by the separate SentinelOne API poller, which has its own configuration screen under Settings > Data Collection > API.
  • The built-in connection test (the check Logsign runs when you save or test the device) does not make any HTTP call to SentinelOne in the current implementation; based on a review of the integration's source code, it returns immediately without contacting your console. A test that appears to succeed does not confirm that the Host or Api Token are actually correct. Verify a new configuration by running one of the five methods above against a real threat or agent ID and checking the result, rather than relying on the test alone.
  • Each method call acts on exactly one threat ID or agent ID. If you need to act on multiple threats or agents from a single alarm, you currently need to invoke the method once per ID.
  • The Insecure Skip Verify option defaults to on. Review and disable it after configuration unless you specifically need it for a TLS-inspecting proxy in front of your SentinelOne console.
  • The Host field only accepts your bare API domain. Do not include https://, a port, or any path, since Logsign constructs the full request URL from this value automatically. See Step 2 and the Troubleshooting table below.
  • Based on a review of the integration's source code, action calls may currently return an unexpected or internal-looking error even when the Host and Api Token are both correct and the threat or agent ID is valid. This was not confirmed with a live test against a SentinelOne tenant, so it should not be assumed to affect every environment, but if you see this behavior consistently across different threat and agent IDs, it is worth opening a ticket with Logsign support and referencing this note rather than continuing to re-check your own configuration.

Troubleshooting

SymptomLikely causeWhat to check
401 UnauthorizedThe Api Token is missing, invalid, expired, or was copied incompletely. SentinelOne's official API documentation specifies a token authorization format distinct from generic bearer-token schemes; if your token and Host both look correct and you still get a 401 on every call, this may point to a header format mismatch on Logsign's side rather than a problem with your token.Re-copy the Api Token from SentinelOne (Service Users list, or generate a new one if the original was not saved), confirm it has not expired, and re-save the Device configuration in Logsign. If the token is confirmed valid and current but every call still returns 401, contact Logsign support with this detail.
403 ForbiddenThe Service User's role does not include permission to mitigate threats or act on agents, for example if it was created with the Viewer role.Confirm the Service User was created with the IR Team role or a Custom role that includes threat mitigation and agent action permissions, not Viewer. See Step 1.
404 Not Found, specifically on Network QuarantineNot documented by SentinelOne as a possible response for this specific integration method, and not independently verified with a live test. Based on a review of the integration's source code, the Network Quarantine method may be calling a different API path than the one SentinelOne's public documentation describes for isolating an agent from the network.If Network Quarantine consistently fails while the threat-based methods (Terminate, Quarantine, Kill Threat, Suspend Threat) work correctly with the same Device configuration, this points to the method itself rather than your Host or Api Token. Report this to Logsign support rather than re-checking your SentinelOne role or credentials.
429 Too Many RequestsYour SentinelOne API rate limit has been exceeded.Reduce how frequently the integration's methods are triggered, for example by avoiding playbooks that call the same method in a tight loop. SentinelOne's exact rate limit for your plan is not published with a specific number and was not independently verified during this research.
Action reports success but nothing changes in the SentinelOne consoleThe threat_id or agent_id supplied did not match an existing object in the scope (Site/Account) your Service User has access to.Confirm the ID was copied correctly and that it belongs to a Site or Account within your Service User's configured Scope from Step 1.
Connection failure or timeoutThe Host field contains a malformed value (for example with https:// already included, or a trailing path), or outbound HTTPS access from Logsign to your SentinelOne console is blocked.Confirm the Host field contains only the bare API domain as described in Step 2, and that the Logsign server can reach that domain on port 443.
TLS/certificate handshake errorInsecure Skip Verify is turned off and Logsign does not trust the certificate your SentinelOne console presents, for example behind a TLS-inspecting proxy.Turn Insecure Skip Verify back on if a proxy is intercepting the connection, or confirm your SentinelOne console presents a certificate chain Logsign's server already trusts.
Was this article helpful?
0 out of 0 found this helpful

Articles in this section

See more
Become a Certified Logsign User/Administrator
Sign-up for Logsign Academy and take the courses to learn about Logsign USO Platform in detail. Enjoy the courses, and get your badges and certificates. In these courses, you'll learn how to use Logsign in your work and add value to your career.
Visit Our Blog
Our Logsign USO Platform illustrate our expertise. So do the blog. Through our blog posts, deepen your knowledge on various SecOps topics or get updated about important news & modern approaches for cybersecurity. Get into the habit of reading valuable information provided by Logsign. Be a step ahead.