> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atomscale.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration Admin Access

> Let integrations that need administrator rights, such as RHEED network capture, run on Windows without a prompt at every start

Most integrations run as the signed-in Windows user with no special rights. A few capture methods need administrator rights. **Integration admin access** installs a protected Windows component once. That component starts those integrations with administrator rights each time they run, so no one approves a Windows prompt at each start or update.

> [!NOTE]
>
> Integration admin access is Windows only. Two features use it: the
> [RHEED Camera (GenTL)](https://docs.atomscale.ai/gateway/rheed.md) integration's **Network (GVSP Tap)** frame source, which is the
> default, and the read-only Windows diagnostics of the Gateway assistant, the in-app helper for
> setup and computer issues. The **Standard (GenTL)** frame source doesn't need it. Enable it on
> every workstation so integrations you add later work without another visit from an administrator.

## Turning It On

There are three places to turn it on. All show the same Windows prompt, which someone with administrator credentials on the computer must approve once. The prompt names **Windows PowerShell**, verified publisher Microsoft Windows, because Atomscale runs its signed setup through PowerShell. It may open behind the Atomscale window.

| Where | When |
| - | - |
| The **Admin access** step of [First-Run Setup](https://docs.atomscale.ai/gateway/first-run.md#5-admin-access) | During setup. |
| **Settings > Application > Integration admin access** | Any time. Turn on Allow integration admin access. |
| The RHEED integration's page and its configuration page | When **Frame Source** is **Network (GVSP Tap)** and admin access is off, both show a notice with Enable admin access. |

The setup checks that the component is signed by Atomic Data Sciences, Inc before installing it. Integrations that use admin access and are running at the time are paused briefly and restarted with administrator rights. If setup doesn't complete, the setting stays off with Integration admin access setup did not complete. No setting was changed.

Admin access can't be turned on from the web app. For a remote gateway, the web app's configuration page tells you to turn it on at the computer.

## What It Installs

The setup is tied to the Windows user who enabled it and to this installation of Atomscale.

| Component | Location or name |
| - | - |
| **Scheduled task** | `Atomscale-Elevated-Adapter`. Runs as SYSTEM; only administrators and the user who enabled the setting may start it. |
| **Launcher** | `C:\Program Files\Atomscale\Atomscale\atomscale-elevated-launcher.exe` |
| **Protected data folder** | `C:\ProgramData\Atomscale\Atomscale\`, holding a protected copy of each elevated integration and the launcher log. |
| **Firewall rules** | An inbound UDP rule for each elevated integration, limited to the local subnet, added by the launcher, with no prompt, each time the integration starts. See [Windows Firewall Rules](https://docs.atomscale.ai/gateway/reference/network.md#windows-firewall-rules). |
| **Event log source** | `Atomscale Elevated Capture`, in the Windows Application log, created only if an administrative step fails. |

When an elevated integration starts, the launcher copies it into the protected folder, checks its signature, and runs it there. The integration still has no network access to Atomscale and hands all data to the desktop app for upload.

## When It Needs Repair

When a desktop app update ships a newer component, the setting shows An update to Integration admin access is available. An integration that needs the newer component shows … needs an update to Integration admin access on this computer. Click Update integration admin access in **Settings**, or Update admin access on the integration's page, and approve the Windows prompt.

The setting shows Integration admin access needs repair when the installed component no longer matches the app, for example:

* A different Windows user is signed in to the computer.
* An administrator or security software removed part of the setup.

Integrations that need admin access then fail to start with "Could not start integration with admin access: Integration admin access setup is missing or out of date." Open **Settings**, click Repair integration admin access, and approve the Windows prompt. The RHEED configuration page offers the same with Repair admin access.

## Turning It Off

Turn off Allow integration admin access and confirm with Disable. Windows asks for administrator approval once, then the scheduled task, launcher, protected folder, and firewall rules are removed. The setting turns off only after removal succeeds; if it fails, you see Integration admin access could not be removed. The setting is still on.

With the setting off, integrations that need administrator rights can't capture. A RHEED integration using **Network (GVSP Tap)** reports that it needs Integration admin access.

## Uninstalling Atomscale

The uninstaller removes integration admin access automatically, asking for administrator approval only if it's present. If removal fails, the uninstall continues and reports what was left behind; an administrator can then remove the components listed above by hand. The `Atomscale Elevated Capture` event log source is left in place so earlier events stay readable.

## Troubleshooting

* **Setup or removal failed**: Open Event Viewer, go to **Windows Logs > Application**, and look for errors from the source `Atomscale Elevated Capture`. Each event includes the output of the failed step. Administrative steps time out after 3 minutes, including the time spent on the approval prompt.
* **An elevated integration doesn't start**: Check `C:\ProgramData\Atomscale\Atomscale\elevated-cache\launcher.log`. The error elevated launcher did not connect in time points to this file.
* **Security software blocked the setup**: Endpoint protection may block creating scheduled tasks or firewall rules. Ask IT to allow the signed launcher, then repair the setting.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.