<style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; }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><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 data-pasted="true"><strong>- Allow All Users to view Articles on an FAQ list</strong></p><p><strong>- Allow Access to FAQ lists based on the User's Customer or Role</strong></p><p><strong>- Allow Access to FAQ Lists Based on Site and Organisation</strong></p><p><strong>- Allow Access to FAQ Lists based on the User's Geo Location</strong></p><p><strong>- Grant Access to Individual Articles </strong></p><p><strong>- Make an Article available at a specific Link - Permalinks</strong></p><p><br></p><p><br></p><p>Knowledge base articles can be made available to your users in the End User Portal. Allowing users to access content/information you have created to assist them. Access/restrictions can be setup to control exactly which articles users can view in your portal. This is useful if only selected users should have access to certain articles, for example you may only want managers and HR staff to have access to an article outlining how to raise a new starter request but have this article hidden for other users. </p><p><br></p><p>In this guide we will cover the different methods in which access to knowledge base articles can be restricted, this assumes you have already setup the knowledge base in your portal. </p><p><br></p><p>For information on how to setup the knowledge base in your portal, see our guide <a href="https://www.usehalo.com/guides/2486" target="_blank" rel="noopener noreferrer">here</a>. </p><p><br></p><p><strong><span style="font-size: 14pt;">Allow All Users to view Articles on an FAQ list</span></strong></p><p data-pasted="true">Articles are organised using FAQ lists. FAQ lists can be configured to allow all users to view all the articles in this list, useful for articles that should be available to all users. For information on setting up FAQ lists see our guide <a href="https://usehalo.com/haloitsm/guides/2043/" target="_blank" rel="noopener noreferrer">here</a>. </p><p><br></p><p>Keep in mind some restrictions still apply even when an FAQ list is set to show for all users. The following restrictions are still considered:</p><ul><li>Geolocation restrictions on a specific Article</li><li>Geolocation on an FAQ List</li><li>Organisation/Portal Restrictions</li></ul><p>Configuring these restrictions will be covered later in this guide. </p><p><br></p><p>To grant all users access to articles on an FAQ list head to Configuration > Knowledge Base > Configure FAQ lists > select a list > enable "Show for all Users".</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImIzMDZjY2Y3LWY0MDktNGIwZC1hN2Q0LWYxZWJmYTA3ZmRhYSJ9.A1iY8aPbMBMjsltcCshr1PEU0_fovFTeE5AiTeKp3O8" class="fr-fic fr-fil fr-dib" width="1647" style="width: 1649px; height: 890.229px;" height="890"></p><p><strong><span style="font-size: 10pt;">Fig 1. Show an FAQ List for all Users</span></strong></p><p><br></p><p>When enabled, all users will be able to access articles on this FAQ list in the portal. </p><p><br></p><p><strong><span style="font-size: 14pt;">Allow Access to FAQ lists based on the User's Customer or Role</span></strong></p><p>Articles are organised using FAQ lists. Access can be granted to the FAQ list based on the customer a user belongs to or the role that user has. Granting this access will allow the user to see all the articles in this FAQ list. For information on setting up FAQ lists see our guide <a href="https://usehalo.com/haloitsm/guides/2043/" target="_blank" rel="noopener noreferrer">here</a>. </p><p><br></p><p>To grant users access to articles on an FAQ list head to Configuration > Knowledge Base > Configure FAQ lists > select a list > ensure "Show for all Users" is disabled > use the settings shown in Figure 2 to grant access based on a user's customer or role. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM2Njg2MjNhLWM1NTUtNGQ1ZC1hZmFkLTMyYmRhMmM3YTliNiJ9.MHTFT09rfnGsq7d6KiLay0TWnRpKAZhVpwsVLP9WGZ8" class="fr-fic fr-fil fr-dib" width="1556" style="width: 1558px; height: 886.021px;" height="886"></p><p><strong><span style="font-size: 10pt;">Fig 2. Options to allow access to the FAQ list based on customer and user role</span></strong></p><p><br></p><p>Here, simply select the customers and/or user roles you would like to have access to this list. Only users under the selected customers or chosen roles will be able to access this list. </p><p><br></p><p data-pasted="true">These two fields "Customers that can view this FAQ list" and "User Roles that can view this FAQ List" have an OR relationship, this means users only need to have one of the selected roles OR be under one of the chosen customers to view the FAQ list. If "Show for all Users" is disabled but no customers/roles are set here no users will be able to see this FAQ list. </p><p><br></p><p data-pasted="true">The field "Customers that can view this FAQ list" will populate the field "FAQ Lists that this Customer can view" found against each customer (Customers > select a customer > Settings tab > Knowledge Base section), and vice versa. This allows you to set the FAQ lists a customer can access both against the FAQ list and against the customer. Useful for account manager agents who have access to edit their clients but not FAQ lists, as this allows them to change their client's allowed FAQ lists without needing permission to edit FAQ lists. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijk5NWQwYWNhLTc3MDgtNDU0MS04YTljLWY2MjMzNmViMmUxYiJ9.L0mGAnsEXoW4qy-0lDc-8VEkwIICbQYo0J9g0QP3WZQ" class="fr-fic fr-fil fr-dib" width="1481" style="width: 1483px; height: 995.361px;" height="995"></p><p><strong><span style="font-size: 10pt;">Fig 3. FAQ Lists that this Customer can view</span></strong></p><p><br></p><p>If an article is on multiple FAQ lists, some of which a user does not have access to, the user will be able to view th<span style="color: rgb(0, 0, 0);">e article provided they have access to one of the lists the article is on. </span></p><p><br></p><p><span style="color: rgb(0, 0, 0);"><strong><span style="font-size: 12pt;">View the Articles a Customer has access to </span></strong></span></p><p><span style="color: rgb(0, 0, 0);">To help you manage a customer's article access you can view all the articles they have access to against their customer profile. This can be found under the "Knowledge Base" tab of the customer. </span></p><p><span style="color: rgb(0, 0, 0);"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImMzNzhhNGE0LTA0MWItNGNiNC1iNmNlLTlhNWU2ZTBiZWY0OSJ9.wICQjM1KHeP_BowVx0ybA67Ej81bv1MAAmDIIwltWCs" class="fr-fic fr-fil fr-dib" width="1059" style="width: 1061px; height: 390.983px;" height="391"></span></p><p><strong><span style="font-size: 10pt;">Fig 4. Articles a customer can access</span></strong></p><p><br></p><p>You cannot change the articles a customer can access from here, but this provides an easy way to see their access. </p><p><br></p><p><br></p><p><strong><span style="font-size: 12pt;">Allow Access to FAQ List Groups</span></strong></p><p>FAQ lists can be organised into 'sub lists' using FAQ Groups (a group is just an FAQ list that is marked as a group). The same access options are available to grant on a group as on FAQ lists. When user access is granted on an FAQ group the user will only be granted access to articles assigned directly to this group. </p><p><br></p><p>This means FAQ list access is not inherited from the group an FAQ list belongs to. Access must be granted to each FAQ list individually. This allows for more granular control, you can still use groups to organise FAQ lists and articles, without access being inherited. </p><p><br></p><p>For example, the customer Acorn Construction is allowed access to an FAQ group. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJiNGY1YWVlLWQyMTktNDZkNC04NGMwLTViNWFiODcwMjg0NSJ9.22eeDX2ZnRja9H6Z-ttIpwhCe9dVfiEUhrnYESfTXt0" class="fr-fic fr-fil fr-dib" width="1031" style="width: 1033px; height: 912.598px;" height="913"></p><p><strong><span style="font-size: 10pt;">Fig 5. Customer access granted to FAQ group</span></strong></p><p><br></p><p>An FAQ list is assigned to this group which acorn construction does not have access to. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjUxODgzYmIxLTIxOWItNGU1Mi04MDEwLWI1Y2MxMmI5OTE1MyJ9.ZAh1DWaGUfq2KfWTN8fGRi_T_29xlDQ3qrwkppYNVe4" class="fr-fic fr-fil fr-dib" width="1012" style="width: 1014px; height: 818.193px;" height="818"></p><p><strong><span style="font-size: 10pt;">Fig 6. FAQ list assigned to a group </span></strong></p><p><br></p><p>Using the Figure 5 example, users under Acorn Construction will have access to "User article 1" as this is assigned directly to the FAQ group. They will not have access to "User article 2" as this is assigned to an FAQ list which they do not have access to. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijk4NWQxOTQwLTkxMTMtNGI5Yy04ZTBkLTc1OWNlOWMzNDFlNSJ9.l27aFPOZap0nam3A8vUIQ1PQQKSoI5dc7ZWsGrdgZtE" class="fr-fic fr-fil fr-dib" width="990" style="width: 992px; height: 542.762px;" height="543"></p><p><strong><span style="font-size: 10pt;">Fig 7. Articles and FAQ lists under the "FAQ Group" group</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Allow Access to FAQ Lists Based on Site and Organisation</span></strong></p><p><strong><span style="font-size: 12pt;">Grant Access based on Site</span></strong></p><p>Access can be granted to an FAQ list based on the site a user belongs. Useful when you would only like users at particular sites to have access to a set of articles, for example when you have troubleshooting articles that are specific to a particular office location. </p><p><br></p><p>By default, all sites are set to inherit the FAQ list access from the client they belong to, so this will need to be disabled for any sites if you would like to have different access from their client. </p><p><br></p><p>To set a site's access to a FAQ list head to Clients > sites > select a site > settings tab > knowledge base section > disable "All FAQ lists available at Client level will be available at this Site" > use the setting shown in Figure 8 to choose which FAQ list users at this site can access. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAyZmI2ZWU0LTY0MTctNDdmZC05ZGE2LWJiZGE5MTNiYjdlZSJ9.U0veAczgXBhsgmWCLCyzh_PWSVHWDSTwi4ntyxTh7PY" class="fr-fic fr-fil fr-dib" width="1533" style="width: 1535px; height: 908.891px;" height="909"></p><p><strong><span style="font-size: 10pt;">Fig 8. FAQ Lists that users at this site can view </span></strong></p><p><br></p><p>In order for users at this site to be able to view articles under this FAQ list the client the site is under will also need access to this FAQ list. To prevent other sites at the same client from accessing this FAQ list, ensure "All FAQ lists available at Client level will be available at this Site" is disabled for each site and the desired articles are selected. </p><p><br></p><p><strong><span style="font-size: 12pt;">Grant Access Based on Organisation/Portal</span></strong></p><p>This method of article restriction is only applicable for those:</p><ul><li>Using <a href="https://usehalo.com/haloitsm/guides/2330" target="_blank" rel="noopener noreferrer">Multi Tenancy</a> in their Halo instance</li></ul><p style="margin-left: 140px;">AND</p><ul><li>With <a href="https://usehalo.com/haloitsm/guides/2331/" target="_blank" rel="noopener noreferrer">Multiple End User Portals</a></li></ul><p><br></p><p>If you have multiple end user portals (typically for different organisations) you can restrict which FAQ lists users see based on the portal they are logged in to. Useful when you have separate articles for each of your organisations and have separate portals for each organisation. </p><p><br></p><p>Before these restrictions can be implemented you will need to first have multiple end user portals deployed and have assigned each organisation's branding to the portal accordingly. Information on how to do this can be found in our guide <a href="https://usehalo.com/haloitsm/guides/2331/" target="_blank" rel="noopener noreferrer">here</a>. </p><p><br></p><p>To allow organisation based restrictions to articles this must be enabled. Head to Configuration > Knowledge Base > enable "Enable the ability to restrict FAQ lists for Users on a Self Service Portal for different Organisations". </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY1ZjJlZTBiLTZjMjAtNDdlMi05MThlLTY3OGI2OGMyMDE0OCJ9.jinhngq-J-73Q_vs9eYDatICxYvsJpSfPPaqHb9Xu4s" class="fr-fic fr-fil fr-dib" width="1767" style="width: 1769px; height: 351.156px;" height="351"></p><p><strong><span style="font-size: 10pt;">Fig 9. Enable the ability to restrict FAQ lists for Users on a Self Service Portal for different Organisations</span></strong></p><p><br></p><p>Now you can set which FAQ lists users can access per organisation. Head to Configuration > Organisations > Configure Organisations > Settings tab > disable "Users can see all available FAQ Lists". Then you will be able to use the setting shown in Figure 10 to choose which FAQ lists show in this organisation's portal.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI2MjhkNjFmLWRiMTktNGExNi04YzUzLTkzNTMzMDg1MjU5ZiJ9.gwBsalmOEvHxtirCZf8TczoXMC8N2u9JhDew2lV9V5w" class="fr-fic fr-fil fr-dib" width="1663" style="width: 1665px; height: 807.203px;" height="807"></p><p><strong><span style="font-size: 10pt;">Fig 10. FAQ lists that Users can see</span></strong></p><p><br></p><p><strong><em>Note: These restrictions can be overridden for selected FAQ lists by enabling "Show for everyone" on the FAQ list. Useful for FAQ lists used by all users.<br></em></strong></p><p><br></p><p>Now, users who log into a portal which users this organisation's branding will only see articles on the FAQ lists chosen here (as well as FAQ lists that are set to show for all users). </p><p><br></p><p>If restricting which FAQ lists a user can access based on the organisation of the portal they are logging in to, other restrictions are also considered. For example if customer/site restrictions are in place the user must be under a customer and site that has also has access to the organisation's allowed FAQ lists.</p><p><br></p><p><strong><span style="font-size: 12pt;">Use Only Site and Organisation Restrictions - Easing the application of Site Level Access </span></strong></p><p>If you would like to have customer restrictions ignored, so only organisation and site restrictions are considered this can be toggled per FAQ list. This is useful when only one (or few) sites under a customer should have access to an FAQ list. This can make access configuration easier when only a handful of site should have access to an FAQ as rather than having to allow the FAQ list for the client, then remove it from each site, you can simply add the FAQ list to the allowed lists for the site. </p><p><br></p><p>This can also be useful when you would like articles on an FAQ list to be available to all users while still keeping organisation and site level restrictions in place.</p><p><br></p><p>To do this head to Configuration > Knowledge Base > Configure FAQ Lists > select an FAQ list > enable "Show for all Users without considering Customer permissions". </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEwMWE3NjMzLTY2YmItNDI0OS1iM2M5LTVjZmE1MmNjNDRiNCJ9.kNhJ3sgh0u00p0BOhfbRGqO20XGWg1HPs00KdSw3TKs" class="fr-fic fr-fil fr-dib" width="971" style="width: 973px; height: 759.121px;" height="759"></p><p><strong><span style="font-size: 10pt;">Fig 11. Show for all Users without considering Customer permissions</span></strong></p><p><br></p><p>When this is enabled, all users will be able to see articles on this FAQ list provided the site they belong to has access, and the organisation of the portal they are logging in to has access. </p><p><br></p><p><strong><span style="font-size: 14pt;">Allow Access to FAQ Lists based on the User's Geo Location</span></strong></p><p>Access to articles on an FAQ list can be granted based on the geographical location of the user. User's geographical location is checked using their IP address. </p><p><br></p><p>This functionality will first need to be enabled in Configuration > Knowledge Base > "Use Geo Location Restrictions for FAQ Lists".</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU5ZmZkMjQ1LTIxYWEtNGJhZi05OWM0LWM4MTA3OWViZWUyYSJ9.TKUxVb41RqGNVaTzgh_vQX6aiYgbmRQyHsycIOn-QqI" class="fr-fic fr-fil fr-dib" width="1353" style="width: 1355px; height: 537.712px;" height="538"><strong><span style="font-size: 10pt;">Fig 12. Enable Geo Location Restrictions to be used for FAQ Lists</span></strong></p><p><br></p><p data-pasted="true">Keep in mind when enabled, performance around knowledge base articles may be impacted. </p><p><br></p><p><strong><em>Note: This setting for "Use Geo Location Restrictions for FAQ Lists" can also be found on the self service portal configuration page.</em></strong></p><p><br></p><p>Once enabled an additional table will appear against FAQ lists called 'Geo Location Restrictions'. Here you can add entries to restrict who can see the article based on the country or continent they are in. Restrictions can either be set so that only users in this location can view the article, or all users except this location can view the article. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFjMzAwNjUwLWU2MTItNDgzNy1hN2Q4LWZiMDQzNDMyNWM2OCJ9.y1aFKdYeclmWue6zsZDDKv9br25q4kHbDMew-Ymfjss" class="fr-fic fr-fil fr-dib" width="1650" style="width: 1652px; height: 939.508px;" height="940"></p><p><strong><span style="font-size: 10pt;">Fig 13. Geo Location Restrictions on an FAQ List </span></strong></p><p><em><strong><br></strong></em></p><p><span style="color: rgb(0, 0, 0);"><em><strong>Note: Even if the FAQ list is set to 'show for all users' geo restrictions are still conside</strong></em><em><strong>red. </strong></em></span></p><p><br></p><p data-pasted="true">Any access that has been granted on an FAQ list will override article access. That is, if users in a country have been given access to an FAQ list but have been excluded from seeing an article in this list, they will still be able to see the article. The highest level of access will always be taken. </p><p><br></p><p><strong><span style="font-size: 14pt;">Grant Access to Individual Articles </span></strong></p><p>Users can be granted access to individual articles based on their:</p><ul><li>Customer</li><li>Top Level</li><li>Geo Location</li></ul><p><br></p><p>If users are granted access to individual articles they will not need access to the FAQ list the article is on to be able to see it. It is important to note, if the FAQ List that the article is under has the setting "Show for all Users" selected, then customer and top level set on the article will not apply as they will be overridden by the FAQ list setting. To have the restrictions apply the FAQ list must not show for all users, then access can be granted against each article. Geo location restrictions will still apply. </p><p><br></p><p><strong><span style="font-size: 12pt;">Grant Access based on Customer and Top Level </span></strong></p><p data-pasted="true">To give particular customers access to the article add them to the 'Allowed Customers' table against the article, only the customers in this table will be able to see the article in the portal. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU1YzVhMTQyLTBjOGYtNDRjYy05OGVlLWEyMmI2MDMyYWNlZSJ9.pdh_C3EWlAty5LGTR6DYjz0kY9xtQXv9KLPHzhlU5NU" class="fr-fic fr-fil fr-dib" width="1671" style="width: 1673px; height: 748.899px;" height="749"></p><p><strong><span style="font-size: 10pt;">Fig 14. Give particular customers access to an article </span></strong></p><p><br></p><p>To give customer under a particular top level access to the article add them to the 'Top Level' table against the article.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImUxNWU5ZGUyLTI2NjgtNDhhNS1hY2IyLWZhODQwNWZjZGEyYiJ9.mPH_AKW2YkS6WLolRxlBXUUneln_KzoTXN9ROIzvIQI" class="fr-fic fr-fil fr-dib" width="1295" style="width: 1297px; height: 576.126px;" height="576"></p><p><strong><span style="font-size: 10pt;">Fig 15. Give customers under a particular top level access to an article</span></strong></p><p><br></p><p>Only the customers chosen here/under the top level chosen here will be able to access the article. </p><p><br></p><p><strong><span style="font-size: 12pt;">Grant Access based on Geo Location </span></strong></p><p>Access to articles can be granted based on a user's geo location (using their IP address) to only allow users at particular locations to view an article. This can be useful when you have location specific articles and would only like users at that location to view it. </p><p><br></p><p data-pasted="true">This functionality will first need to be enabled in Configuration > Knowledge Base > "Use Geo Location Restrictions for Knowledge Base Articles".</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRhZmYxMGFkLWJhODUtNGRmMC1hNTYzLTE5N2JiNjYwZDZmMCJ9.FY_dcZYpYjmA7gz22SsnPEU-2uMnjeiNxWUqFrC3i1Q" class="fr-fic fr-fil fr-dib" width="716" style="width: 718px; height: 575.553px;" height="576"></p><p><strong><span style="font-size: 10pt;">Fig 16. Enable Geo Location Restrictions for articles</span></strong></p><p><br></p><p data-pasted="true">Keep in mind when enabled, performance around knowledge base articles may be impacted. </p><p><br></p><p><strong><em>Note: This setting for "Use Geo Location Restrictions for FAQ Lists" can also be found on the self service portal configuration page.</em></strong></p><p><br></p><p data-pasted="true">Once enabled an additional table will appear against articles called 'Geo Location Restrictions'. Here you can add entries to restrict who can see the article based on the country or continent they are in. Restrictions can either be set so that only users in this location can view the article, or all users except this location can view the article. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdmZjU3MThiLTUxZTUtNDkzOC1hYTA2LTM1Y2FhMzE0NTQ1ZSJ9.YxKdd6zr6lB6h27gxq278vwUnmqvrPeE5OMcgv62Asg" class="fr-fic fr-fil fr-dib" width="1453" style="width: 1455px; height: 620.715px;" height="621"></p><p><strong><span style="font-size: 10pt;">Fig 17. Geo Location Restrictions against article</span></strong></p><p><br></p><p data-pasted="true"><strong>Exclude setting -</strong> When checked, all users can see this article, except users in the country/continent selected. When unchecked only the users at this country/continent will be able to see this article. </p><p><br></p><p data-pasted="true">In the Figure 18example all users except those in France will be able to see this article.<br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ1MmYyY2M0LTczNTEtNDA2ZS1iN2JhLTIwNmYwY2NlZDA0NiJ9.CmqhtZBCdcQV7NQHv1U6OZ9e1HZn5ApfvdZo9wu4XtI" class="fr-fic fr-fil fr-dib" width="607" style="width: 609px; height: 404.525px;" height="405"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 18. Restricting Geo Location example</span></strong></p><p><br></p><p>It is important to note, if you set restrictions that overlap, that is you give users at a particular continent access to this article, but exclude a country under this continent, the highest level of access will be granted. So all users under the continent would have access even if they country they are in has been excluded. </p><p><br></p><p><strong><span style="font-size: 14pt;">Make an Article available at a specific Link - Permalinks</span></strong></p><p>Articles can be published to create a permalink for that article. Permalinks can be used to make an article accessible at a specific link. Multiple links can be generated per article. </p><p><br></p><p data-pasted="true">To enable this head to Configuration > Knowledge Base > enable the setting shown in Figure 19.<br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVkMWJmOGZkLTMzMjQtNDA4Mi1hMDE5LTRmYjJiNmQyZGE2YSJ9.0xqJsb5wh1E9QS0pACgELuSaDcwTjS4F_5GJgjkkUcE" class="fr-fic fr-fil fr-dib" width="1091" style="width: 1093px; height: 546.935px;" height="547"></p><p><strong><span style="font-size: 10pt;">Fig 19. Enable Knowledge Base Article Publishing </span></strong></p><p><br></p><p>Now, against each article you will have an option to "Create" Permalink". </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImViYzczMGNjLTk1YzgtNGNiMy1hYjI3LWIxOWI1OTU4NWI3OSJ9.P0gDUVudTXiUvSLSAsK6NvIScMZdQZO-Sq9D3nG0LUw" class="fr-fic fr-fil fr-dib" width="1255" style="width: 1257px; height: 821.831px;" height="822"></p><p><strong><span style="font-size: 10pt;">Fig 20. Create Permalink for an article </span></strong></p><p><br></p><p>When creating you will need to choose the type of permalink to create. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImZhOTczMmEwLWI2MjItNGQ0Ny1iYTMyLTAzZDk0NDRhY2NiNCJ9.ADucxshF-vqdUlgWu7q7rV19qCw8f-6KC7JrnjaOOa4" class="fr-fic fr-fil fr-dib" width="629" style="width: 631px; height: 276.786px;" height="277"></p><p><strong><span style="font-size: 10pt;">Fig 21. Type of permalink </span></strong></p><p><br></p><p><strong>Autogenerate a permalink -</strong> A permalink will be generated for you.</p><p><strong>Create a custom path -</strong> Choose this if you would like to choose a path to be appended to the URL used to access your knowledge base in the portal. Useful when you would like a link that is easy to remember. </p><p><br></p><p>Once a permalink type is chosen, a link will be created after a few seconds and a prompt will show on screen to confirm the link has been created. </p><p><br></p><p>The link will be visible upon saving the article. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg5MzRiNzU2LTdlM2QtNDY4OS05ZGE3LWVjNzM2MDhkMTUyMSJ9.ouGN7fxMlhlEa8dYJWuan2c7HpNv62Emwiyy5yShas8" class="fr-fic fr-fil fr-dib" width="1484" style="width: 1486px; height: 851.22px;" height="851"></p><p><strong><span style="font-size: 10pt;">Fig 22. Permalink for article</span></strong></p><p><br></p><p>Now, this can be given to users that you would like to have access to this article.</p><p><br></p><p data-pasted="true">If creating a new version of an article (when using article versioning) the any existing links will still be valid and will link transfer over the newest version of the article. </p><p><br></p>
