Links

Traceback Integration

The Traceback system has been designed to allow flexibility in the integration with regards to how the process displays to your users. You can keep the default settings or you can modify in part or in full as follows :

1. The Default Display HTML

If you choose to include the Default Display HTML, then the Traceback javascript code will attempt to display a solid white overlay with black text. You can change :
Authentication Text In your Traceback Code settings, you can modify the text that is displayed on the white overlay while the check is taking place. This field allows the <br> HTML line break for a little additional formatting.
Authentication Text Pause This allows you to lengthen the time the Authentication Text message is displayed.

2. Modifying the Default Display HTML

You can make changes to the Default Display HTML by adding your own CSS styles. The Default Display HTML consists of two DIV elements. An outer element that is displayed as the overlay with an ID of #ixtb-overlay and an inner DIV which displays the text with an ID of #ixtb-txt.
You may need to add !important to any CSS to ensure that it overwrites the Default Display HTML.

3. Replacing the Default Display HTML

You can replace the Default Display HTML completely. Change the settings for your Traceback Code so that 'Default Display HTML' is not included.
You can now add your own code to provide the user experience that you prefer. In many cases you can provide the same overlay DIV but by coding this HTML yourself you can set it immediately to overlay your page - preventing any slight flicker as the page loads.
The Traceback javascript will set the #ixtb-overlay to hidden when the check is complete and will also update the #ixtb-text with the relevant text.
If you have set the Traceback Fail URL, then the Traceback javascript will still redirect.

4. Full Replacement

The Traceback javascript will also call a function during the process - on error and on pass. You can create your own javascript function to handle the display and user experience.
The function call is made to :
tracebackConf({data});
Where {data} is a javascript object containing the status. For most implementations not using NFT+, this will be similar to :
{
status:"key_pass"
}
Note that no function call is made during the script load, only on the responses.

Traceback Fail/Pass Codes

Depending on your configuration, Traceback will send Fail/Pass codes either
  • As a message directly to the user (Default HTML with no Fail URL) or
  • Included in the Fail URL redirect (if you have selected 'Add Error Codes' in your settings) or
  • As a parameter in the function call (if you are handling the display yourself).
These codes are :
Display Message
URL Code / Function
Function
No Traceback Key
no_key
When no key is in the URL
Traceback Key Fail
key_error
When the key is in the incorrect format
Traceback Key Expired, Please Scan Again
expired_key
When a key is re-used within a short period after issue.
Traceback Key Not Found, Please Scan Again
key_not_found
When a valid format key is passed but it's either never been valid or so old that it's been removed.
-
key_pass
When the key has been passed as valid.

Errors with Javascript Integration

If you have an error with your Traceback javascript integration then we will display messages as alerts - ie, pop-ups onto your screen. These errors can be caused by :
  • Not incuding your Tracebook Code in the javascript URL src
  • Not using a valid Code in the javascript URL src
  • Using a deleted Code
These alerts will only happen if there is a error with the Traceback javascript line added to your page. Once set, your users would never see an alert.

Advanced Settings

It is also possible to set the Fail URL and Authentication Text directly into the javascript embed. We don't recommend doing this under normal use as it's easier to manage via the Console. However, if you need to display different messages and/or have different Fail Pages, then this is an option.
Use data-text and data-failurl in the script source code.
For example :
<script defer data-text="Your Auth in Progress<br>Message" data-failurl="https://yourdomain.com/fail" src="https://t.ixkio.com/s/traceback.js?code=<yourcode>">
This will overrule any settings made in your Traceback Code console configuration.
Copyright TabDesk Ltd 2022