Ask the Community
Groups
Integrating with RapidFire Tools' Network Detective & Reporter Appliance - Connect IT Community | Kaseya
<main> <article class="userContent"> <p><em>For partners subscribed to Enterprise plans.</em></p> <p>Introduction</p> <p>Use this article as a guide when you integrate with the <a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Fwww.rapidfiretools.com%2Fproducts%2Fnetwork-detective%2Freporter-appliance%2F">Reporter Appliance</a> 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.</p> <p>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.</p> <div> <strong>Important.</strong> This is a powerful integration that can create thousands of assets in IT Glue. We <em><strong>highly</strong> </em>recommend that you review your settings carefully as the data created cannot be mass deleted.<br><br> This integration has unique matching criteria to prevent duplicates. Please review the <a rel="nofollow" href="#mc"><em>Matching Criteria for Configurations and Contacts</em></a> section of this KB article to prevent duplication of data. If you have any questions, please <strong><a href="https://kaseya.vanillacommunities.com/kb/articles/aliases/itglue/hc/en-us/articles/360004938018-Contacting-IT-Glue-support" rel="noopener nofollow">Contact Us</a> </strong>before proceeding.</div> <p>Prerequisites</p> <ul><li>Partners must be subscribed to the Enterprise plan as the integration requires the IT Glue API.</li> <li>Partners must complete the following before starting the integration: <ul><li>Install the Network Detective application.</li> <li>Install a Reporter scan server on your MSP network. Refer to <em>"Initial Reporter Setup"</em> on page 17, <a href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Fwww.rapidfiretools.com%2Fnd%2FNetwork_Detective_Reporter_User_Guide.pdf" rel="noopener nofollow">Reporter User Guide</a>.</li> <li>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 <em>"Initial Remote Data Collector Setup" </em>on page 22 and <em>"Configure Remote Data Collector to Perform Scan Tasks" </em>on page 30, <a href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Fwww.rapidfiretools.com%2Fnd%2FNetwork_Detective_Reporter_User_Guide.pdf" rel="noopener nofollow">Reporter User Guide</a>.</li> </ul></li> <li>System Requirements: <ul><li>Windows 8 or later</li> <li>10GB of free disk space</li> <li>Minimum of 8GB RAM (16GB RAM recommended)</li> </ul></li> </ul><p>Instructions</p> <h3 data-id="generating-an-api-key">Generating an API key</h3> <ol><li>Log in to your IT Glue account and navigate to <strong>Account > API Keys</strong>. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/AT5FITKP8ZWD/account-settings-it-glue.png" alt="Account_Settings___IT_Glue.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li>In the <strong>Custom API Keys</strong> section, enter a name for the key and click <strong>Generate API Key</strong>.</li> <li>Save the API key in a secure location as you will need it in a subsequent step within this KB article.</li> </ol><div> <strong>Note:</strong> You will not be able to view a key again after it has been generated. Once you leave the this screen, the full API key will not be displayed again.</div> <h3 data-id="creating-export-tasks">Creating export tasks</h3> <ol><li>Create a Report Export Task to export the data to IT Glue. <ol type="a"><li>Navigate to the Reporter site and then click on <strong>Reporter > Tasks > Create Export Tasks</strong>. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/5ID4JLJY1WXQ/reporter-user-guide-3.png" alt="Reporter_User_Guide-3.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li>In the <strong>Select Export Task</strong> pop-up, select <strong>Export Configurations</strong>, enter a task label (e.g. "Daily Export to IT Glue"), and click the <strong>Next</strong> button. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/57849V3O70JU/reporter-to-it-glue-product-description-document-docx-google-drive-1-2.png" alt="Reporter_to_IT_Glue_-_Product_Description_Document_docx_-_Google_Drive-1-2.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li>Select <strong>IT Glue</strong> from the list of available integrations. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/LLO0AYN9179G/integrating-with-rapidfire-tools-network-detective-reporter-appliance-draft-google-docs.png" alt="Integrating_with_RapidFire_Tools_Network_Detective_Reporter_Appliance_-_DRAFT_-_Google_Docs.png" class="embedImage-img importedEmbed-img"></img></p> </li> </ol></li> <li>Enter the IT Glue connection parameters and target organizations. To add IT Glue to the connection parameters, click on <strong>Manage Connections</strong>.<img src="https://us.v-cdn.net/6032361/uploads/migrated/KVG24FIT9C19/integrating-with-rapidfire-tools-network-detective-reporter-appliance-draft-google-docs-3-2.png" alt="Integrating_with_RapidFire_Tools_Network_Detective_Reporter_Appliance_-_DRAFT_-_Google_Docs-3-2.png" class="embedImage-img importedEmbed-img"></img></li> <li>In the <strong>Connections Manager</strong> window, click on the <strong>New</strong> button to create the API connection between IT Glue and Network Detective. Enter a connection name and your IT Glue API credentials and click <strong>OK</strong>. <ul><li> <p>In the API URL field, enter <em><strong><a href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Fapi.itglue.com">https://api.itglue.com</a></strong></em>. For EU partners, enter <em><strong><a href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Fapi.eu.itglue.com">https://api.eu.itglue.com</a></strong></em>.</p> <p><img src="https://us.v-cdn.net/6032361/uploads/migrated/NJBHZVLXI10W/integrating-with-rapidfire-tools-network-detective-reporter-appliance-draft-google-docs-2.png" alt="Integrating_with_RapidFire_Tools_Network_Detective_Reporter_Appliance_-_DRAFT_-_Google_Docs-2.png" class="embedImage-img importedEmbed-img"></img></p> </li> </ul></li> <li>Select the IT Glue connection that is now available in the drop-down. Then, select the configuration items you want to export. <div> <strong> Warning.</strong> If you have other integrations creating Contacts and/or Configurations in IT Glue such as a PSA and RMM, <em><strong>DO NOT </strong></em>select the <strong>Export Contacts </strong>and <strong>Export Computers </strong>options as they will create unwanted duplicates.<br><br><em><strong>IMPORTANT! We strongly recommend that you select the following checkboxes:</strong></em> <ul><li><em><strong>'Exclude Server Features and Options'</strong></em></li> <li><em><strong>'Exclude Startup Programs'</strong></em></li> <li><em><strong>'Exclude Windows Services'</strong></em></li> </ul><em><strong>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.</strong></em> <em><strong>If you have any questions, please <a href="https://kaseya.vanillacommunities.com/kb/articles/aliases/itglue/hc/en-us/articles/360004938018-Contacting-IT-Glue-support" rel="noopener nofollow">Contact Us</a> before you complete this step.</strong></em> </div> <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/SA4PPROJ9XF7/slack-it-glue-2-png.png" alt="Slack_-_IT_Glue-2_png.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li><em><strong>Again, review the configuration items that you have selected to exclude in the step above</strong>.</em></li> <li>Then, click <strong>Update.</strong> </li> </ol><p>The Export Task will now appear in the task list.</p> <h3 data-id="scheduling-export-tasks">Scheduling export tasks</h3> <ol><li>To initiate a scan, move the scan from the task list to into Scheduled Tasks. There are two ways to do this: <ol><li type="a"> <strong>First option</strong> - In the task list, click on <strong>Run Now</strong> in the <strong>Action</strong> column to automatically move the scan into the <strong>Scheduled Tasks</strong> list. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/5X0M3OWNNQ9B/reporter-user-guide-4.png" alt="Reporter_User_Guide-4.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li type="a"> <strong>Second option</strong> - Click <strong>Schedule</strong> to run the scan sometime in the future. In the <strong>CRON Builder</strong> window, set the time zone, recurrence, and time and then click <strong>OK</strong>. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/6T9AJHAM32SY/skitch-background-google-docs.png" alt="Skitch_Background_-_Google_Docs.png" class="embedImage-img importedEmbed-img"></img></p> </li> </ol></li> <li>Schedule the Export Task and select the IT Glue connection.</li> </ol><p>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.</p> <div> <strong>Important. </strong>You must allow time for the scan task to complete before the report and/or export tasks are scheduled to begin. This is to ensure that the RDC can perform and upload the scans so Reporter is using the latest data. <em>We recommend you schedule the reports <strong>3 or more hours</strong> after your scan tasks are scheduled to begin.</em> </div> <h3 data-id="accessing-data-in-it-glue-after-scan-and-export">Accessing data in IT Glue after scan and export</h3> <ol><li>Log in to your IT Glue account and verify that flexible assets are added to your sidebar. To do this, navigate to <strong>Account > General</strong> and click <strong>Customize Sidebar</strong>. <div> <strong>Tip!</strong> If the flexible assets are listed in the "Sidebar Sections" column, click <strong>Save</strong> 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 <a href="https://kaseya.vanillacommunities.com/kb/articles/aliases/itglue/hc/en-us/articles/360004939738-Organizations-sidebar" rel="noopener nofollow">here</a>.</div> </li> <li>Navigate to the <strong>Organization</strong> main page and click on a newly updated item in the <strong>Apps & Services</strong> section. The flexible asset types are: <ul><li>AD Domain</li> <li>Domain Controller</li> <li>FSMO Role</li> <li>AD Computer</li> <li>AD User</li> <li>Security Group</li> <li>Group Policy</li> <li>DNS Entry</li> <li>Windows Service</li> <li>Enabled Server Feature</li> <li>Enabled Optional Feature</li> <li>Startup Programs</li> <li>Non-AD Device</li> <li>Microsoft SQL Server</li> <li>Web Server</li> <li>Time Server</li> <li>Exchange Server</li> <li>DHCP Server</li> <li>Hyper-V Server</li> <li>Hyper-V Guest</li> <li>Printer (Attached)</li> <li>Printer (Networked)</li> <li>Printer (Share)</li> <li>Network Share</li> <li>Installed Application</li> <li>Licence Key</li> <li>Missing Windows Patch</li> </ul><p><img src="https://us.v-cdn.net/6032361/uploads/migrated/FLQ9Z8CKBO1E/ad-computers-it-glue.png" alt="AD_Computers___IT_Glue.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li>Open an item to see how the Reporter has automatically built relationships between the assets. Refer to the <em>Matching Criteria for Configurations and Contacts<strong> </strong></em>section in this KB article for more information.<br><br><em>Example of a Flexible Asset created by the integration:</em><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/8GNWP7AT0W80/test-win10-1-it-glue-4.png" alt="TEST_WIN10-1___IT_Glue-4.png" class="embedImage-img importedEmbed-img"></img><img src="https://us.v-cdn.net/6032361/uploads/migrated/VEU851PBHN1D/test-win10-1-it-glue-2-2.png" alt="TEST_WIN10-1___IT_Glue-2-2.png" class="embedImage-img importedEmbed-img"></img><img src="https://us.v-cdn.net/6032361/uploads/migrated/ZMCYS4KG2XUM/test-win10-1-it-glue-3-2.png" alt="TEST_WIN10-1___IT_Glue-3-2.png" class="embedImage-img importedEmbed-img"></img></li> <li>Active Directory users are added as IT Glue Contacts.</li> </ol><p><a name="mc" id="mc"></a>Matching Criteria for Configurations and Contacts</p> <p>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.</p> <p>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.</p> <table style="width: 655px;"><tbody><tr style="background-color: DCDCDC;"><td><strong>Rule for match on association</strong></td> <td><strong>Association matches on</strong></td> </tr><tr><td>IT Glue Configurations</td> <td> <ul><li>Exact match on configuration type <strong>and</strong> primary MAC address <strong>and</strong> serial number. <ul><li>If there is no match on <em>all</em> three of these fields, the exact match is on the configuration type <strong>and </strong>primary MAC address.</li> <li>If there is no match on those fields, the exact match is on the configuration type <strong>and</strong> serial number.</li> </ul></li> </ul></td> </tr><tr><td>IT Glue Contacts</td> <td> <ul><li>Exact match both on a first and last name.</li> </ul></td> </tr></tbody></table><h3 data-id="association-criteria-for-flexible-assets">Association Criteria for Flexible Assets</h3> <p>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:</p> <table style="width: 657px;"><tbody><tr style="background-color: DCDCDC;"><td><strong>Rule for match on association</strong></td> <td><strong>Association matches on</strong></td> </tr><tr><td>IT Glue Configurations</td> <td> <ul><li>Exact match on configuration type <strong>and</strong> primary MAC address <strong>and</strong> serial number. <ul><li>If there is no match on <em>all</em> three of these fields, the exact match is on the configuration type <strong>and </strong>primary MAC address.</li> <li>If there is no match on those fields, the exact match is on the configuration type <strong>and</strong> serial number.</li> </ul></li> </ul></td> </tr><tr><td>IT Glue Contacts</td> <td> <ul><li>Exact match both on a first and last name. <ul><li>If there is no match on these fields, the exact match is on the email address (not case sensitive).</li> </ul></li> </ul></td> </tr><tr><td>IT Glue Domains</td> <td> <ul><li> Domain name </li> </ul></td> </tr></tbody></table><h3 data-id="key-fields">Key Fields</h3> <p><strong>What is a Key Field?</strong> 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.</p> <div> <strong>Important.</strong> After the initial scan by the Reporter Appliance, <strong>DO NOT</strong> edit the content in these fields within IT Glue. <strong>Doing so will create duplicates in your IT Glue account.</strong> If you edit the fields after the initial scan, the fields will not match again in subsequent scans and the integration will create a new, duplicate asset.</div> <table><tbody><tr style="background-color: DCDCDC;"><td> <p><strong> Flexible Asset Type </strong></p> </td> <td> <p><strong>Key Fields</strong></p> </td> </tr><tr><td> <p>AD Domain</p> </td> <td> <p>Domain Name</p> </td> </tr><tr><td> <p>Domain Controller</p> </td> <td> <p>Computer*, Domain</p> </td> </tr><tr><td> <p>FSMO Role</p> </td> <td> <p>Domain, Role, Domain Controller</p> </td> </tr><tr><td> <p>AD Computer</p> </td> <td> <p>Domain, Configuration</p> </td> </tr><tr><td> <p>AD User</p> </td> <td> <p>Domain, Username</p> </td> </tr><tr><td> <p>Security Group</p> </td> <td> <p>Domain, Group Name</p> </td> </tr><tr><td> <p>Group Policy</p> </td> <td> <p>Domain, Policy Name</p> </td> </tr><tr><td> <p>DNS Entry</p> </td> <td> <p>IP Address</p> </td> </tr><tr><td> <p>Windows Service</p> </td> <td> <p>Computer*, Service Name</p> </td> </tr><tr><td> <p>Enabled Server Feature</p> </td> <td> <p>Computer*, Feature</p> </td> </tr><tr><td> <p>Enabled Optional Server</p> </td> <td> <p>Computer*, Feature</p> </td> </tr><tr><td> <p>Startup Programs</p> </td> <td> <p>Computer*, Startup Item</p> </td> </tr><tr><td> <p>Non-AD Device</p> </td> <td> <p>IP Address, Computer Name</p> </td> </tr><tr><td> <p>Microsoft SQL Server</p> </td> <td> <p>Sever Name, Instance</p> </td> </tr><tr><td> <p>Web Server</p> </td> <td> <p>Computer Name</p> </td> </tr><tr><td> <p>Time Server</p> </td> <td> <p>Server Name</p> </td> </tr><tr><td> <p>Exchange Server</p> </td> <td> <p>Server Name</p> </td> </tr><tr><td> <p>DHCP Server</p> </td> <td> <p>Server Name</p> </td> </tr><tr><td> <p>Hyper-V Server</p> </td> <td> <p>Hostname</p> </td> </tr><tr><td> <p>Hyper-V Guest</p> </td> <td> <p>Host, Guest Name</p> </td> </tr><tr><td> <p>Printer (Attached)</p> </td> <td> <p>IP Address, Printer Name</p> </td> </tr><tr><td> <p>Printer (Networked)</p> </td> <td> <p>IP Address, Printer Name</p> </td> </tr><tr><td> <p>Printer (Share)</p> </td> <td> <p>Shared Printer</p> </td> </tr><tr><td> <p>Network Share</p> </td> <td> <p>Hose, Share UNC</p> </td> </tr><tr><td> <p>Installed Application</p> </td> <td> <p>Computer*, Application Name</p> </td> </tr><tr><td> <p>License Key</p> </td> <td> <p>Computer*, Application Name</p> </td> </tr><tr><td> <p>Missing Window Patch</p> </td> <td> <p>Computer*, Issue</p> </td> </tr></tbody></table><p><em>* IT Glue Configuration</em></p> </article> </main>