Install OpenSSL

The OpenSSL executable is bundled with ZebraTester and can be found in the base ZebraTester installation folder.

Ignore any warnings of OpenSSL during the installation and accept all of the default settings.

You may install OpenSSL in a different location from the default.

Locate CreateOwnCARootCertificate.bat

• This file is in the default installation directory

• Example: C:\Users\<your-name>\ZebraTester\

Edit CreateOwnCARootCertificate.bat

• You will get a notice to modify the value for OPENSSL_INSTALL_DIR to point to your OpenSSL installation directory when you run the batch file. If not needed, continue with any key.

• Otherwise, right-click the file to edit it and look for the line starting with "SET OPENSSL_INSTA" Under Firefox Options, and you will import the root.cer file, stored in the Trusted CA certificate store, into Firefox.

• From the Certificate Manager, under the Authorities Tab, Import the Certificate by browsing for it under the user's ZebraTester directory.

• Open the certificate and check both boxes to set the Trust levels

  • Enable the checkbox Trust this CA to identify websites.

  • Enable the checkbox Trust this CA to identify email users.

Check the Firefox Certificate Store for the new Root CA

Restart the ZebraTester Console

• Verify your CA Root Certificate using the Web Admin GUI.

Start ZebraTester

• Start the Console

• After the Console shows the 127.0.0.1:7990, Start the GUI with the second icon.

  • The icon will depend on what your default browser is during the installation.

  • Apica recommends a private Firefox Browser Window that you can clear cache and also the Firefox Browser Extension for ease of scripting.

The ZebraTester Main Menu

• This is the ZT Main Menu, and the Zebra icon in the upper right has the Firefox Browser Extension installed and enabled for Private Windows.

Open a Second Private Browser window (Application)

• Place it side-by-side with the Main Menu window.

• The second private window is for the target application and is cleared of cache.

• This arrangement allows you to see and interact with the application and keep an eye on the ZebraTester.

• Arrange it as needed. This screenshot shows as much of the ZT Main Menu as possible.

Clear the Browser Cache; Intro to The Script Extension

• In the Application Navigation Window, the ZebraTester Script extension makes it easy to Clear the browser cache with a toggle before your click Start Recording.

• You'll note, in the extension, that there will be no proxy set before you start recording. There is also no Last Action summary.

Start Recording; Navigate the Application

• Note that the Browser Cache toggle is ON and that the cache has been cleared.

• When Start Recording is Clicked, the Proxy Mode is now enabled, and the Root Certificate we created earlier enforces the SSL sessions between the browser and the content the browser is requesting.

  • Depending on the browser you are using to record your sessions, there might be some browser-issued warnings that a forward proxy (ZT) has been detected (“Is this OK?”). Since it's understood why ZT has been inserted between the content delivered and the browser, it is safe to proceed.

• You'll also see that the Last Action section will summarize what last few actions that have been recorded.

• As usual, you may enter the Application URL in the browser address bar, and ZT will start recording the session.

• Click the Stop Recording button when you are done.

Refresh the Display in Window One

• Once you have started recording the application, you can always switch to Window One and the Main ZT Menu to see what is being captured graphically.

• Click the Refresh Display button to populate the screen.

Once you have stopped your recording and can see the content displayed, you have successfully tested your ZebraTester Installation.