<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 Webhook and Integration Runbook Access Control? </strong></p><p><strong>-Giving Access Control </strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is Webhook and Integration Runbook Access Control? </span></strong></p><p>Access control can be set against integration runbooks and webhooks to allow certain agents configuration access to selected webhooks and runbooks. This allows you to grant configuration access to chosen runbooks and webhooks to an agent without giving this agent administrator access. Useful for agents who are involved in automation and system integrations, but are not involved in configuring other areas of Halo.</p><p><br></p><p>When agents are given access control they will be able to view and edit the runbook/webhook they are given access to, but they will not be able to create new runbooks and webhooks. Only administrators will be able to create new webhooks and runbooks. </p><p><br></p><p><strong><span style="font-size: 14pt;">Giving Access Control </span></strong></p><p>The agent who created the webhook/runbook can give other agent access control to the webhook/runbook. This is done using the 'Access Control' button, shown in figure 1. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNhMjg4M2RhLTE2NWQtNGM4NS05OGFlLWJhYjRiYzc0OWUwYSJ9.k4O8EJwIULoQ8v2K3YxJpot67X-eWdmBP7zxZbjSCmA" class="fr-fic fr-fil fr-dib" width="800" style="width: 802px; height: 520.239px;" height="520"></p><p><strong><span style="font-size: 10pt;">Fig 1. Access control button against a runbook</span></strong></p><p><br></p><p>When selected you will be presented with the pop-up shown in figure 2. Here, you will need to choose the entity to give access based on, such as a role, department, agent. Then choose which role, agent, team or department should have access control to the runbook/webhook and the access level they have. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjU0YzhjNWNkLTIwOGYtNDI4OC05ZmFjLTdiMDllMzAyMWVmZCJ9.uAAotlP7ATNhfrdfcsfk4-v0zgsBqPtR8ER5EgQjxDo" class="fr-fic fr-fil fr-dib" width="550" style="width: 552px; height: 305.301px;" height="305"></p><p><strong><span style="font-size: 10pt;">Fig 2. Setting access control example</span></strong></p><p><br></p><p>In the figure 3 example only the agent 'Amir Said' will be able to read and modify this runbook. </p><p><br></p><p>Access control is given per runbook and webhook, so each time a runbook and webhook is created the owner will need to set which agent have access to the runbook/webhook. </p><p><br></p><p>Access level options:</p><p><strong>None (Remove)</strong> - When chosen this will remove the access control the entity currently has. </p><p><strong>Read and modify</strong> - Everyone within this entity will be able to view and edit the runbook/webhook. </p><p><strong>Owner </strong>- Everyone within this entity will be able to view and edit the runbook/webhook. Owners will also be able to give access control to others. </p><p><br></p><p>When access control is given to an agent they will be able to access runbooks by navigating to configuration > integrations > webhooks > toggle between viewing webhooks and runbooks using the toggle in the top left of the page. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI1NzNhYTk2LTE3NDMtNDMwOS04Yjc0LWFmM2Y4MGVjMTE3MSJ9.jSn1lX756bLNT1dHIX-2HR9RvtjlV9Satd14BQYHUL4" class="fr-fic fr-fil fr-dib" width="463" height="292"></p><p><strong><span style="font-size: 10pt;">Fig 3. Toggle view between webhooks and runbooks</span></strong></p>
