With a configured connection between the AlienApp for Sophos Central on a deployed USM Anywhere Sensor and your Sophos Central environment, the predefined log collection jobs perform scheduled API queries for Sophos events or alerts. When USM Anywhere collects and analyzes the first of these, the normalized events are available on the Events page.
Configuration for the Sophos Central Connection
To enable AlienApp for Sophos Central functionality within USM Anywhere, you must configure the AlienApp by providing a valid Sophos Central API client ID and client secret. With a successful connection to your Sophos Central environment, the AlienApp for Sophos Central log collection jobs query the API every 20 minutes for events, alerts, or both. It parses all collected data and displays it as events and alarms in USM Anywhere.
Generate the Client ID and Client Secret
As a Sophos Central administrator, you must create the API client ID and secret to be used by the AlienApp for the connection to your Sophos Central data through the Sophos Central APIs. These API credentials are valid for one year. To maintain the USM Anywhere connection, you will need to renew these API credentials to extend their validity.
To generate API credentials for Sophos Central
- Log in to your Sophos Central environment and navigate to Global Settings > API Credentials Management.
- Click Add Credentials.
- Enter the required information to configure new credentials.
- Credential Name: Enter an identifiable credential name.
- (Optional.) Description: Enter a description of the credentials you are generating.
- Role: Use this dropdown to select the appropriate role for these credentials.
Click Addto generate your credentials.
You will be shown your newly generated client ID.
Click show Client Secret to view your client secret.
Warning: For security reasons, you will only be able to view your client secret one time. When you click show Client Secret, you must save the client secret for future use or you will have to generate new credentials.
Configure the AlienApp for Sophos Central Connection
After you create the API token in Sophos Central, you can configure the connection within USM Anywhere.
To enable the AlienApp for Sophos Central connection
- 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.
- Select Collect Sophos Central events or Collect Sophos Central alerts to limit the data collection from your Sophos Central environment.
- Click Save.
Verify the connection.
After USM Anywhere completes a successful connection to the Sophos Central APIs, a icon displays in the Health column.
If the icon displays, there is a problem with the connection. The Message column provides information about the issue. Repeat the steps to fix the configuration or troubleshoot your Sophos Central connection.
Enter the client ID and client secret you generated from your Sophos Central environment.
Use the drop-down to select the appropriate account type.