Warning
WARNING: The TrackAbout MetaWiki has been deprecated and is no longer being updated.

Please visit our new TrackAbout Knowledge Base at https://supportkb.trackabout.com for the most-up-to-date documentation on TrackAbout and TrackAbout Mobile.

TLS 1.2 QA Environment Testing

From TrackAbout MetaWiki
Revision as of 11:35, 4 March 2020 by Lsilverman (talk | contribs) (Initial version (by SublimeText.Mediawiker))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

QA Environment Available to All, Effective Immediately

The TrackAbout QA site is only up between the hours of 6 AM and 5 PM Mon-Fri Eastern US Daylight Time. It is offline during the weekend.

If you would like to request the site remain up for a certain period of time for your testing outside the normal hours, please contact us at support@trackabout.com and we will do our best to accommodate you.

You will not be able to log in or fully sync TAMobile 6 against this environment, but simple TLS 1.2 connection tests using TAMobile 6 as outlined below will be useful.

TAMobile 7 Android and iOS cannot be tested against this environment, sorry.

Android and iOS testing must be conducted against the Test environment.

QA Environment - Web Browser Test

The URL is https://staging.trackabout.com

You can test any browser by navigating to this URL now. If you see a login page, your browser is TLS 1.2 compatible.

You may need to have "staging.trackabout.com" added to an "allow" or "white" list in your network firewall.

QA Environment - Basic ERP REST API Test

From your ERP or other system, make a GET HTTP request to https://staging.trackabout.com/api/heartbeat

The GET request should return HTTP status 200 and HTTP body of "0". Anything else is a failure.

QA Environment - TAMobile 6 Basic Test

The following test WILL validate TLS 1.2 connectivity from TAMobile 6. It WILL NOT fully sync or allow log in.

Ensure you are running a version of TAMobile 6 starting with 6.0.316 or greater.

Run this test with every different model or version of rugged hardware you own. Success with one device model (e.g. Zebra MC-3100) does not guarantee success with all different device models.

If you use TAMobile 6 Desktop, run this test on a PC after applying the required registry changes provided in our last communication. Make sure the PC is up-to-date on Windows Updates.

Again, this test will NOT complete a full sync successfully and you will NOT be able to log in, but it WILL prove that TLS 1.2 communication is working.

For this test, you must modify the app's configuration file (config.ini). You must:

  • Change the target server URL
  • Change the existing Sync Key

Record the original values. Restore them when testing is complete.

The modified config.ini for testing should look like this:

[Config]
SyncUrl = https://staging.trackabout.com/
SyncKey = LP35KELQHA6G
SyncPort = 443

Save and close the file.

How To Find Config.ini On a Rugged Device

Connect the rugged device to the Sync PC so that you can access the device's file system from Windows Mobile Device Center.

Find and modify the config.ini file found in the application program files folder. On rugged devices, this is found in \Program Files\TrackAbout\config.ini

How To Find Config.ini On TAMobile6 Desktop

Open file C:\Users\username\AppData\Local\TrackAbout\TAMobile6Desktop\config.ini

Alternatively:

  • Select menu Help...About
  • Click the "Open Config File" button.

Conducting the Test

The following screenshots are from TAMobile 6 Desktop but are roughly the same on rugged handhelds.

Once you have modified the config.ini file, close the application. Make sure it is not running in the background.

Launch the application.

You may or may not be prompted to upgrade the a newer version. Upgrade if possible.

Click the SYNC button.



WHAT YOU WILL SEE IF TLS 1.2 IS NOT WORKING When TLS 1.2 is NOT working, the "Checking Server" step will fail.


WHAT YOU WILL SEE IF TLS 1.2 IS WORKING PROPERLY We will still see an error, but the "Checking Server" and "Authorizing Device" steps will report "OK".

This confirms TLS 1.2 is working on this device.