SentinelOne API Configuration
To configure AlienApp for SentinelOne in USM Anywhere, you need to generate an API key in your SentinelOne instance and enter it into USM Anywhere.
To set up your SentinelOne API
- Log in to your SentinelOne management console.
- Go to Settings > Users.
- Click on the Admin user account (or user account with Incident Response [IR] Team Privileges) you want to use with USM Anywhere.
- Next to API Token, click Generate to create your API token.
Click Download to save the API token.
Save the API token where you can access it again easily when you configure the API in USM Anywhere.
Note: If you have previously enabled syslog collection for the SentinelOne Syslog AlienApp, you need to disable syslog collection when you connect the SentinelOne API to USM Anywhere to prevent duplicate logs.
In the SentinelOne management console, go to Settings > Integrations > Syslog and click Disable Syslog if it is currently enabled.
Configure AlienApp for SentinelOne in USM Anywhere
To enable the AlienApp for SentinelOne
- In USM Anywhere, go to Data Sources > AlienApps.
- Click the Available Apps tab.
- Search for the AlienApp, and then click the tile.
- Click Configure API.
If you have more than one deployed USM Anywhere Sensor, select the sensor that you want to use for the enabled AlienApp.
AlienApps operate through a deployed sensor and use APIs to integrate with the connected third-party technology. Select the sensor that can access the integration endpoint. The HTTPS connections to the API will originate from this sensor, so it is important to make sure the sensor has network access to the AlienApp API endpoints.
Enter the Management URL of your SentinelOne instance, your SentinelOne Username, and the API Token you created.
Use the checkboxes to enable the AlienApp for SentinelOne to create and merge assets:
- Check Allow Creation of New Assets to enable SentinelOne scans to create new assets in USM Anywhere.
- Check Allow Merging of Existing Assets to enable USM Anywhere to run a match against the SentinelOne identification to merge the assets found with existing USM Anywhere assets.
- Check Include Rogue Assets to enable USM Anywhere to collect and detect assets without an installed agent.
Important: If you want to create new assets, you need to select both options, Allow Creation of New Assets and Allow Merging of Existing Assets to prevent the duplication of assets. USM Anywhere won't create new assets if you only select one of the options.
See AlienApp for SentinelOne Asset Discovery and Management for more details on the asset creation and merging processes.
- Click Save.
AlienApp Log Collection
Once the AlienApp has been configured, you can choose to have USM Anywhere collect logs from the app on an regular basis.
To configure log collection for the AlienApp
- Go to Settings > Scheduler.
- In the Job Scheduler, search for the AlienApp on the sensor it was deployed to.
In the enabled column, click the icon for the inactive collection job.
The icon turns green and collection is enabled.
- (Optional.) Click the icon to customize the frequency of the event collection.
The AlienApp for SentinelOne and the
AlienApp for AT&T Managed Endpoint Security
Because both the AlienApp for SentinelOne and the
To ensure your API tokens remain up-to-date, the SentinelOne and AT&T Managed Endpoint Security Apps both include a scheduler job that automatically regenerates the API token. This job is not editable and runs automatically once the app is configured.
Note: Whether you are using the AlienApp for SentinelOne or the AlienApp for AT&T Managed Endpoint Security, this job will appear in your scheduled jobs as a SentinelOne job.
Important: This job will appear in your scheduled jobs as disabled until your SentinelOne app is fully configured.