1. Access the Administration module.
2. Select Integration Tasks from the Integrations option on the menu.
3. In the Integration Tasks section, click Create Task.
4. Select the Import Assets from NeXpose Scanner option from the list that appears (see figure below).
The system displays the form that must be completed to create the new task (see figure below).
5. In the Name field, enter a name to identify the new integration routine.
6. In the Status field, determine the status of the new task. If you select Active, the routine will be activated immediately after it is created. If you select Inactive, the routine will be created but will not function until it is enabled.
7. You can create a schedule for the integration routine in the Schedule section. In the Start on field, enter a start date for the integration routine. Next, select one of the options (Daily, Weekly, Monthly, Yearly, Every minute, Hourly), to determine the frequency with which the task will be executed. The task can also be set to run only on week days or on weekends as well. In addition, it can be configured to have no end date by clicking the No end date option or configured to end by a certain date by completing the End by field. Note that some integration tasks may take more time to be executed than the option selected, which may result in performance problems.
8. In the Server Information section, enter the URL where the NeXpose server is located under the Server URL field, including the port number, for example: https://nexpose.abc.com.br:port. By default, the port number is 3780.
9. In the Access Credentials section, valid account information must be provided to access the database in one of the NeXpose servers. Note that these credentials are encrypted in the database. In the Access Account field, enter the NeXpose account username. Also note that only assets to which the user has access will be imported.
10. In the Access Password field, enter the password of the NeXpose account provided in the previous field.
11. In the Password Confirmation field, enter the password provided in the previous field for confirmation.
12. In the Import Options section, select a system user to be responsible for all assets and perimeters imported to the system through this integration task in the Responsible for Imported Objects field. When assets are imported, this user will automatically be assigned as responsible for the newly created assets and perimeters.
13. Mark the Update properties of existing assets checkbox if you want the assets imported through this integration task to be updated with the latest information from NeXpose. This will overwrite any changes you make to all properties of imported assets each time the integration task is executed.
14. Mark the Re-Import assets that were deleted from the system checkbox if you want the imported assets that have been deleted from the system to be recreated in the system the next time the task is executed if these assets still exist in NeXpose.
15. In the Default perimeter for imported assets field, you can select a parent or child perimeter to be the default location for all imported assets. If left blank, a new perimeter will be created each time the integration task is executed named “Imported from NeXpose [date + time imported]”.
16. In the Asset Components section, mark the Import asset components option if you want the task to create asset components for the assets being imported. The system creates these asset components automatically, based on the relationship between the CPE name selected for the associated knowledge base and the name of the operating system identified in the asset by NeXpose. For further details on CPE names, see http://cpe.mitre.org/specification/index.html.
17. In the Filter to Import Assets section, you can filter the assets to be imported by IP ranges or by groups of assets registered in the NeXpose database. When selecting the IP Ranges or Host Address option, a field will be displayed where you can enter the IP address ranges that will be used to filter the assets to be imported, a single IP address, or a host address to import all the assets from a server. In the case of an IP range or host address, insert one IP address, one host address or one IP address range per line. Ranges must be separated by a hyphen. Should you select the Groups of Assets option, one or more groups of assets must be selected to be imported by clicking Select Asset Groups. Note that valid credentials must be provided to access the NeXpose server and the user must have the necessary permissions. If the All option is selected, all assets found in NeXpose will be imported.
18. Mark the Enable history deletion checkbox if you want the system to automatically delete the execution history of the integration task after a certain number of days.
19. In the History Retention Time (Days) field, enter the number of days after which the history will be deleted. Note that the automatic deletion of the history deletes all of the task execution entries except for the most recent one.
20. Mark the Execute immediately after saving checkbox if you want the system to execute the task once it is saved. For subsequent executions the system follows the schedule set for the task.
21. When finished, click Save. If you want to quit the operation, click Cancel.
The system displays a success message.