Capturing a nonce

In the course of resolving a Support ticket, our Turvo Support team may ask you to replicate the error you encountered and capture a nonce. A nonce (short for “number used once”) is a unique identifier that can be used in a number of ways in software, depending on the context. In this case, Turvo Support is typically looking for the nonce to help better understand what interactions led to the error your organization reported.

To capture a nonce, we recommend opening the Turvo platform in Google Chrome so that you can use Chrome’s built-in Inspect tool to find and copy the nonce.

Note: Any user with access to the part of the UI can find the nonce. For example, an issue in a shipment may only require Operator permissions, but an issue with the Admin Console may require an Admin-level user or above.

Capturing the nonce

For our example, we will capture the nonce generated while adding a carrier to a shipment.

1. Open Turvo in Google Chrome and log in.
2. Navigate to the shipment that produced the error you need corrected via the Global Search bar or buy clicking Shipments in the left toolbar.
3. For this example, we are manually adding a carrier to the shipment. Go to the Details tab and click the + for the Carriers block. The text field where you search for a carrier appears.
4. Before typing anything in the text field, right-click anywhere on the page and select Inspect from the context menu, or press the F12 key on your keyboard, to open Chrome’s Inspect tool.

5. A pane appears on the right side of your browser window. You may wish to expand the window and/or adjust the pane’s size so that you can easily see both the Turvo UI and the Inspect tool.
6. In the Inspect tool, click the Network tab. The Network tab records your interactions with the web page and the communications sent from your browser as you interact with the user interface.

7. It’s best to have a clean log of interactions to more easily find the log with the nonce you need. When you open the Network tab, there may already be a log of interactions visible. Click the Record network log button in the top left of the tool’s pane to clear the current log and restart recording.
   1. Note: If the Preserve log checkbox is checked, stopping the recording will not clear the log. Uncheck the box then start and stop recording again to clear the log.
   2. If the tool is recording activity, the empty pane displays the message, “Recording network activity,” and the Record network activity button is red.
   3. If recording is stopped, then the pane displays the message, “Record network log to display network activity,” and the Record network log button is white.

8. Once recording is started/resumed, go back to the portion of the browser displaying the Turvo UI and recreate the issue.
9. For our example, when we click on the Carrier text field and type in the name of a carrier, then click on a matching result, multiple entries are added to the network activity log.
10. Because the example issue occurred when trying to add a specific carrier, we must retrieve the nonce for the event recorded when we selected the carrier.

11. In the right pane, scroll down to find the header titled Nonce.

12. Highlight and copy the nonce, then paste it into your response to Turvo Support.

Knowing which activity log to look for

In the example above, we knew which activity log to open by looking for the header name that started with the Turvo ID number of the shipment we edited. Note that, in the image below, the logs before it are all titled “search.” This indicates that the logs were created while using the search bar to find the correct carrier account.

When looking for the correct activity log, look for a similar title that reflects the Turvo ID of the shipment, order, account, or other entity that you interacted with.