Was this helpful?
Was this helpful?
An abbreviated version of the ZebraTester Installation Guide PDF is included in the installation kit. Please download and refer to the installation guide for additional instructions and details.
If you install ZebraTester on a Windows system for the first time, Apica strongly recommends creating your own CA Root Certificate.
You may share the CA Root Certificate (root.cer) and its private key (.der) with other team members.
Proceed as follows:
Instructions
Screenshot
OpenSSL is only needed to generate the CA root certificate.
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.
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.
Instructions
Screenshot
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.
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.
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.
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.
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.