> For the complete documentation index, see [llms.txt](https://onboarding.olivehelps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onboarding.olivehelps.com/technical-requirements/granting-firewall-and-antivirus-access.md).

# Granting Firewall and AntiVirus Access

Olive Helps is meant to be run in settings where security is top of mind. In cases where you leverage antivirus software, app allow-lists, firewalls, and data loss prevention (DLP) networking solutions, you may need to make some exclusions to allow Olive Helps to operate fully. If you run any Privileged Access Management (PAM) software, you should exclude Olive Helps from these tools. 

In the sections below, you can find the list of executables, folders, and domains that should be added to your allow list.

## Networking <a href="#domains-to-allow" id="domains-to-allow"></a>

### SSL Decryption <a href="#domains-to-allow" id="domains-to-allow"></a>

Olive Helps ensures that all network requests are made over SSL and that nothing in between it and the destination can decrypt those messages. A firewall that attempts to decrypt SSL/HTTPS traffic between Olive Helps and the destination breaks down that security and therefore Olive Helps will not make network requests in this kind of environment.

In the end, decryption of SSL packets must be disabled for the application. Or, if it can't be done at an application level, it should be disabled for the domain list below.

### Domains to allow <a href="#domains-to-allow" id="domains-to-allow"></a>

If you have a firewall, DLP (Data Loss Prevention) solution, or other tools that may restrict what domains you can visit, you will need to add these to your allow list.

#### Primary Olive Helps API - primarily used for authentication <a href="#primary-olive-helps-api-primarily-used-for-authentication" id="primary-olive-helps-api-primarily-used-for-authentication"></a>

<https://sidekick.oliveai.com>

#### Loop Library API - our marketplace to find and download Loops ("apps") that run in Olive Helps <a href="#loop-library-api-our-marketplace-to-find-and-download-loops-apps-that-run-in-olive-helps" id="loop-library-api-our-marketplace-to-find-and-download-loops-apps-that-run-in-olive-helps"></a>

<https://loop-library-api.oliveai.com>

#### Automatic Updates and Terms of Service <a href="#automatic-updates-and-terms-of-service" id="automatic-updates-and-terms-of-service"></a>

<https://olive-public-web-assets.s3.amazonaws.com> (for automatic updates and terms of service)

#### Authentication Provider <a href="#authentication-provider" id="authentication-provider"></a>

<https://oliveai.auth0.com>

#### Onboarding Assets <a href="#onboarding-assets" id="onboarding-assets"></a>

<https://olive-helps-onboarding-assets.oliveai.dev>

#### Crash Reporting <a href="#crash-reporting" id="crash-reporting"></a>

<https://sentry.oliveai.com>

#### App Usage Analytics <a href="#app-usage-analytics" id="app-usage-analytics"></a>

<https://www.google-analytics.com>

#### Sidenote API - for storing your Olive Helps notes (Sidenotes) in the cloud - coming soon <a href="#sidenote-api-for-storing-your-olive-helps-notes-sidenotes-in-the-cloud-coming-soon" id="sidenote-api-for-storing-your-olive-helps-notes-sidenotes-in-the-cloud-coming-soon"></a>

<https://sidenote-api.oliveai.com>

## Executables <a href="#executable-file-paths-to-exclude-from-antivirus-or-to-add-to-your-app-allow-list-windows-only" id="executable-file-paths-to-exclude-from-antivirus-or-to-add-to-your-app-allow-list-windows-only"></a>

Executable File Paths that may need to be excluded from antivirus or to added to allow lists. Read, write, and execute permission will need to be allowed for normal application usage.

### Windows (per-machine install) <a href="#executable-file-paths-to-exclude-from-antivirus-or-to-add-to-your-app-allow-list-windows-only" id="executable-file-paths-to-exclude-from-antivirus-or-to-add-to-your-app-allow-list-windows-only"></a>

C:\Program Files\Olive Helps\olive-helps.exe

C:\Program Files\Olive Helps\Update.exe

C:\Program Files\Olive Helps\\<mark style="color:orange;">\<VERSION></mark>\olive-helps.exe

C:\Program Files\Olive Helps\\<mark style="color:orange;">\<VERSION></mark>\resources\app\\.webpack\components\\<mark style="color:green;">\<COMPONENT></mark>.exe

C:\Users\\<mark style="color:purple;">\<USERNAME></mark>\AppData\Roaming\Olive Helps\components\\<mark style="color:green;">\<COMPONENT></mark>\\<mark style="color:orange;">\<VERSION></mark>\\<mark style="color:green;">\<COMPONENT></mark>.exe **(only v0.47 and older)**

### Windows (per-user install) <a href="#executable-file-paths-to-exclude-from-antivirus-or-to-add-to-your-app-allow-list-windows-only" id="executable-file-paths-to-exclude-from-antivirus-or-to-add-to-your-app-allow-list-windows-only"></a>

C:\Users\\<mark style="color:purple;">\<USERNAME></mark>\AppData\Local\olive-helps\olive-helps.exe

C:\Users\\<mark style="color:purple;">\<USERNAME></mark>\AppData\Local\olive-helps\Update.exe

C:\Users\\<mark style="color:purple;">\<USERNAME></mark>\AppData\Local\olive-helps\\<mark style="color:orange;">\<VERSION></mark>\olive-helps.exe

C:\Users\\<mark style="color:purple;">\<USERNAME></mark>\AppData\Local\olive-helps\\<mark style="color:orange;">\<VERSION></mark>\resources\app\\.webpack\components\\<mark style="color:green;">\<COMPONENT></mark>.exe

C:\Users\\<mark style="color:purple;">\<USERNAME></mark>\AppData\Roaming\Olive Helps\components\\<mark style="color:green;">\<COMPONENT></mark>\\<mark style="color:orange;">\<VERSION></mark>\\<mark style="color:green;">\<COMPONENT></mark>.exe **(only v0.47 and older)**

### **MacOS** (per-machine install) <a href="#executable-file-paths-to-exclude-from-antivirus-or-to-add-to-your-app-allow-list-windows-only" id="executable-file-paths-to-exclude-from-antivirus-or-to-add-to-your-app-allow-list-windows-only"></a>

/Applications/Olive Helps.app/Contents/MacOS/olive-helps

/Applications/Olive Helps.app/Contents/Resources/app/.webpack/components/<mark style="color:green;">\<COMPONENT></mark>

### MacOS (per-user install) <a href="#executable-file-paths-to-exclude-from-antivirus-or-to-add-to-your-app-allow-list-windows-only" id="executable-file-paths-to-exclude-from-antivirus-or-to-add-to-your-app-allow-list-windows-only"></a>

/Users/<mark style="color:purple;">\<USERNAME></mark>/Applications/Olive Helps.app/Contents/MacOS/olive-helps

/Users/<mark style="color:purple;">\<USERNAME></mark>/Applications/Olive Helps.app/Contents/Resources/app/.webpack/components/<mark style="color:green;">\<COMPONENT></mark>

## Additional File Access <a href="#other-file-paths" id="other-file-paths"></a>

Logs, Sidenote database, and other assets used by Olive Helps. Read and write access will need to be allowed for normal application usage.

In addition to the paths listed below, loops may need additional file access. This additional file access is documented by the loop author in the loop library.

### Windows <a href="#logs-sidenote-database-and-other-assets-needed-to-run-olive-helps" id="logs-sidenote-database-and-other-assets-needed-to-run-olive-helps"></a>

C:\Users\\<mark style="color:purple;">\<USERNAME></mark>\AppData\Roaming\Olive Helps\\

### MacOS

/Users/<mark style="color:purple;">\<USERNAME></mark>/Library/Application Support/Olive Helps/