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

# Private windows on macOS

> Deploy one configuration profile so the sensor governs AI traffic in Chrome Incognito, Edge InPrivate and Guest windows on a Mac.

The VisIQ browser extension does not run in Chrome Incognito, Edge InPrivate or Guest windows. On a Mac with the sensor installed, the sensor governs AI traffic in those windows instead, for as long as one is open. To do that it asks Chrome and Edge which of their windows are private, and macOS allows that only with an Automation permission. Deploy the profile below from your MDM and the permission is granted on every Mac, with no prompt to the user.

## Deploy the profile

**1. Save the profile**

Copy the profile at the end of this page and save it as `VisIQ-Private-Windows-Automation.mobileconfig`.

**2. Upload it to your MDM as a custom configuration profile**

* **Jamf Pro:** Computers, then Configuration Profiles, then Upload.
* **Microsoft Intune:** Devices, then macOS, then Configuration, then Create, then New policy; choose Templates, then Custom, set the deployment channel to Device channel, and upload the file.
* **Kandji:** Library, then Add new, then Custom Profile.

**3. Assign it to the same Macs as the sensor**

Use the same group or scope you use for the VisIQ sensor. The permission applies at the profile's next check-in; nothing restarts.

> [!NOTE]
>
> A Privacy Preferences profile installs only from an MDM. Opening the file on a Mac does not grant the permission.

## What the profile allows

It lets one program, the VisIQ sensor at `/usr/local/bin/visiq-discovery` signed by VisIQ Labs, send Apple Events to Google Chrome and Microsoft Edge. The sensor uses them for one thing: reading whether each window is normal or private. It does not read titles, addresses, tabs or page content.

Without the profile, the sensor does not govern private windows on that Mac. Normal windows are still governed by the extension.

## The profile

```xml VisIQ-Private-Windows-Automation.mobileconfig theme={null}
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<!--
  Privacy Preferences Policy Control (PPPC) profile for the VisIQ sensor on macOS.

  It lets the sensor (/usr/local/bin/visiq-discovery, signed by VisIQ Labs, team 57998XYMAD) ask Google Chrome and Microsoft Edge
  which of their windows are Incognito, InPrivate or Guest windows, through Apple Events, with no prompt on the Mac. While such a
  window is open the sensor governs that browser's AI traffic, because the browser extension does not run in those windows.

  Deploy it from your MDM (Jamf Pro, Kandji, Microsoft Intune for macOS, Mosyle or any MDM that installs configuration profiles) to the
  same Macs as the sensor. A PPPC profile installs only from an MDM; double-clicking it on a Mac does not apply it.
  Customer guide: docs.visiqlabs.com/discovery/macos-private-windows
-->
<plist version="1.0">
<dict>
  <key>PayloadContent</key>
  <array>
    <dict>
      <key>PayloadDescription</key>
      <string>Lets the VisIQ sensor see which Chrome and Edge windows are private, so AI traffic in those windows is governed.</string>
      <key>PayloadDisplayName</key>
      <string>VisIQ sensor: browser private windows</string>
      <key>PayloadIdentifier</key>
      <string>com.visiqlabs.discovery.pppc.private-windows.tcc</string>
      <key>PayloadType</key>
      <string>com.apple.TCC.configuration-profile-policy</string>
      <key>PayloadUUID</key>
      <string>1E056ED3-0AE8-41A2-AD73-7FAE15C98988</string>
      <key>PayloadVersion</key>
      <integer>1</integer>
      <key>Services</key>
      <dict>
        <key>AppleEvents</key>
        <array>
          <dict>
            <key>Identifier</key>
            <string>/usr/local/bin/visiq-discovery</string>
            <key>IdentifierType</key>
            <string>path</string>
            <key>CodeRequirement</key>
            <string>anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] /* exists */ and certificate leaf[field.1.2.840.113635.100.6.1.13] /* exists */ and certificate leaf[subject.OU] = "57998XYMAD"</string>
            <key>AEReceiverIdentifier</key>
            <string>com.google.Chrome</string>
            <key>AEReceiverIdentifierType</key>
            <string>bundleID</string>
            <key>AEReceiverCodeRequirement</key>
            <string>identifier "com.google.Chrome" and anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] /* exists */ and certificate leaf[field.1.2.840.113635.100.6.1.13] /* exists */ and certificate leaf[subject.OU] = "EQHXZ8M8AV"</string>
            <key>Allowed</key>
            <true/>
            <key>Comment</key>
            <string>Read the mode (normal or incognito) of each Google Chrome window.</string>
          </dict>
          <dict>
            <key>Identifier</key>
            <string>/usr/local/bin/visiq-discovery</string>
            <key>IdentifierType</key>
            <string>path</string>
            <key>CodeRequirement</key>
            <string>anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] /* exists */ and certificate leaf[field.1.2.840.113635.100.6.1.13] /* exists */ and certificate leaf[subject.OU] = "57998XYMAD"</string>
            <key>AEReceiverIdentifier</key>
            <string>com.microsoft.edgemac</string>
            <key>AEReceiverIdentifierType</key>
            <string>bundleID</string>
            <key>AEReceiverCodeRequirement</key>
            <string>identifier "com.microsoft.edgemac" and anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] /* exists */ and certificate leaf[field.1.2.840.113635.100.6.1.13] /* exists */ and certificate leaf[subject.OU] = "UBF8T346G9"</string>
            <key>Allowed</key>
            <true/>
            <key>Comment</key>
            <string>Read the mode (normal or InPrivate) of each Microsoft Edge window.</string>
          </dict>
        </array>
      </dict>
    </dict>
  </array>
  <key>PayloadDescription</key>
  <string>Lets the VisIQ sensor see which Chrome and Edge windows are private, so AI traffic in those windows is governed.</string>
  <key>PayloadDisplayName</key>
  <string>VisIQ sensor: browser private windows</string>
  <key>PayloadIdentifier</key>
  <string>com.visiqlabs.discovery.pppc.private-windows</string>
  <key>PayloadOrganization</key>
  <string>VisIQ Labs</string>
  <key>PayloadScope</key>
  <string>System</string>
  <key>PayloadType</key>
  <string>Configuration</string>
  <key>PayloadUUID</key>
  <string>3EEBBCC8-5123-43D7-A492-25A43ECDEBB0</string>
  <key>PayloadVersion</key>
  <integer>1</integer>
</dict>
</plist>
```


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