| SamurAI [Local] Collector | SamurAI [Cloud] Collector |
|---|---|
 |
This integration collects detection data from ESET PROTECT Cloud using the ESET Connect REST API. The SamurAI platform authenticates with your ESET instance via a dedicated API user account and polls for events on a scheduled basis.
To complete this Integration you will need to:
1) Within ESET PROTECT Cloud:
2) From the SamurAI Portal:
Create a dedicated API user account
For additional information you can refer to the ESET Connect – Create API user account documentation.
To create a dedicated API user follow the steps below:
Log in as a Superuser (or Root) to your ESET Account
Navigate to User management and create a new user
Under Access rights apply Read to Company Access and ESET Protect & ESET Inspect access
Under the Access Rights section, enable the toggle next to Integrations
Click Create to apply the changes
The new user receives an invitation email — the user must complete the account creation process before the API can be used.
Identify your cloud region
ESET PROTECT Cloud is hosted across multiple regions. You must identify your region so the SamurAI platform connects to the correct API endpoints.
Your region can be identified from the URL of your ESET PROTECT Web Console. The prefix before the first dot (for example, eu01, us02) indicates your region.
Example are outlined below, you will need to specify it during Complete the ESET PROTECT Cloud Integration.
| Cloud Region | Console URL prefix | Authentication Base URL |
|---|---|---|
| Europe | eu02 | eu02.protect.eset.com |
| United States | us02 | us02.protect.eset.com |
| Canada | ca | ca01.protect.eset.com |
Complete the ESET PROTECT Cloud Integration
You will need:
- Username: (the dedicated API user created during Create a dedicated API user account)
- Password: (password of the dedicated API user created during Create a dedicated API user account)
- Location: (from Identify your cloud region)
Login to the SamurAI Portal
Click Telemetry and select Integrations from the main menu
Select Create
Locate and click ESET PROTECT Cloud
Click Next (we leverage a Samurai Cloud Collector)
Enter a Name of Integration
Enter a Description (Optional)
Select your Location from the drop down list
Enter your Username
Enter your Password
Click Finish
Our Integration guide was accurate at the time of writing but vendors change things frequently! If you find errors or anything is outdated, let us know by raising a request in the SamurAI MDR Portal and we shall get it updated.