<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><p><strong>In this guide we will cover:</strong></p><p><strong>- What is the Armis Integration?</strong></p><p><strong>- Connecting to Armis</strong></p><p><strong>- Sites</strong></p><p><strong>- Assets</strong></p><p><strong>- Syncing</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the Armis Integration?</span></strong></p><p>Armis can be integrated with Halo to import and manage Sites and Assets, and sync these on a recurring schedule to ensure details stay up-to-date.</p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to Armis</span></strong></p><p>In Configuration > Integrations > Asset Management and Alerting, find the "Armis" module. Hover over it and click the "+" icon to enable the module.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImZiNjhiNzBkLTU2ZjItNDk4Yy1hYjlkLTJhYmZmYTJlMjEwYSJ9.hcYbjNoUj76bpY0UIml96uEASqqfSPGJRVoXRNBAW3s" class="fr-fic fr-fil fr-dib" width="341" height="143"></p><p><strong><span style="font-size: 10pt;">Fig 1. Armis module</span></strong></p><p><br></p><p>Clicking into the module will show the "Details" tab to create a new Armis connection. Give the connection a name, and enter your Armis URL and API Key. The API Key can be obtained from <a href="https://docs.ic.armis.com/docs/introduction_api-keys" target="_blank" rel="noopener noreferrer"><strong>Armis</strong></a>.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI3ZDJhYjAxLWUxMWUtNGNjNC05YjY4LWFlZDM4NzJkYjEyYiJ9.NNBU2Z5CvtCnUMiWP9qo4pZh1fD8UsuCkhUylSIVNbE" class="fr-fic fr-fil fr-dib" width="1222" style="width: 1224px; height: 264.777px;" height="265"></p><p><strong><span style="font-size: 10pt;">Fig 2. Entering credentials</span></strong></p><p><br></p><p>Upon saving, you can then click the "Test Configuration" button that will appear. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI1YWExMTQ4LThkYzUtNDYyYy04ODVmLThkMzBlM2FiN2Q0MyJ9.kMW-8yurHd0H2jD-m3H4ZO35h4kt8drPXo_1FrRHBvk" class="fr-fic fr-fil fr-dib" width="1218" style="width: 1220px; height: 228.75px;" height="229"></p><p><strong><span style="font-size: 10pt;">Fig 3. Test Configuration button</span></strong></p><p><br></p><p>A popup will then show to tell if the test was successful. If the credentials are invalid, an error message will show here to help troubleshoot.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImYzM2JmNjQ0LWRlNTQtNGFlNC1iMTY3LTczOThkZmM3OGE2YSJ9.lms5KC1AY_TRH3-a70qoFi_-4OY8cFLmYXQmZhaAUU4" class="fr-fic fr-fil fr-dib" width="169" height="110"></p><p><strong><span style="font-size: 10pt;">Fig 4. Test successful popup</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Sites</span></strong></p><p>Switch to the Sites tab to import your sites from Armis. The first field has a dropdown to select a "Site matching method", which will determine the fields that show afterwards to configure the import.</p><p><br></p><p><strong><span style="font-size: 12pt;">Import and map sites from Armis to sites in Halo<br></span></strong></p><p>The first method is to "Import and map sites from Armis to sites in Halo". With this method, you will have the additional option for "Customer for New Sites". This will be the Halo Customer that any newly created Sites will be made under if not mapped.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjUyZmNjMDIzLWU4NGMtNGQzZi05MjdiLWIwODZmY2UwZTc3YiJ9.s6WLXpzGvdVEyYllzGMR9BHYn70RosF1PbpbO1mpWsI" class="fr-fic fr-fil fr-dib" width="1216" style="width: 1218px; height: 630.457px;" height="630"></p><p><strong><span style="font-size: 10pt;">Fig 5. Site mapping import method</span></strong></p><p><br></p><p>Clicking the "Add" button will allow you to map a Halo Site to an Armis Site.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjkyODA1NGYzLWFlYjgtNDIxNS04NDE0LTZiODExNjc3OGZmYyJ9.XyGZi61A8YGAlgXDtJtIOvR_c3EtMdVr3oJUtZWyQfQ" class="fr-fic fr-fil fr-dib" width="706" height="327"></p><p><strong><span style="font-size: 10pt;">Fig 6. Site mappings popup</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Site Rules</span></strong></p><p>If the Site matching method is set to "Site Rules", you can add criteria for which Asset criteria falls into a Site.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU1M2RkMmU0LWU2OWEtNGEzOC1iMjgxLWIwZjIxMWM4M2NkNiJ9.1naPAt1orI5lr1cq2VJwImO0PEWxIy_cqAdmOxQSqJk" class="fr-fic fr-fil fr-dib" width="1217" style="width: 1219px; height: 630.893px;" height="631"></p><p><strong><span style="font-size: 10pt;">Fig 7. Site rules import method</span></strong></p><p><br></p><p>Clicking the "Add" button will show this popup to map a Halo Site based on criteria. You can choose a field, and whether data that includes or omits certain information falls into that criteria. In this example, any Asset's name that begins with "HAL" will be imported under the Org 1 Customer, Main Site.</p><p><br></p><p><strong><em>Note: Criteria is based on Halo fields, so any fields set here will need to be mapped in the following "Assets" tab.</em></strong></p><p><br></p><p>This method <strong>does not</strong> require the import of Sites after mapping as a result of this behaviour.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE5NjM3MWI2LTVkYWItNGIzOS1hOTI0LWRiYjZhNjIwNGY3OSJ9.1UNMsoEJd-zq92ytVfUKVeQe5qD6sh8QD_l_3E7x4Lg" class="fr-fic fr-fil fr-dib" width="710" height="538"></p><p><strong><span style="font-size: 10pt;">Fig 8. Criteria mappings</span></strong></p><p data-pasted="true"><br></p><p><br></p><p><strong><span style="font-size: 12pt;">General Configuration<br></span></strong></p><p>Both methods then offer additional configuration options.</p><p><br></p><ul><li><strong>Assets will be assigned to this Site if no Site has been matched: </strong>This is the Site that Assets will be imported under if they have not been matched to a Site by either matching method.</li><li><strong>Don't update the asset site for existing or matched assets:</strong> If enabled, any Assets that already exist in Halo will not have their Site changed (if different in Armis).</li></ul><p><br></p><p>Upon saving, and if using the "Import and map sites from Armis to sites in Halo" Site matching method, the "Import Sites" button will show to manually import Sites. This button will be hidden if using the "Site Rules" method.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ5YTVlODI5LTUxMWUtNGQ3Zi04NDBhLTFkN2MyMGQ5MjNjYyJ9.XQaTy44UbqI1dyHtEWijlzuQMLdp-dbmeIp4rXtmMS8" class="fr-fic fr-fil fr-dib" width="1218" style="width: 1220px; height: 529.655px;" height="530"></p><p><strong><span style="font-size: 10pt;">Fig 9. Import Sites button</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Assets </span></strong></p><p>Once Sites have been matched (and imported if using the Site mapping method), you can then import the Assets.</p><p><br></p><p>The first field is the "Asset Matching Field", which will determine how Assets are matched to existing records when updating Assets. This should be an field that is unique per Asset.</p><p><br></p><p><strong><span style="font-size: 12pt;">Asset Field Mappings</span></strong></p><p>You can then set Field Mappings in the table below this. This determines which Halo fields information from Armis is pulled into. If the "Site Rules" matching method was used, ensure every field that is used as criteria is correctly mapped here to match that.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE5YmQwYzQ3LTE3NzAtNDM4OC1iOWIxLTFiMjcwOGY1MTM2OSJ9.McckizV9Ehyz99yw6xpbEBL6uL-eX7ntuynBPga9AvI" class="fr-fic fr-fil fr-dib" width="1214" style="width: 1216px; height: 382.974px;" height="383"></p><p><strong><span style="font-size: 10pt;">Fig 10. Field mappings</span></strong></p><p><br></p><p>Clicking the "Add" button will bring up the below pop to map an Armis Field to a Halo Field. This can be with both system Asset Fields or Custom Fields.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNlNzhiODcxLWYwMzUtNGRlOS05Mjg5LTRhOGQ0ZmIwYzBhZiJ9.seXKx7AAipGCQjEuAP_zcSxWhuESvRX0cflzokZKebc" class="fr-fic fr-fil fr-dib" width="707" height="409"></p><p><strong><span style="font-size: 10pt;">Fig 11. Asset Field mappings</span></strong></p><p><br></p><p>From v2.238+, manual mappings for properties not natively in the Armis field list are supported. To add one of these properties, select the "Manually enter Armis field" in the dropdown. This will show a text field where you can enter the Armis field name. From this version you can also map Armis custom properties by selecting "customProperties" in the dropdown. </p><p><br></p><p><strong><span style="font-size: 12pt;">Filter which Assets are Imported</span></strong></p><p><span style="font-size: 11pt;">If you would not like to import all the assets in your CMDB, you can set filters to control which assets are imported. Filters are set in the "Filters" table. </span></p><p><strong><span style="font-size: 10pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjUxYmQ2NGNiLTQ3NDktNGM2Zi1iMTc1LTcwZmJjMzRiMWM1MyJ9.vIagvtqqUL08V-OQ5bjZweP_xENJEyR6x0iVIV3hEgs" class="fr-fic fr-fil fr-dib" width="1845" style="width: 1847px; height: 636.971px;" height="637"></span></strong></p><p><strong><span style="font-size: 10pt;">Fig 12. Filters table</span></strong></p><p><strong><br></strong></p><p><span style="font-size: 11pt;">When adding a filter simply choose the field in Armis you would like the filter to be based on as well as the filter criteria. </span></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY2NmI1OTlhLTA5YzMtNDg3MS04MWRhLTY1NTI3NDI5OTU1NSJ9.wodMGJITpGhLL_9_RFWWdstWrvPP1gBVGAcNl4KNtv0" class="fr-fic fr-fil fr-dib" width="629" style="width: 631px; height: 437.873px;" height="438"></p><p><strong><span style="font-size: 10pt;">Fig 13. Example Filter</span></strong></p><p><br></p><p><strong>Operator -</strong> Controls whether assets need to meet all the criteria in the filter table, or at least one criteria in the table to be imported.</p><p><strong>Filter Field -</strong> The field that criteria will be based on.</p><p><strong>Filter Type -</strong> Controls whether assets should or should not contain the specified value in order to be imported.</p><p><strong>Filter Value -</strong> The value in the chosen field assets need to/need to not have in order to be imported. </p><p><br></p><p>From v2.238+, "Time Frame" can be used as a Filter field. </p><p><br></p><p><strong><span style="font-size: 12pt;">Determine Asset Types</span></strong></p><p>After completing the Field mappings, you can then set the the Asset Type configuration.</p><p><br></p><ul><li><strong>Default Group for new Asset Types:</strong> Sets the Asset Group newly created Asset Types will be assigned to.</li><li><strong>Determining an Asset's type: </strong>Sets how the Asset Type is determined. <ul style="list-style-type: disc;"><li><p><strong>Use the same type for all Assets:</strong> Assigns all Assets to a set Asset Type.</p></li><li><p><strong>Use a field to determine each Asset's type:</strong> A set Field will be used for determining an Asset's type. If an Asset cannot match via this Field, it will be assigned to a set default Asset Type.</p></li><li><p><strong>Determine Asset Type using rules: </strong>Criteria can be mapped to Asset Types based on values in Halo Fields. If an Asset cannot match via this Field, it will be assigned to a set default Asset Type.</p></li></ul></li><li><strong>Don't update the Asset type for existing or matched Assets:</strong> If enabled, pre-existing Assets will not have their Asset Type updated (if different in Armis).</li></ul><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjVjNzM0NTdiLTY5ODAtNGNhMS1hYzY5LWM4OGJlZTFjYmJiZCJ9.snpnRRevNFi-Y4HYb7y2fKJMmFge7mQwsdlOkG6B9sM" class="fr-fic fr-fil fr-dib" width="779" height="592"></p><p><strong><span style="font-size: 10pt;">Fig 14. Asset Type configuration</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Miscellaneous Asset Import Settings</span></strong></p><p>Finally, we can set the miscellaneous Asset configuration.</p><p><br></p><ul><li id="isPasted"><strong>Don't create new Assets:</strong> If enabled, Assets will not be created, only updated.</li><li><strong>Status of New Assets:</strong> Newly created Assets will be given this Status.</li><li><strong>Deactivate Assets in Halo when they are deleted from Armis (Halo Integrator only): </strong>If Assets are deleted in Armis, they will be made inactive in Halo (via the "Active" checkbox) when syncing via the Halo Integrator.</li><li><strong>Status for Assets when they are deleted from Armis (Halo Integrator only):</strong> If Assets are deleted in Armis, they will be given this Status in Halo when syncing via the Halo Integrator.</li></ul><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjUyMzRlNGZjLTZhMmItNDI2NS04MjY1LTE1YjgwYTI3YzQ2YiJ9.hZFlw0FBeyHBCr6dQxpbGdjsCO0-ueEfzJqz8Ltqmrs" class="fr-fic fr-fil fr-dib" width="750" height="318"></p><p><strong><span style="font-size: 10pt;">Fig 15. Miscellaneous configuration</span></strong></p><p><br></p><p>Save, and the Assets can now be imported. Click the "Import Assets" button at the bottom of the tab.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFhODM3NWI0LWQ3ZjUtNGU0OC04YTE2LTFjZTdhYzkyN2MzMSJ9.KAzHSabV3ne6mUpOcdGP_0rwg8BpS1pL7b1r8_eVZeE" class="fr-fic fr-fil fr-dib" width="1214" style="width: 1216px; height: 624.684px;" height="625"></p><p><strong><span style="font-size: 10pt;">Fig 16. Import Assets button</span></strong></p><p><br></p><p>The Asset below has been imported, created a new "Automations" Asset Type, and assigned the Asset to that Asset Type.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdhNzhkY2QwLWZjZjgtNGRiNC04OTdjLTNhNDJmODJiNjBiNyJ9.HNjIZ48gf5VhkkXVACXTfc2Kr3uTVfvau_FHgvCKRpU" class="fr-fic fr-fil fr-dib" width="1211" style="width: 1213px; height: 404.333px;" height="404"></p><p><strong><span style="font-size: 10pt;">Fig 17. Imported Asset example</span></strong></p><p><br></p><p>The newly created Asset Type has been assigned to the default Asset Group.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZkNDZmMWFiLTU5YzAtNDJiYy1hMDMyLTlhNzQwNGU5YTY1NiJ9.hSomdjX2NMQluWNtGb2jqIbjZYr9w3cLIHJUiVlyGXo" class="fr-fic fr-fil fr-dib" width="1183" height="378"></p><p><strong><span style="font-size: 10pt;">Fig 18. Asset Group on the imported Asset Type</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Syncing</span></strong></p><p>Once Sites and Assets are configured, you can enable the Halo Integrator to automatically sync Devices (Assets) and Sites.</p><p><br></p><p><strong><em>Note: It is recommended to ensure you are happy with the configuration by manually importing before enabling automatic syncs via the Integrator.<br></em></strong></p><p><br></p><p>Check "Enable the Halo Integrator for the Armis integration", and select the entities you wish to automatically sync.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAxZjRkMjYxLWVmZjEtNGUzZS04ZTM0LTc0ODcxZmQzYzNhOCJ9.BKj7fjQK1dsthrkSGi26U47-EhS38UPdFtgPGsk7Dts" class="fr-fic fr-fil fr-dib" width="921" height="404"></p><p><strong><span style="font-size: 10pt;">Fig 19. Halo Integrator configuration</span></strong></p><p><br></p><p><br></p>
