<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 Keeper Integration?</strong></p><p><strong>- Connecting to Keeper</strong></p><p><strong>- Runbook Creation</strong></p><p><strong>- Ticket Creation</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the Keeper Integration?</span></strong></p><p>The Keeper integration allows tickets to be created from Keeper alerts via a Halo runbook. The alerts are set up on your Keeper account, so can be set to trigger with any of their available event types.</p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to Keeper</span></strong></p><p>Within Configuration > Integrations, enable the "Keeper" module by hovering over the module and clicking the "+" icon. This will additionally download the runbook required for this integration onto your instance.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImRiZDVmYzA5LWQ2NzgtNDA3Zi1iNDU0LTMwMDEzYWM3NjU1NyJ9.0vrcnfM0nkP72AJu2cdI--dujoylQAXOKvVwi8YuexE" class="fr-fic fr-fil fr-dib" width="345" height="153"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enabling the Keeper integration.</span></strong></p><p><br></p><p>Once enabled, click into the module. The first section is the "Setup", detailed with instructions on how to configure the Keeper alert.</p><p><br></p><p>Halo has provided a webhook URL to use for the alert, alongside a token to authenticate it. Click the "Generate" button here to create the token, and copy this for later - once you leave this page you will not be able to see the token again without generating a new one.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImUyMmQ5NDZiLTcwNTgtNDVmZS04NzM1LWI3MWUwN2MxYTFlMyJ9.VPOTrVKBiwvDSPzr2mqdAqZ6F6_Qv1GZz1zVCU5RCc0" class="fr-fic fr-fil fr-dib" width="1211" style="width: 1213px; height: 174.047px;" height="174"></p><p><strong><span style="font-size: 10pt;">Fig 2. Credentials for the alert webhook.</span></strong></p><p><br></p><p>Once copied, navigate to your Keeper console > Reporting & Alerts > Alerts tab. Click "Add Alert" to make a new one.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjcwZDM0NzhkLTAxMzYtNGJhMi1iOGQ0LWQxOTlmZjQ0MGJjOCJ9.RLi6UNLy-XE92GZ-wTCP40NA435oQwe2vKGc3hPHWRE" class="fr-fic fr-fil fr-dib" width="1219" style="width: 1221px; height: 576.548px;" height="577"></p><p><strong><span style="font-size: 10pt;">Fig 3. Adding a new alert.</span></strong></p><p><br></p><p>Here you can name your alert, and choose the event types/attributes. The name of the alert will be added into the summary of the ticket in Halo, so give it a logical name you wish to identify these tickets by.</p><p><br></p><p>Now click "Add Recipient".</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQwMGE5MDk4LWNhMTUtNGNiYS04ZTVmLTY4MmNjM2IxMTQ5NiJ9.G03LFbZFZuRvuEVpynFaJnRyxiZnPnpF8kxVglllhNY" class="fr-fic fr-fil fr-dib" width="1222" style="width: 1224px; height: 579.925px;" height="580"></p><p><strong><span style="font-size: 10pt;">Fig 4. Configuring the event type and going to add a recipient.</span></strong></p><p><br></p><p>A popup will show to add another recipient. Complete the name and email fields, and click "Add Webhook" to configure the corresponding alert webhook.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjljM2RjNzgxLWJiMWQtNDI5NC04YjE2LWViMzE5MGE2ZGVkNyJ9.IO7hXbbZOzKaQ8-RablaQB_0tCHCpkoglBbtlSRxRpo" class="fr-fic fr-fil fr-dib" width="451" height="556"></p><p><strong><span style="font-size: 10pt;">Fig 5. Adding a recipient. </span></strong></p><p><br></p><p>Upon clicking, fields will show to enter a URL, HTML body, and a token (scroll down to see the token field). Enter the URL and token from <strong>Fig 2</strong> in the corresponding fields, and leave the HTTP Body field empty.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRlNTY1Y2E5LWQ0NTEtNGY4MC05YjRmLTdiYjU1NDAwNmFhMyJ9.ytFD_WstR7ARHfaQ1W1yMAoeHguDS3qUN5vrVAR5ZfQ" class="fr-fic fr-fil fr-dib" width="437" height="517"></p><p><strong><span style="font-size: 10pt;">Fig 6. Adding the webhook.</span></strong></p><p><br></p><p>Upon saving, the webhook recipient will then be visible in the recipient table. Save to create the alert.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4NTFiOWQ3LTI2MGEtNGM5NC1hMzczLTRhNTY0YmNmMjY4OSJ9.k4JI6jXN_iFfkjs6KU34WXHOj-Vx22jfJf-0TG7dk9A" class="fr-fic fr-fil fr-dib" width="1220" style="width: 1222px; height: 579.584px;" height="580"></p><p><strong><span style="font-size: 10pt;">Fig 7. Alert configuration.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Runbook Creation</span></strong></p><p>When alert webhooks are sent from Keeper, Halo uses a runbook to turn these into tickets. This runbook will be downloaded when the module is enabled in <strong>Fig 1</strong>, and a shortcut to access it can be found in the Keeper module via the button below.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBiZjAwMWYwLTJlNTQtNDE2OS1iZDk5LWFlMjQxYWIwZjc0OSJ9.XeQbJk5jEw8a7e57IBFLr6JgDR7pBKPZpH2KFPJIVLo" class="fr-fic fr-fil fr-dib" width="434" height="89"></p><p><strong><span style="font-size: 10pt;">Fig 8. Shortcut button to view runbook.</span></strong></p><p><br></p><p>The below runbook will show to use for Keeper.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAyZmFiNDdmLWM5M2EtNGMwNC04NTRhLWQ1NzlhY2JkOWExOCJ9.XDItD-Lapgj3nh82ahKX_a1O5NjwsTm8OcohXc2Lcpo" class="fr-fic fr-fil fr-dib" width="320" height="526"></p><p><strong><span style="font-size: 10pt;">Fig 9. Keeper runbook.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Ticket Creation</span></strong></p><p>The Keeper runbook will create a ticket by the following flow.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVhM2YzMmIyLWY1OWMtNGYzYy04NjQ0LTAzZWY2YjZkYzMxMCJ9.8E6JBXHYv7U8jLAorXPEi-cmaW3jOwfL5DeI29uBTdE" class="fr-fic fr-fil fr-dib" width="560" height="492"></p><p><strong><span style="font-size: 10pt;">Fig 10. Keeper runbook flowchart.</span></strong></p><p><br></p><p>When the alert is triggered from Keeper, it will send a webhook to Halo. The runbook above will then create a ticket from it, like the below. The name of the alert will be added to the ticket summary, and the details will be set by the Keeper alert.</p><p><br></p><p>The ticket type configuration will be the default ticket type set in Configuration > Tickets > General > "Default Ticket Type for New Tickets".</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjUzMTFkNmUyLTM4OWQtNDJmMS1iYzFjLWEyMmI0MWYyNDMwOSJ9.le1GQPSKgtqvTel7m0yj932uJmpmHBVryWrL9axZ7Nk" class="fr-fic fr-fil fr-dib" width="967" height="391"></p><p><strong><span style="font-size: 10pt;">Fig 11. Alert ticket.</span></strong></p><p><br></p>
