<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 Self-Service Portal?</strong></p><p><strong>- Changing your URL</strong></p><p><strong>- Adding Branding</strong></p><p><strong>- Customising Menu Buttons</strong></p><p><strong>- Linking the Service Catalogue</strong></p><p><strong>- Giving Users Permissions</strong></p><p><br></p><p><strong>Configuration Settings:</strong></p><ul><li style="font-weight: bold;"><a href="https://usehalo.com/haloitsm/guides/1862" target="_blank" rel="noopener noreferrer" style="font-weight: bold;"><strong>Self Service Portal</strong></a></li></ul><p><br></p><p><strong>Related Guides:</strong></p><ul><li><a href="https://usehalo.com/haloitsm/guides/2524" target="_blank" rel="noopener noreferrer"><strong>Navigating the Self-Service Portal (For End Users)</strong><br></a></li><li><a href="https://usehalo.com/haloitsm/guides/2665" target="_blank" rel="noopener noreferrer"><strong>Start to Finish: Service Requests</strong></a></li></ul><p><br></p><p data-pasted="true"><strong><span style="font-size: 14pt;">What is the Self-Service Portal?</span></strong></p><p>The Self-Service Portal is the portal for your End-Users, and a means of providing them with ways of viewing information, logging tickets or approving processes. The Self-Service Portal is grouped into "Menu Buttons" that can be customised to determine what your Users can do. They can have access restrictions added to ensure the right Users have access to the relevant options.</p><p><br></p><p>This guide will break down the customising your Self-Service Portal from start to finish in four key steps.</p><p><br></p><ul><li style="font-weight: bold;"><a href="https://usehalo.com/haloitsm/guides/1519" target="_blank" rel="noopener noreferrer"><strong>Changing your URL</strong></a></li><li>Adding <a href="https://usehalo.com/haloitsm/guides/1994" target="_blank" rel="noopener noreferrer"><strong>Branding</strong></a></li><li>Customising <a href="https://usehalo.com/haloitsm/guides/1995" target="_blank" rel="noopener noreferrer"><strong>Menu Buttons</strong></a></li><li>Giving <a href="https://usehalo.com/haloitsm/guides/2818" target="_blank" rel="noopener noreferrer"><strong>Users Permissions</strong></a></li></ul><p><br></p><p><em><strong>Note: This guide will only cover the basics of setting up your portal start to finish. For more information on specific settings or more in-depth customisation, please refer to the relevant topic guide.</strong></em></p><p><br></p><p><strong><span style="font-size: 14pt;">Changing your URL</span></strong></p><p>When you first get deployed, your URL will be a subdomain of one of our core product domains, with your Self-Service Portal URL having an additional "/portal" parameter at the end. This can be changed to use your own domain should you wish.</p><p><br></p><p>You will need to add a CNAME record to your DNS listing. This record should point your desired URL to <Your Original Subdomain>-Portal.com. If you wanted to change your Self-Service Portal to <strong>portal.[COMPANY].com</strong>, you would need to add a CNAME pointing <strong>portal.[COMPANY].com</strong> at <strong>[COMPANY]-portal.Halo.com</strong>.</p><p><br></p><p data-pasted="true">An SSL certificate would also need to be provided in order to secure this new address. If you are providing your own SSL certificate, please ensure this is sent to us in .PFX format (along with any password, if applicable).</p><p><br></p><p>We can also generate certificates in-house free of charge. If you would prefer we generated this certificate, please let our Support Team know. Our Infrastructure team would then provide you with an additional CNAME record to add to your DNS listing in order to verify the certificate.</p><p><br></p><p><strong><span style="font-size: 14pt;">Adding Branding</span></strong></p><p>The first step after you have your portal URL is to add your branding.</p><p><br></p><p>Navigate to Configuration > Self Service Portal, where you will find the options to customise the portal appearance and behaviour.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE4MzQyNTg2LTAwNDYtNGU0MC1hNzBlLWViMjFlMzBkNmU4OSJ9.SiZhukHrJ1zdjLeva50ezABh7KRTCeHHXjbazyV-0m0" class="fr-fic fr-fil fr-dib" width="1689" style="width: 1691px; height: 908.574px;" height="909"></p><p><strong><span style="font-size: 10pt;">Fig 1. Branding options for the portal</span></strong></p><p><br></p><p data-pasted="true">Each of these are covered in the Configuration Settings guide linked at the top of this guide, but these are the most important ones to consider.</p><p><br></p><ul><li><strong>Portal Title: </strong>Name of the browser tab.</li><li><strong>Welcome Message: </strong>Message that shows above the search bar/menu buttons</li><li><strong>Portal Colour: </strong>Colour of the navigation bar at the top and the menu button background.</li><li><strong>Portal Logo: </strong>Logo that shows in the top left of the screen.</li><li><strong>Home screen background image URL: </strong>Image that shows in the background of the home page.</li><li><strong>Background image display type: </strong>Determines if the background image set above covers the whole home background or as a banner near to the top.</li><li><a href="https://usehalo.com/haloitsm/guides/2643" target="_blank" rel="noopener noreferrer"><strong>Display custom HTML</strong></a><strong>: </strong>Allows the option to add a custom banner with HTML at the top and/or bottom of the page.</li></ul><p><br></p><p>In this example portal, you can first see the "Portal Logo" in the top left, and underneath this navigation bar is the custom HTML banner. The "Welcome Message" shows above the search bar, and the menu buttons are listed underneath.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZkZWU5M2QyLThhYjYtNDgwMS1hNjNlLWZjYzUwOTRiOTRkNCJ9.t5965G9Gq5ReqNKMMguX3nssiJU9tvLclxSNqnidAzo" class="fr-fic fr-fil fr-dib" width="1695" style="width: 1697px; height: 840.832px;" height="841"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 2. Example customised portal</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Customising Menu Buttons</span></strong></p><p>Now that the portal has your company's branding, the menu buttons can be added to configure what users can do on the portal. if you have built a <a href="https://usehalo.com/haloitsm/guides/2665" target="_blank" rel="noopener noreferrer"><strong>service catalogue</strong></a>, you can also add this as a menu button to allow users to access it.</p><p><br></p><p>Scroll down to the "Menu Buttons" section.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE2YTYyOGFjLTAzMjMtNGRmZS1iOTI3LThjYjc2M2IxYjNlNyJ9.8r0Vn5SrVUdBMVN-3DTIF0uxtZy_ZWmVaVrAUCrBQw4" class="fr-fic fr-fil fr-dib" width="1692" style="width: 1694px; height: 911.677px;" height="912"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 3. List of menu buttons</span></strong></p><p><br></p><p>You can use the pencil icon to edit an existing one, the trash can to delete it, or add a new one with the "Add" button at the bottom of the list.</p><p><br></p><p data-pasted="true">The order of buttons can be edited by hovering over the button, then drag-and-drop with the dots that appear on the left side.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjkyYTJhOTRlLTY3MWYtNDRlMC04ZDQyLTAxYWNjYzAyOGE3MSJ9.-MxqCoxLMgbyOr8jOaRLh7KVpaQtkeG7Bh0-s4MR_C4" class="fr-fic fr-fil fr-dib" width="1693" style="width: 1695px; height: 243.051px;" height="243"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 4. Moving menu buttons around</span></strong></p><p><br></p><p>When editing a button or adding a new one, you can customise how the button appears - such as the icon shown, or the name/description of the button.</p><p><br></p><ul><li><strong>Name: </strong>Name/title of the menu button.</li><li><strong>Hint:</strong> Description that appears under the name.</li><li><strong>Icon:</strong> Icon logo that appears on the menu button. </li><li data-pasted="true"><strong>Show on home screen: </strong>Shows as an option on the home screen 'boxes', with the above customisation visible.</li><li><strong>Show on navigation bar:</strong> Shows as an option in the navigation bar at the top of the page, with only the name visible.</li></ul><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAxYjg5MWEyLTVjMTYtNDAzNC1iMmNmLTE2YmNiNTM5MGIyNCJ9.lq72nf2STNUqhiEML2vNjhLew-tTQBi_B7R-sA0yr3o" class="fr-fic fr-fil fr-dib" width="713" height="1158"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 5. Customising the menu button appearance</span></strong></p><p><br></p><p>Scrolling down on this popup will show the option to add visibility restrictions. Menu buttons can be shown or hidden based on attributes of the logged in user, such as a user role.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAyMTM0YTE4LTM0MDMtNDY5Yi05NDIzLWYzNzdkOTViY2NhNSJ9.40ouCg5-GO2irxSOgHblq9U08WcZZvMmyZpz95sxRL4" class="fr-fic fr-fil fr-dib" width="721" height="1159"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 6. Adding visibility restrictions to the menu button</span></strong></p><p><br></p><p>Repeat this process for anything you wish users to be able to access on the portal.</p><p><br></p><p><strong><span style="font-size: 14pt;">Giving Users Permissions</span></strong></p><p data-pasted="true">Permissions can be given to individual users via their user profile, or applied via a user role.</p><p><br></p><p data-pasted="true">User Roles are roles that can set permissions and various settings against the user the role is assigned to. They can also be used to restrict or grant access across various parts of the system, such as the menu buttons mentioned above.</p><p><br></p><p data-pasted="true">To create a user role, head to Configuration > Users > User Roles and click the “New” button.</p><p><br></p><p>The first tab you will see is to set the basic details of the user role, like the name. You can set notes to show what the user role is for if desired.</p><p><br></p><p><span style="font-size: 11pt;"><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEzNDIyNjg2LTEzMjctNDVmNC1hODAyLTA3MGNiMDgwNTNjOSJ9.Nn8EK6SKEnzYeRy6s0nY4A1owGBx_GxB6vUYjn3utZo" width="906" height="613" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; width: 908px; height: 613.058px; max-width: none !important;" data-pasted="true" class="fr-fil fr-dib"></span></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 7. Creating a new user role</span></strong></p><p><br></p><p data-pasted="true">To set any further configuration for the user role, you must save the role first, then edit. This will then show the options to set the permissions and departments that role is associated with.</p><p><br></p><p>Switch to the “Permissions” tab first.</p><p><br></p><p>Here you will see the same permissions that are available on a user’s profile, so that they can be set through this user role. This works the same way as agent roles.</p><p><br></p><p>A description of each permission can be found in the “User Roles” configuration setting guide, linked at the top of this page.</p><p><br></p><p>When applying the role to a user, the highest level of permission will take precedent. For example looking at the "Web Access Level", if the role is set to "This Users Tickets", but that user already has access to "Site Tickets", the user will keep "Site Tickets".</p><p><br></p><p><strong><em>Note: For the user to be able to access the portal, "Web Access Level" must be set to a minimum of "This Users Tickets". "No Access" will stop them from being able to login to the portal.</em></strong></p><p><br></p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNiMjU2NjllLWI5NzUtNGU5YS1hZjNlLWViYjQyOTJhNDVlNCJ9.qozXjUiO3PFWJHNMkebvbPKPBQ5j0qq931dD4f_IS1E" width="898" height="616" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; width: 900px; height: 616.065px; max-width: none !important;" data-pasted="true" class="fr-fil fr-dib"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 8. Adding permissions to the user role</span></strong></p><p><br></p><p data-pasted="true">Now that the role has been created, it can be assigned to users.</p><p><br></p><p>The first place this can be done is within the role configuration itself. In the “Details” tab, users can be added to the “Users that have this Role” field to give them access.</p><p><br></p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFjMGIyZTRjLTNmZGItNGI5Zi05MWZhLTdkYmZiOTUzZGFjYyJ9.5-HbtlDSvxUhb4atK2ssvQVSpU3f57U-m83AikJru5Y" width="906" height="620" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; width: 908px; height: 619.595px; max-width: none !important;" data-pasted="true" class="fr-fil fr-dib"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 9. Adding users to the role via configuration</span></strong></p><p><br></p><p data-pasted="true">You can also bulk add users from a list, such as within a client profile. Click the check mark at the top to select all records, or choose only some from the list. Hover over the “Edit” button and select “Add Roles”.</p><p><br></p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijk3ZWExNTQ5LThkZWItNDc2Yi1iODBlLWQzYjVkNDJjZjE3NyJ9.EHWsUZmLBldcyRB9hSk2mlUTJwnYX8XgFzfbpSLxBzc" width="904" height="615" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; width: 906px; height: 614.673px; max-width: none !important;" data-pasted="true" class="fr-fil fr-dib"></p><p data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 10. Adding users to the role via a list</span></strong></p><p><br></p><p data-pasted="true">You’ll see a pop up to select one or more roles, and a checkbox to determine if these will be added additionally, or replace any existing roles.</p><p><br></p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImZhN2ZmNzVmLTExMzctNDcxMC05MDFjLTdjNmE4OTEyODY1MyJ9.91pO0r9ZVhL_W8YeClsGqLA7eKKlTKVT6HLxESC0syY" width="673" height="285" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; width: 675px; height: 284.775px; max-width: none !important;" data-pasted="true" class="fr-fil fr-dib"></p><p data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 11. Choosing the roles</span></strong></p><p><br></p><p data-pasted="true">A default user role can be set in Configuration > Users > General Settings. Any newly created users after choosing an option here will be given that role. Pre-existing users will not be given this automatically.</p><p><br></p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijk5ZWFhZTQzLWU4Y2QtNDFhZC1hNjhkLWJjOTFkNjkxOWRhZCJ9.as987gB9HHSkAphKlNJML1T8D1SLHsh4YnR_j1O6Dko" width="901" height="448" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; width: 903px; height: 447.807px; max-width: none !important;" data-pasted="true" class="fr-fil fr-dib"></p><p data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 12. Adding users to the role via defaults</span></strong></p><p><br></p><p data-pasted="true">User roles can also be assigned by identity management integrations, and can be filtered to give certain users, certain roles. For example, the Google Workspace integration can map a Workspace group to a Halo user role.</p><p><br></p><p><strong><em>Note: Roles given by identity management integrations will override manual selections.</em></strong></p><p><br></p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNiNGVjYzgyLTNhMDMtNGRmNC1hNTM2LTEzYmY5YjI4YWE2NiJ9.ee4zbnOxS4karp4hY3AOOvRaXcRCOM5A2rw3Ag5OM6Y" width="907" height="619" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; width: 909px; height: 618.837px; max-width: none !important;" data-pasted="true" class="fr-fil fr-dib"></p><p data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 13. Adding users to the role via an integration</span></strong></p><p><br></p>
