SentinelOne icon

SentinelOne

SentinelOne Management Console API specification.

Actions281

Login → Auth by SSO

AI-generated

Overview

This node performs authentication of a user via Single Sign-On (SSO) using the SAML v2 protocol in the SentinelOne API. It is useful for scenarios where users need to authenticate securely through an SSO provider integrated with SentinelOne, such as Okta. The node sends a SSO authentication request to the SentinelOne API endpoint for a specified scope ID, enabling seamless login without requiring username and password input directly.

Use Case Examples

  1. Authenticate a user via SSO for a specific scope ID to obtain an authentication token for further API interactions.
  2. Use SSO authentication to integrate SentinelOne login with an enterprise identity provider supporting SAML v2.

Properties

Name Meaning
Scope Id The identifier of the scope (e.g., account or tenant) for which the SSO authentication is performed. This is required to specify the context of the login.
Options Additional optional settings such as custom request body, headers, query filters, batching, debug mode, pagination, and timeout settings to customize the API request behavior.

Output

JSON

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

Dependencies

  • An API key credential for authenticating with the SentinelOne API.

Troubleshooting

  • Ensure the provided Scope Id is correct and corresponds to a valid scope in SentinelOne.
  • Verify that the API key credential used has sufficient permissions to perform SSO authentication.
  • If debug mode is enabled, check the debug output for the exact request details to identify issues.
  • Handle API rate limits by configuring batching and intervals between batches if processing multiple input items.

Links

Discussion