User Self-Management Settings

On the User Self-Management Settings page, you can configure error message links to be displayed when authentication with Digipass Authentication for Citrix StoreFront fails.

There are two ways to configure error message links in the Digipass Authentication for Citrix StoreFront Configuration Center:

OneSpan User Self-Management Website Links Generator

You can enter the URL of your OneSpan User Self-Management Website to add links for user self-management to error messages (e.g. a link to the User Self-Unlock page if a user gets locked). The URL fields in the Custom Redirection section will be automatically populated with links created from this URL.

Custom redirection

If required, you can also specify custom links that will be displayed as part of an error message. This could be a link to your Customer Support page, or links for user self-management.

Address

The URL of your OneSpan User Self-Management Website. The URL fields in the Custom Redirection section will be automatically populated to create links based on this URL.

Use this field if you do not want to specify custom links for error messages.

For the fields under Custom Redirection, you can specify custom links, or use the Address field in the OneSpan User Self-Management Website Links Generator section to automatically fill these fields.

Local password sync

The link to be displayed when logon fails due to unsynchronized passwords.

Back-end password change

The link to be displayed when logon fails because the user needs to change their static password.

User self-unlock

The link to be displayed when logon fails because the user is locked.

Server PIN change

The link to be displayed when logon fails because the user needs to change their server PIN.

If no error message link is entered for a field, the default message (i.e. without a user self-management link) will be displayed for the corresponding error.

StoreFront customization

To achieve best user experience, paste the following code into the script.js file, usually located in C:\inetpub\wwwroot\Citrix\StoreWeb\custom\. This will provide you with a hyperlink instead of an uncopyable plain text as the link to OneSpan User Websites.

$("#explicit-auth-screen").on("DOMNodeInserted", "div.standaloneText.label.error[role='alert']", function() {
  if (!this.firstElementChild) {
    var url = this.innerText.match(/\bhttps?:\/\/\S+/);
    var markId = "DIGIPASSUWSLink";
    var anchorText = "Self-Management Website.";
    
    if (url) {
      var anchor = "<a id='" + markId + "' href='" + url + "'>" + anchorText + "</a>";
      this.innerHTML = this.innerHTML.replace(url, anchor);
      this.setAttribute("url", url);
    } else if (this.hasAttribute("url")) {
      var anchor = "<a id='" + markId + "' href='" + this.getAttribute("url") + "'>" + anchorText + "</a>";
      this.innerHTML = this.innerHTML.replace(url, anchor);
    }
  }
});

You can customize the hyperlink by referring to its id=DIGIPASSUWSLink and define the custom style in the style.css file, usually located in C:\inetpub\wwwroot\Citrix\StoreWeb\custom\. It is possible that the color of the hyperlink is invisible in case you have customized the Citrix StoreFront page and background. You can also choose to select a color that is different from the default color.

#DIGIPASSUWSLink {
  color: hotpink;
}