Description

We provide a feature to load the standalone Virtual Agent web client to onto a browser via URL link: https://instance.service-now.com/$sn-va-web-client-app.do or via iFrame (if embedding into a web page).

But this web client is by default accessible publicly (even for unauthenticated users) even though the topics are not made public.

This article focuses on how to make this web client interface non-public such that it redirects users to login before proceeding further with virtual agent chat.

Procedure

• The page to focus on is $sn-va-web-client-app.
• Under Application Navigator, navigate to System Definition > Public Pages. (If you don't see this module, please check Additional Information below)
• Look for the record under Page field/column with the above name.
• You will notice that Active field is set to true.
• Set it to false.

This will ensure unauthenticated users to get redirected to login page when this standalone URL is accessed.

Additional steps to make this work with Single Sign On (SSO):

• Navigate to System Definition > Script Includes
• Find the "SAML2_update1" script include.
• Find the following piece of code in the script field: 

  needNavFrame: function(requestURI, request)

• Add the following if condition inside needNavFrame to remove the navpage from the virtual agent standalone client:

if (requestURI.indexOf("sn-va-web-client-app") >= 0)
{

return false;
}

• Save the changes to the script include
• Provide end user with the following URL : https://<instance>.service-now.com/$sn-va-web-client-app.do 

Applicable Versions

London.

Additional Information

Activate the public pages module: https://docs.servicenow.com/bundle/istanbul-platform-administration/page/administer/general/task/t_ActivateThePublicPagesModule.html