SentinelOne icon

SentinelOne

SentinelOne Management Console API specification.

Actions281

Threats → Connect Agents

AI-generated

Overview

This node operation reconnects agents that were previously disconnected from the network due to a threat. It is useful in scenarios where network isolation was applied to contain a threat, and now the agents need to be reconnected to the network after mitigation or analysis. For example, after resolving a security incident, an administrator can use this operation to restore network connectivity to affected endpoints.

Use Case Examples

  1. Reconnecting agents that were quarantined due to a detected threat to restore normal network operations.
  2. Automating the process of reconnecting multiple agents after a security event has been handled.

Properties

Name Meaning
Options Additional options for the API request such as custom body, headers, query filters, batching, debug mode, pagination, and timeout settings.

Output

JSON

  • json
    • debug - Debug information including the actual URL, query parameters, headers, and body sent for the API request, if debug mode is enabled.

Dependencies

  • An API key credential for SentinelOne API authentication.

Troubleshooting

  • Ensure the API credentials are correctly configured and have the necessary permissions to perform agent reconnection.
  • Check that the input data and parameters are correctly set, especially the filters used to identify agents to reconnect.
  • If the API returns errors related to rate limiting, adjust batching and interval options to reduce request frequency.
  • Enable debug mode to get detailed request and response information for troubleshooting.

Links

Discussion