Professional Documents
Culture Documents
I. Introduction to InvGate Insight 5
II. Requirements 7
Web Application Use 7
Cloud Instances 8
Proxy 8
Proxy Installation 8
2
3
4
● Proxy (required for cloud instances): It forwards the agent reports received on a
local network to the central server, and allows for communication from the central
server to the agents if they are in a private network. It also executes asset
discovery tasks.
5
The following diagram shows how these components interact with each other:
6
II. Requirements
The installation of InvGate Insight comprises three parts:
● Agent deployment
The following diagram illustrates the relationship between these three parts:
The technical and functional requirements necessary to use the product are detailed
below.
7
Cloud Instances
Proxy
The purpose of the proxy is to enable a means of communication between the agents that
will be installed on the computers and the server where the application will be installed, in
case communication between them is not possible due to privacy policies or internet
access.
2. Agent Reporting: If the installed agents do not have visibility of the application
server, the installation of a proxy will be required. Otherwise, they will not be able
to report to InvGate Insight.
Similarly, the proxy performs the network analysis task to collect data from the devices
connected to it and thus be able to add them to the inventory.
Proxy Installation
The InvGate Insight architecture allows you to install as many proxies as necessary. To do
so, follow the instructions: Proxy Installation.
● Windows XP or higher
● Windows Server 2003 or higher
● macOS 10.6 (Snow Leopard) or higher
● Ubuntu 12.04 or higher
● CentOS / RHEL 7 or higher
● Debian 6 or higher
8
InvGate Insight has four methods of distribution and installation of agents, which are
described below.
For the manual and remote procedures, instructions are within the Product, in
Settings > Agent Deployment.
9
IV. Settings
The "Settings" section of the left vertical menu allows you to perform a variety of tasks:
set system preferences, add assets, manage users, labels, health rules, locations, and
status, in addition to distributing the agent and enabling integrations.
1. General
A. Preferences
To set the system preferences, go to “Settings” > “General” > “Preferences” and enter the
following information:
1. Company name.
2. Size limit of files that can be uploaded to entity profiles.
3. Reporting frequency (only configured by Superadmin users).
4. Task frequency of installed agents (only configured by Superadmin users).
10
5. Number of failed reports admitted from an agent to consider an asset as
disconnected (only configured by Superadmin users).
6. Geolocation (only available for Windows 10 computers).
7. This option defines the unification criteria for agents if duplicate reports are
created.
B. Locations
Location is a property that can be assigned to a user or asset. A location profile will list all
the assets, users, and program facilities assigned to it.
Locations can be nested to organize a structure; for example, within the “United States”
location, there can be another one called “San Francisco”.
Creating locations
Go to “Settings” > “General” > “Locations” and click on “Add location”. The following data
must be completed:
11
1. Edit.
2. Delete.
i. Introduction
Tags are a classification and characterization tool for active users/owners, programs, and
program versions. They are also used as parameters to search for assets or software.
Upon assigning a tag to any of the previously mentioned entities, it will be visible both in
its profile and in its view within the Explorer.
Tags can be converted into smart tags, an additional feature exclusive to assets. Smart
tags automate the assignment of tags, allowing filters to be configured in the Asset
Explorer so that any asset that meets the conditions is assigned a certain smart tag.
12
B. Create
C. Edit
D. Delete tags
By clicking on the “+” sign, the tag creation screen will open, where you can:
1. Enter name and choose an identifying color
3. Create tag
13
The second way to create tags is from the Settings menu. To do this:
1. Go to “Settings” > “General” > “Tags” and click on “New tag”.
14
2. Enter a name and choose a color for the tag. Optionally, a description can be
added.
3. Click on “Create”:
15
1. Locate the box where the tags associated with that profile are located.
2. Click on the “add tags” icon in the upper right of the tag box.
16
3. Choose, within the drop-down list, the tags you want to assign.
4. Click on "Apply".
2. Click on the “Edit” icon for the tag or smart tag that you want to modify:
17
Similarly, editing can be executed from "Settings" > "General" > "Tags".
18
2. Click on the tag or smart tag icon that you want to delete:
vii. Creating, editing and deleting tags from the main menu
Another way to manage tags and smart tags is from the main menu, under "Settings" >
"Tags", using the buttons located on the right side to:
19
1. Create tag.
2. Edit tag or smart tag.
3. Remove tag or smart tag.
2. Users
There are two types of users: with or without credentials. Both may own an asset; the
difference is that the user with credentials can access the system, while the user without
credentials does not have access, since it is only an entity created to be assigned to an
asset.
For credential users, the unique differentiator is the username; therefore, it cannot be
repeated. Meanwhile, usernames without credentials can be repeated.
● Administrator
● Technical
Next, we will describe the two configuration tabs available in this section.
20
A. Users
List of users
Within the "Settings" > "Users" > "Users" section, you will find the list of InvGate Insight
users.
In there, you can see which users have credentials and which do not, and also, which are
local and which are imported.
These are the actions you can perform within this section:
1. Import Users
2. Create Users
3. Tabs by role and user type
4. Multiple selector
5. User search bar
6. Page selector
7. Setting for number of items per page
8. User profile image
9. User information
10. User type
21
11. Sync user information - only available to users imported via LDAP
12. Edit user profile
13. Delete user
Create local users
Go to "Settings" > "Users" > "Users" and click "Add":
If you want to create a user with credentials, select the type of user "Technical" or
"Administrator", and the fields to enter a username and password will be displayed.
The remaining fields of the pop-up window will be the same for all types of users. Within
the first tab, the required field is the full name.
22
While on the second tab, you must complete the email address.
23
Additionally and optionally, you can enter other information such as telephone, address,
position, and date of birth.
Importing users
There is a feature that allows to import users through a .CSV file, so that they can be
added to InvGate Insight. They will be users without credentials. To use it, go to
"Settings" > "Users" > "Users" and click on "Import":
24
When you click on the highlighted button, a pop-up window will open with the following
options:
Once the file has been uploaded, its content will be displayed as a preview:
25
B. Directory Services
In “Settings” > “Users” > “Directory Services” it is possible to synchronize existing users
to InvGate Insight from LDAP.
This section shows a list of all the directory integrations made, plus different options:
26
When entering the integration registration form, you must fill it out with the following
information:
27
28
When using this tool, you will proceed to the following screen to determine which users
will be imported and synchronized with the directory:
29
Selected users will be created in InvGate Insight. Take into account that:
30
Assets
● Desktop
● Computer (Laptop)
● Monitor
● Tablet
● Phone
● Router
A. Asset Fields
This section allows you to create and assign custom fields to asset types. Custom fields
can be of any of the following types:
● Text
● Numeric
● Date and time
● List
31
Upon entering the Registration form, the following fields must be completed:
1. Name.
2. Description.
3. Types of assets to which it will apply.
4. Field type.
5. Additional configurations depending on the type of field.
6. Custom format for the value.
32
List of fields
Within the "Settings" > "Assets" > "Fields" section, you will find the list of customizable
fields.
To manually add assets, click on the “+” shortcut on the top menu:
Next, select the type of asset you want to add. The following screen will be the same for
all types; next, we will review each of its sections.
● General
The following information must be entered:
33
1. Name.
2. Status.
3. Manufacturer: If the desired option does not exist, it can be created on-the-fly b
y
clicking on the “+” sign and completing the name of the new manufacturer:
4. Model: The options depend on the manufacturer chosen in the previous field; if
the desired option does not exist, it can be created on-the-fly by clicking on the “+”
sign and completing the specifications of the asset*:
34
*Note: If the asset being created is of type monitor, when adding a new model, the
following additional fields will appear: height, width, aspect ratio, inches, and resolution. If
the asset is of type tablet or cell phone, the additional screen size field will appear.
5. Total: Amount of assets with the same description that will be created; allows to
register the same device several times, thus only changing the inventory ID and
the serial number.
● Financial information
The following information must be entered:
35
1. Invoice number.
2. Acquisition date.
3. Type of acquisition.
4. Price and currency.
5. Cost center: If the desired option does not exist, it can be created on-the-fly by
clicking on the “+” sign and completing a name:
6. Purchase number.
7. Provider: If the desired option does not exist, it can be created on-the-fly by
clicking on the “+” sign and entering a name:
8. Warranty expiration.
36
9. Depreciation percentage.
● Inventory information
The following data must be entered:
Asset editing
Within the profile of any asset, in the top bar, there is a button for editing:
There, you can edit data related to three sections: General, Additional, and Financials.
37
D. Types of assets
This section allows you to manage the types of assets and custom fields that apply to
them.
38
1. Name.
2. Asset fields that will be assigned.
List of types
Within the section "Settings" > "Assets" > "Types", you will find the list of types.
39
E. Health rules
This feature consists in the evaluation of certain conditions, which are qualified as in
“Critical” or “Warning” status. Health rules apply to assets with tags and are executed
every hour on new assets with those tags, or when a rule is created, edited or reordered.
If more than one rule applies to the same labels, their order of evaluation is determined
manually, by doing drag & drop in the list of rules from "Settings" > "Assets" > "Health":
40
41
42
Health rules determine the health status of an asset: if it meets at least one
"Critical" condition, it will adopt that status; if the most serious condition that it
meets is a "Warning", it will adopt that status. If no condition is met, it will adopt
the "Safe" status.
F. Life cycle
The life cycle state is a property that can be assigned to an asset. Each state will have a
behavior that will indicate how the asset will be affected.
● Tracked:
○ The asset can be found using the Explorer and the Search Bar.
○ Asset information will be kept up to date based on agent reporting.
● Hidden:
○ The asset cannot be found using the Explorer nor the Search Bar, unless it is
specifically searched for the status assigned to it.
● Untracked:
○ The asset cannot be found using the Explorer nor the Search Bar, unless it is
specifically searched for the status assigned to it.
Creating status
To start, go to “Settings” > “Assets” > “Life cycle” and click on “Add”.
43
44
List of status
In “Settings” > “Assets” > “Life cycle”, you will find the list of status.
From there, you can edit or delete the existing life cycle statuses.
45
The system will open a form where you must complete the following information:
1. Name of the template.
2. Prefix.
46
5. Suffix.
Editing Inventory ID templates
From the main listing in “Settings” > “Assets” > “Inventory ID”, you can manage
templates using the tools located on the right:
1. Edit.
2. Delete.
To define the types of assets where this feature will be used, select them from the
“Inventory ID as name” selector and save the configuration.
47
H. Asset import
This feature allows you to import assets using a .CSV file, so that you can add them to
InvGate Insight. To do so, go to “Settings” > “Assets” > “Import assets”.
A form will open, where you must complete the following information:
The column assignment must be made with respect to the properties of the assets. Once
finished, click on “Preview”.
Note: If any column contains the same name as the asset properties, it will be assigned
automatically.
48
49
Once the file has been uploaded, its content will be displayed as a preview:
*Note: For some of the properties, if a value is not found in the system, it will be created
on-the-fly when importing the assets. These cases will be marked in blue in the preview
and will be considered valid.
50
4. Network
In this section you can perform the remote installation of the InvGate Insight agent, or
download and install it manually on the assets you want to monitor. In addition,
integrations can be configured to import and synchronize assets from external entities,
such as Amazon Web Services, Microsoft Azure, or Google Suite Account.
A. Agent Deployment
This section allows you to deploy the InvGate Insight agent on the supported operating
systems (Windows, Linux, macOS, and Android) in its different methods.
2. Method
3. Proxy
4. In the case of manual installation, you can indicate whether it is a new installation
or the re-installation of the agent. Note: In case it is a re-installation, you must
enter the agent identifier in order to avoid generating duplicate assets. It can be
found in the profile of the assets.
51
B. Proxy
In this section, proxy servers can be detected and managed:
52
1. Search for new connections.
2. Proxy name.
6. Edit.
7. Hide. Note: the proxy will not be listed until it is used in a discovery process or an
agent uses it to report.
C. Discovery sources
The InvGate Insight discovery feature allows to configure integrations with external
entities or define the parameters to run a network analysis to identify devices.
Regarding external entities, InvGate Insight integrates with Amazon AWS, Microsoft
Azure and Google Suite Admin. In this way, it imports and synchronizes information about
EC2 instances, virtual machines, Chromebooks, and smartphones.
Regarding the network analysis, InvGate Insight allows to define a range of IP addresses
and, based on the network protocols, tries to identify all the devices that are connected to
it. Then, within the Discovery section, you can verify these devices and identify them as
assets where appropriate.
53
Azure
Integration with Azure allows you to import and synchronize VMs in InvGate Insight. In
this way, profiles are generated with information on each of the existing VMs, as well as a
profile with global account information, such as costs or status of the instances.
Registration Form
54
AWS
Integration with Amazon Web Services allows you to import and synchronize EC2
instances in InvGate Insight. In this way, profiles are generated with information on each
of the existing EC2 instances, as well as a profile with global account information, such as
costs or status of the instances.
Registration form
55
56
Google Suite Admin
Integration with Google Suite Admin allows you to import and synchronize Chromebooks
and mobile devices in InvGate Insight. In this way, profiles are generated with information
on each of the imported assets.
It should be noted that, for this feature to be available, the integration parameters
detailed in this section must have been configured.
Registration form
57
58
5. Synchronization schedule.
6. Starting date.
7. Sync Recurrence.
InvGate Discovery
When configuring a new “InvGate Discovery” integration, you need to specify the
parameters to execute network analysis.
The network protocols available to perform the discovery are: DNS, ICMP, mDNS,
NetBIOS, SNMP (in its three versions), TCP and UPnP. For each of them, you must specify
the corresponding credentials and the network port you use.
*Note: To set up an integration of this type, it will be required to have a v2.0 Proxy (or
higher).
Registration form
59
60
From it you can edit, execute or delete the already configured integrations.
61
4. Tasks
Tasks are executed in the background to monitor the progress and status of certain
processes. They can be viewed from thesection. "Settings" > "Tasks".
Next we point out the items available on the main task screen:
1. Create a task.
62
Detail of tasks
Clicking on the hyperlink of the title of a task you access its details, which includes a list of
sub-tasks included in the process.
1. Details of the task: title, number of processes included, start date and time, end
date and time and author.
2. Counter sub-tasks pending, running, completed or failed / canceled.
3. Update data
63
4. Restart tasks
5. Cancel tasks
6. Search among sub-tasks.
7. Show all errors.
8. Details of the sub-tasks: IP or equipment on which they are executed, start date
and time, end date and time, duration and confirmation or error message.
9. State of the sub-task.
10. Cancel sub-task (only available on new or running tasks).
5. Integrations
Introduction
The integration of InvGate Insight with InvGate Service Desk helps to improve the
management of requests and change processes, since it allows:
● Obtain the number of requests related to an asset and display them in the profile.
● Obtain the data of requests related to an asset (title, status, priority, customer,
agent).
● Apply filters or assemble reports using the number of open incidents an asset has.
● Go to a request via a direct link.
64
2. API URL for InvGate Service Desk (see section "API" of the manual InvGate
Service Desk)
3. API User
4. API Password
6. Test Connection
65
B. API
Introduction
The API provides a set of functions that allow other applications to access system
information, as well as take action on it. To allow integration with external applications,
the corresponding credentials must be created.
66
1. API URL, which will be generated by default in the instance. Your documentation
will also be available.
API
credential management The credentials that have been added will be listed in “Settings”>
“Integrations”> “API”. With the tools located on the right, you can perform the following
actions:
67
68
V. User guides
1. Searchsearch
bar Thebar allows you to assemble terms based on filters and operators using only the
keyboard.
Once a search term is completed, the results for each Explorer (Hardware and Software)
are displayed, which can be navigated using the corresponding tabs.
A. Filters
The search bar uses filters that can be assembled by selecting a property, followed by an
operator and finally the value to be searched. For example: location.is:USA.
Both the operator and the type of value are defined by the property; in some cases it is
possible to write the value freely, while in others a list will be displayed to select them. A
calendar may also appear for filters that correspond to a date.
B. Suggestions
By default, positioning the cursor in the search bar suggests a series of preselected filters
(1) and the types of assets available to filter (2):
69
When you start writing a search, the bar will suggest these pre-assembled filters based on
the value of the word you are trying to find, which will be contrasted with the records of
assets, programs, manufacturers, locations, owners, labels or barcodes that contain
that value.
70
Thus, you can generate a search that redirects to the Explorer or enter directly to the
result profile by pressing ctrl + enter.
2. Explorer
A. Introduction
The Explorer gathers all the information related to assets and software that were
registered in the application. Here you can navigate this information in a friendly way, as
well as save views and export them.
71
Editing an asset
The data of an asset that is displayed in the Asset Explorer can be edited by following
these steps:
72
A window will open on the right side with fields that can be edited as a block (those that
do not want to be modified will keep their current value):
73
74
A window will open on the right side with fields that can be edited as a block (those that
do not want to be modified will keep their current value):
75
76
77
C. Custom views
They allow you to store filters and search customizations, storing all the navigation
settings made, to make them easy and fast. Custom views can be applied for Assets and
Software, and can only be viewed and manipulated from the corresponding section; that
is, you cannot manipulate a custom view created in Assets from Software, and vice versa.
Views are saved per user and cannot be shared. To view them, click on the views icon that
appears in the Asset Explorer and select the view that is of interest, as shown in the
following screenshot:
78
79
D. Report generation
The system allows you to export customized views and search results in .csv format. The
maximum number of entries that can be exported per operation is 100,000, and data on
assets, facilities and programs can be included.
The file will contain the columns that have been selected in the system at the time of
starting the report.
3. Discovery
Introduction
Within the Discovery section, you will find all the devices that were identified during the
network scan, and have not yet been converted into assets. Once this happens, they
become part of the Explorer with the rest of the assets.
80
Conversion to an asset
Any device in the Discovery section can be converted into an asset and become part of
the Asset Explorer. When converting it will be required to enter asset data, for which the
following steps should be followed:
81
A window will open on the right side with the fields to complete. The entry of a name,
type, manufacturer and model, and state will be required.
82
Conversion to assets can only be made from one asset per attempt.
83
Change of status
Within the Discovery table, the devices will be assigned one of the two available states:
● Pending.
● Ignored.
Any new device that is found will be identified as pending. They will also be the ones that
will be seen by default when entering the Discovery section.
Any device that is marked as ignored will be updated if it is found again when performing
a network analysis, but it will not be visible in the default view of the Discovery section.
84
Profiles
A. Active
There are four types of assets:
All of them can have labels, owners, locations, attachments, a health status, an activity log,
related requests via InvGate Service Desk, and financial information. In addition,
depending on the type of asset, more information can be found.
Below, we indicate the elements available in the profile of an asset reported by agent:
85
1. Identification data of the asset.
2. Last update.
86
B. Location
It is a property that can be assigned manually to an asset or user. The profile of a location
shows all the entities and facilities that have it assigned, and also recursively takes into
account its sub-locations.
87
C. Manufacturer
This profile shows assets of all types that have a certain associated manufacturer, as well
as program installations by that manufacturer.
88
89
D. User
This profile shows an owner’s details and the assets assigned to them, as well as a record
of their activity.
E. Software
This profile shows the details of software programs.
90
Notifications
F. Introduction
Notifications let you know about changes and activity records in the assets to which you
are subscribed.
91
G. Visibility
The initial warning is a pop-up message of limited duration, which is then stored in the list
of notifications located in the upper right menu. From there, you can check the latest
events, and the count of unread notifications is displayed:
92
6. Subscriptions
A. Introduction
If a user subscribes to an asset, they will receive notifications about events related to it.
B. Subscription
If you drop down the list of notifications, you can access subscriptions with the “View
subscriptions” option.
Within the list, you can access the following details:
93
94