For partners subscribed to Enterprise plans.

Introduction

Use this article as a guide when you integrate with the Reporter Appliance add-on to the RapidFire Tools Network Detective software. This integration discovers assets, computers, servers, applications, and services such as Active Directory, DNS, and DHCP. Then, it automatically builds relationships between the assets.

The integration uses an API link to write the collected data from Reporter directly in to IT Glue, allowing you to streamline your applications and services. The data is synced as structured documentation and flexible assets are created automatically. In the case that there are pre-existing configurations in IT Glue, the integration enriches the information that is already being synced from your PSA and RMM tools.

Prerequisites

• Partners must be subscribed to the Enterprise plan as the integration requires the IT Glue API.
• Partners must complete the following before starting the integration:
  • Install the Network Detective application.
  • Install a Reporter scan server on your MSP network. Refer to "Initial Reporter Setup" on page 17, Reporter User Guide.
  • Ensure that a Remote Data Collector (and its associated Client-Connector) is set up with a Reporter Site configured to perform regular scan tasks. Refer to "Initial Remote Data Collector Setup" on page 22 and "Configure Remote Data Collector to Perform Scan Tasks" on page 30, Reporter User Guide.
• System Requirements:
  • Windows 8 or later
  • 10GB of free disk space
  • Minimum of 8GB RAM (16GB RAM recommended)

Instructions

Generating an API key

1. Log in to your IT Glue account and navigate to Account > API Keys.

   
   

2. In the Custom API Keys section, enter a name for the key and click Generate API Key.
3. Save the API key in a secure location as you will need it in a subsequent step within this KB article.

Creating export tasks

1. Create a Report Export Task to export the data to IT Glue.
   1. Navigate to the Reporter site and then click on Reporter > Tasks > Create Export Tasks.

      
      

   2. In the Select Export Task pop-up, select Export Configurations, enter a task label (e.g. "Daily Export to IT Glue"), and click the Next button.

      
      

   3. Select IT Glue from the list of available integrations.

      
      

2. Enter the IT Glue connection parameters and target organizations. To add IT Glue to the connection parameters, click on Manage Connections.
3. In the Connections Manager window, click on the New button to create the API connection between IT Glue and Network Detective. Enter a connection name and your IT Glue API credentials and click OK.

   • In the API URL field, enter https://api.itglue.com. For EU partners, enter https://api.eu.itglue.com.

     

4. Select the IT Glue connection that is now available in the drop-down. Then, select the configuration items you want to export.
   Warning. If you have other integrations creating Contacts and/or Configurations in IT Glue such as a PSA and RMM, DO NOT select the Export Contacts and Export Computers options as they will create unwanted duplicates.
   
   IMPORTANT! We strongly recommend that you select the following checkboxes:

   • 'Exclude Server Features and Options'
   • 'Exclude Startup Programs'
   • 'Exclude Windows Services'

   If you do not select these options, the Reporter will detect and add all of these items to IT Glue which may clutter search and navigation. If you have any questions, please Contact Us before you complete this step.

   
   

5. Again, review the configuration items that you have selected to exclude in the step above.
6. Then, click Update.

The Export Task will now appear in the task list.

Scheduling export tasks

1. To initiate a scan, move the scan from the task list to into Scheduled Tasks. There are two ways to do this:
   1. First option - In the task list, click on Run Now in the Action column to automatically move the scan into the Scheduled Tasks list.

      
      

   2. Second option - Click Schedule to run the scan sometime in the future. In the CRON Builder window, set the time zone, recurrence, and time and then click OK.

      
      

2. Schedule the Export Task and select the IT Glue connection.

The system will now scan and automatically populate data in to IT Glue. Please note that it may take up to 3 hours for your results to appear.

Accessing data in IT Glue after scan and export

1. Log in to your IT Glue account and verify that flexible assets are added to your sidebar. To do this, navigate to Account > General and click Customize Sidebar.
   Tip! If the flexible assets are listed in the "Sidebar Sections" column, click Save to continue. If they are listed in the "Flexible Assets" column, then drag them into the Sidebar Sections column in the order you would like them to appear. For more details, refer to our KB article here.
2. Navigate to the Organization main page and click on a newly updated item in the Apps & Services section. The flexible asset types are:
   • AD Domain
   • Domain Controller
   • FSMO Role
   • AD Computer
   • AD User
   • Security Group
   • Group Policy
   • DNS Entry
   • Windows Service
   • Enabled Server Feature
   • Enabled Optional Feature
   • Startup Programs
   • Non-AD Device
   • Microsoft SQL Server
   • Web Server
   • Time Server
   • Exchange Server
   • DHCP Server
   • Hyper-V Server
   • Hyper-V Guest
   • Printer (Attached)
   • Printer (Networked)
   • Printer (Share)
   • Network Share
   • Installed Application
   • Licence Key
   • Missing Windows Patch

   

3. Open an item to see how the Reporter has automatically built relationships between the assets. Refer to the Matching Criteria for Configurations and Contacts section in this KB article for more information.
   
   Example of a Flexible Asset created by the integration:
   
4. Active Directory users are added as IT Glue Contacts.

Matching Criteria for Configurations and Contacts

The Reporter Appliance will always attempt to make a match according to the criteria in existing IT Glue Configurations and Contacts as listed in the table below.

In the case that there is no match, Reporter will create a new IT Glue Configuration and Contact. The matching logic for IT Glue Configurations and Contacts is similar to that of a PSA and RMM.

Association Criteria for Flexible Assets

New Flexible Assets created by the Reporter integration will always attempt to automatically associate to IT Glue assets (i.e. Configurations and Contacts) based on the table below:

Key Fields

What is a Key Field? Each Flexible Asset created by the Reporter integration has specific fields that it uses to associate data to. Please see the table below for all Key Fields.

* IT Glue Configuration