SentinelOne icon

SentinelOne

SentinelOne Management Console API specification.

Actions281

Agents → Start Remote Shell

AI-generated

Overview

This node operation allows users to start a Remote Shell session on SentinelOne Agents. Remote Shell provides a powerful way to remotely respond to events on endpoints by opening a full shell interface (PowerShell on Windows, Bash on macOS and Linux). It requires specific user permissions, two-factor authentication, and a Control SKU license. Users can specify filters such as UUID to target specific endpoints and must provide mandatory data parameters in the request body.

Use Case Examples

  1. Start a Remote Shell session on a specific SentinelOne Agent by providing the Agent's UUID and required authentication details.
  2. Use Remote Shell to execute commands remotely on endpoints for incident response or troubleshooting, ensuring the user has the necessary permissions and 2FA enabled.

Properties

Name Meaning
Options Additional request options including custom body, headers, query filters, batching, debug mode, pagination, and timeout settings.

Output

JSON

  • json
    • debug - Debug information including request details if debug mode is enabled

Dependencies

  • An API key credential for SentinelOne Management Console API

Troubleshooting

  • Ensure the user role has Remote Shell permissions and 2FA is enabled with a valid code.
  • Verify the Control SKU license is active for the account, site, or group.
  • Use the UUID filter to target specific endpoints to avoid permission issues.
  • Enable debug mode to get detailed request and response information for troubleshooting.

Links

Discussion