EasyVista
Integrate EasyVista to retrieve IT asset inventory
The EasyVista connector allows you to retrieve IT asset management data, ITSM tickets, and user information from your EasyVista platform directly into OverView.
Objective
The EasyVista connector retrieves the following information:
- IT asset inventory (hardware, workstations, servers, network equipment)
- Asset characteristics (IP address, MAC address, OS, RAM, disk, processor)
- Asset location and assigned user
Prerequisites
- EasyVista administrator access (to enable the Access Tokens module)
- Network connectivity from OverView to your EasyVista API endpoint
Information to provide in OverView
| Field | Description |
|---|---|
| Service URL | Base URL of your EasyVista API (e.g., https://api.easyvista.com) |
| Account | Account identifier, e.g. 50004 (production) |
| Bearer Token | Native EasyVista access token — recommended method |
| Client ID | OAuth 2.0 client ID — alternative to Bearer Token |
| Client Secret | OAuth 2.0 client secret |
| Auth Gateway URL | OAuth authorization server URL (e.g., https://login.microsoftonline.com) |
| Tenant ID | Azure AD tenant ID |
| Subscription Key | Azure API Management subscription key (optional) |
| API Version | API version to use |
Parameters
These parameters are optional. Leave them at their default value unless you have a specific reason to change them.
| Parameter | Description | Default |
|---|---|---|
| Excluded Categories | Assets whose category matches one of these values are not imported. Leave empty to import everything. A value matches at any depth of the catalog tree, so either a whole path (Matériels/IT/Videos/Ecrans) or a single level (Ecrans) works, case-insensitively. Available categories are listed in References > Catalogs > Equipment Catalog. | — |
Procedure
Generate a Bearer Token (Recommended)
The native EasyVista access token (Service Manager Access Token) is the recommended authentication method. It offers a higher level of security than Basic Auth and does not require an OAuth infrastructure.
Step 1 — Enable the Access Tokens module
Requires EasyVista administrator access.
- Go to Administration > Access Management > User Profiles.
- Select the user profile that will manage the token.
- Enable the menu entry Administration > Access Management > Access Tokens.
Step 2 — Generate the token
- Go to Administration > Access Management > Access Tokens.
- Click + New.
- Enter a name for the token and select the authorized user, then click Generate.
- The token value is automatically copied to your clipboard. Paste it immediately into a text editor — it will not be displayed again once the dialog is closed. The token remains valid until explicitly revoked.
Step 3 — Configure the connector in OverView
- In OverView, go to Data Sources Settings > Sources.
- Select EasyVista and click Configure.
- Fill in the URL and Bearer Token fields.
- Click Save Configuration.
Alternative: OAuth 2.0 Client Credentials
If your EasyVista instance is configured with Azure AD and OAuth 2.0 is available, contact OverSOC support to set up this authentication method. You will need to provide your OAuth Client ID, Client Secret, Auth Gateway URL, and Tenant ID.
Required Permissions
The token user must have read access to:
- Asset catalog (
/assetsendpoint) - Asset characteristics (
/asset-characteristicsendpoint)
Official Documentation
For additional information, refer to the EasyVista REST Web Service documentation.
Alternative: file import through DropPoint
The API access described above is the recommended method for this connector. Where it is not available (a segregated network, a version or licence without API, an export you already produce), OverView accepts file exports, to be uploaded to the bucket dedicated to EasyVista.
Bucket : s3://easyvista/
Example : s3://easyvista/export.csv
The procedure is described in the OverView DropPoint guide: generating credentials, configuring the client, then sending files from the OverView web interface, the AWS CLI or an SDK. Its examples come pre-filled with this bucket when you follow this link.