WitnessAI Documentation
List
Start Here
Start Here
Analytics
Analytics
Conversations
Conversations
Users
Users
Alerts
Alerts
Policy
Policy
Administration
Administration
Apps & Resources
Apps & Resources
Release Notes
Release Notes
Administrator Guide
Administrator Guide
Witness Anywhere: Intune Admin Guide (Windows Physical devices)
Witness Anywhere: Intune Admin Guide (Windows Physical devices)
This guide describes how to deploy WitnessAI Witness Anywhere to Windows devices using Intune.
Lifecycle Overview
The deployment follows below lifecycle:
- The registration script runs on a device, installs the WitnessAI Root CA certificate to the Local Machine trusted root store, generates a device fingerprint, registers with WitnessAI, writes the configuration to the user's registry (`HKEY_USERS\<SID>\Software\WitnessAI`), applies the PAC URL to the system proxy settings, and deploys STunnel for encrypted proxy communication.
- The flush script can be assigned on-demand to revert all proxy settings, remove the Root CA certificate, uninstall STunnel, and delete the local configuration.
Generate Witness Anywhere Registration Scripts
To register devices with Witness Anywhere you must create a PAC Token.
- In the WitnessAI console, go to Administration → Configuration → Proxy. The Proxy Configuration page opens with a Witness Anywhere section.
- Type your preferred token name in the Key Name field and select the Expiration Date. The Expiration Date should allow time for you to complete the current deployment.
Once a device has been registered with Witness Anywhere, the token is no longer required. If a token expires, devices that were already deployed and successfully onboarded will continue to function normally. The token is only required during initial deployment.
- Click the Generate PAC Token
Download the Intune bundle from the Witness console
- In the Witness console, open the Download Device Registration Script dialog.
- Configure the download options:
- Platform: select Intune (Windows).
- Static Domain (Optional): enter the static domain if one is used for your tenant (e.g. witness.ai).
- STunnel (Optional): this toggle controls what the generated detection script validates:
- Enabled: the detection script includes stunnel health logic: it verifies that stunnel is installed under the user profile, the process is running, and it is listening as expected, in addition to the PAC/registry checks.
- Disabled: the detection script contains no stunnel logic and validates only the Witness Anywhere PAC/registry configuration.
- Click Download.
- Extract the downloaded bundle. It contains two folders: platform_scripts and remediation_scripts.
- For this deployment, use the scripts from the platform_scripts folder:
flush.ps1andregister_device.ps1.
Setting Up Intune Scripts
Upload the Registration Script
In the Microsoft Intune admin center console:
- Go to Devices → Manage devices → Scripts and remediations → Platform Scripts
- Click ADD and select Windows 10 and later from the dropdown
- On the Basics tab:
- Name: Witness Anywhere - Register Device
- Click Next
- On the Script settings tab:
- Script location: Browse and select the register_device.ps1 file downloaded from the WitnessAI console
- Run this script using the logged on credentials: No
- Enforce script signature check: No
- Run script in 64 bit PowerShell Host: No
- Click Next
- On the Assignments tab
- Assign to the relevant device or user groups.
- Click Next
- Click Review + create tab → Create
Upload the Flush Script
In the Microsoft Intune admin center console:
- Go to Devices → Manage devices → Scripts and remediations → Platform Scripts
- Click ADD and select Windows 10 and later from the dropdown
- On the Basics tab:
- Name: Witness Anywhere - Flush Device
- Click Next
- On the Script settings tab:
- Script location: Browse and select the flush.ps1 file downloaded from the WitnessAI console
- Run this script using the logged on credentials: No
- Enforce script signature check: No
- Run script in 64 bit PowerShell Host: No
- Click Next
- On the Assignments tab
- Assign only to the devices you want to offboard.
- Click Next
- Click Review + create tab → Create
Logs
All scripts write timestamped logs to C:\Windows\Temp\ on the local device:
Log file | Purpose |
C:\Windows\Temp\pac-registration-log.txt | Registration script output (created/appended on each run) |
C:\Windows\Temp\pac-flush-log.txt | Flush script output (created/appended on each run) |