> For the complete documentation index, see [llms.txt](https://docs.apica.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apica.io/platform-docs/zebratester-scripting/install-zebratester/macos-installation/generate-private-ca-root-cert-macos-x.md).

# Generate Private CA Root Cert (macOS X)

For security reasons Apica strongly recommends generating your own CA root certificate for ZebraTester and import this root certificate into the OS and/or into Firefox.

## CA Root Certificate on MacOS X <a href="#ca-root-certificate-on-macos-x" id="ca-root-certificate-on-macos-x"></a>

| **Step**                                                                                                                                                                                                                                                                                                     | **Screenshot**                                                                                                                                                                                                                                                                                                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <h4 id="locate-command-script">Locate Command Script</h4><ul><li>Open a Finder window and navigate to the <code>installation subdirectory/RuntimeData</code>(typically at <code>/Applications/ZebraTester/RuntimeData</code>)</li><li>Click on <strong>CreateOwnCARootCertificate.command</strong></li></ul> | Open image-20201229-201145.png![](blob:https://apica-kb.atlassian.net/b6e3c321-aec6-47de-8201-b847859d1c5b#media-blob-url=true\&id=fc15f161-ab8c-4ebf-b984-a650356c65da\&collection=contentId-4620834\&contextId=4620834\&mimeType=image%2Fpng\&name=image-20201229-201145.png\&size=284412\&width=643\&height=385\&alt=) |
| <h4 id="run-command-script">Run Command Script</h4><ul><li>Enter any obvious input for your private CA Root Certi</li></ul>                                                                                                                                                                                  | Open image-20201229-202156.png![](blob:https://apica-kb.atlassian.net/7810d3d0-ed9f-4dae-a6b7-c6748bfb8042#media-blob-url=true\&id=bddf6070-f413-4234-9a43-86689382f144\&collection=contentId-4620834\&contextId=4620834\&mimeType=image%2Fpng\&name=image-20201229-202156.png\&size=77170\&width=407\&height=220\&alt=)  |

## Import into the OS/Firefox <a href="#import-into-the-os-firefox" id="import-into-the-os-firefox"></a>

| <h4 id="verify-the-certificate">Verify the Certificate</h4><ul><li>Restart the ZebraTester Console and verify your CA Root Certificate using the Web Admin GUI</li></ul>                                                                                                                                                                                                                                                                                                                  | Open image-20201229-203312.png![](blob:https://apica-kb.atlassian.net/c1bcf35e-2edf-49e3-8499-c43d341655c4#media-blob-url=true\&id=2fb94254-044e-41e0-ad62-fc37bd6018be\&collection=contentId-4620834\&contextId=4620834\&mimeType=image%2Fpng\&name=image-20201229-203312.png\&size=365908\&width=615\&height=323\&alt=)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <h4 id="import-your-ca-root-certificate-into-firefox">Import your CA Root Certificate into Firefox</h4><p>Under Firefox Preferences</p><ul><li>Use the Firefox Certificate Manager Import function to open the file <strong>root.cer</strong> in the ZebraTester <strong>installation subdirectory /RuntimeData</strong>.</li><li>Enable the checkbox "Trust this CA to identify websites.”</li><li>Click OK</li><li>You will find your Certificate under the Authorities tab.</li></ul>  | Open image-20201229-204441.png![](blob:https://apica-kb.atlassian.net/149b43f7-ed98-478e-8c79-fd15bf264155#media-blob-url=true\&id=98a83f3b-19c5-43d7-8a75-2673de9d859f\&collection=contentId-4620834\&contextId=4620834\&mimeType=image%2Fpng\&name=image-20201229-204441.png\&size=256766\&width=587\&height=320\&alt=)Open image-20201229-204928.png![](blob:https://apica-kb.atlassian.net/7dde37d9-6872-423e-85c6-e3575d3a27a5#media-blob-url=true\&id=dcf22325-d067-4a9a-af98-8bcf538739e8\&collection=contentId-4620834\&contextId=4620834\&width=364\&height=249\&alt=)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <h4 id="import-your-ca-root-certificate-into-macos-x">Import your CA Root Certificate into macOS X</h4><ul><li>Right Click on the root.cer file and Open it with the Keychain Access App.</li><li>You will get a prompt to enter your password or fingerprint to continue the import.</li><li>It will import to the System Keychain, but will be in an untrusted state.</li></ul>                                                                                                         | Open image-20201229-212249.png![](blob:https://apica-kb.atlassian.net/451da899-c5e5-4219-866d-4d67b6400d5f#media-blob-url=true\&id=4d5b0b8e-37b8-4a5c-a6e3-0b7abb39f633\&collection=contentId-4620834\&contextId=4620834\&width=640\&height=383\&alt=)Open image-20201229-212445.png![](blob:https://apica-kb.atlassian.net/dad2ff7a-71cc-4698-9537-44a281b124a1#media-blob-url=true\&id=48dbb92c-4bcf-4eaa-bbc9-9d9570768c8c\&collection=contentId-4620834\&contextId=4620834\&width=224\&height=84\&alt=)Open image-20201229-213233.png![](blob:https://apica-kb.atlassian.net/49112a92-76b1-4e12-a8bc-05ebab3654c7#media-blob-url=true\&id=6cdaf63f-fe06-4987-9e3f-90841667c456\&collection=contentId-4620834\&contextId=4620834\&width=409\&height=239\&alt=)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <h4 id="set-the-ca-trust-level">Set the CA Trust Level</h4><ul><li>Double-click to open the Certificate</li><li>Expand the Trust menu</li><li>Select <strong>Always Trust</strong></li><li>When selecting the close dialog box, you will be prompted to enter your password or fingerprint to make these Certificate Trust Setting changes.</li><li>The <strong>Red X</strong> next to the certificate will change when the trust level is updated to a <strong>Blue +</strong></li></ul> | Open image-20201229-213603.png![](blob:https://apica-kb.atlassian.net/f31a1174-f8ba-4d76-ac16-79b238893c17#media-blob-url=true\&id=03869271-f7c9-446e-9585-8b18708d4bf6\&collection=contentId-4620834\&contextId=4620834\&width=244\&height=134\&alt=)Open image-20201229-214001.png![](blob:https://apica-kb.atlassian.net/02dee626-bd55-4328-b08e-19c455d8affe#media-blob-url=true\&id=daa0e7ac-61dc-4de5-8721-8a270c58d03f\&collection=contentId-4620834\&contextId=4620834\&width=211\&height=164\&alt=)Open image-20201229-214131.png![](blob:https://apica-kb.atlassian.net/c04bdeb9-8365-46ec-8611-67b382483861#media-blob-url=true\&id=a770c520-98a6-45cc-aae3-34fa71e5f0fe\&collection=contentId-4620834\&contextId=4620834\&width=224\&height=84\&alt=)Open image-20201229-214546.png![](blob:https://apica-kb.atlassian.net/5cbf5466-0609-458c-9f9c-beb20f1b9243#media-blob-url=true\&id=a524df2f-2e54-4000-85e2-769bf1d4d21d\&collection=contentId-4620834\&contextId=4620834\&width=236\&height=394\&alt=)Open image-20201229-214645.png![](blob:https://apica-kb.atlassian.net/fe7a2ea1-e396-45aa-a8ce-4dec6c5161eb#media-blob-url=true\&id=9bd9d240-3fdc-41f0-8437-277e043b12d9\&collection=contentId-4620834\&contextId=4620834\&width=236\&height=394\&alt=) |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.apica.io/platform-docs/zebratester-scripting/install-zebratester/macos-installation/generate-private-ca-root-cert-macos-x.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.