<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -",
    "macOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/NetworkDNSProxy",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rmdm-declarations:NetworkDNSProxy"
  },
  "title" : "NetworkDNSProxy"
}
-->

# NetworkDNSProxy

The declaration to configure DNS proxy settings.

```
object NetworkDNSProxy
```

## Discussion

Specify `com.apple.configuration.network.dns-proxy` as the declaration type.

### Configuration availability

|||
|--------------------------------|----------------------------------------------|
|Allowed in supervised enrollment|iOS, macOS, Shared iPad, visionOS             |
|Allowed in device enrollment    |iOS, Shared iPad, visionOS                    |
|Allowed in user enrollment      |iOS, Shared iPad, visionOS                    |
|Allowed in local enrollment     |macOS                                         |
|Allowed in system scope         |iOS, macOS, Shared iPad, visionOS             |
|Allowed in user scope           |N/A                                           |
|Apply                           |Multiple configurations are applied separately|

### Configuration example

This configuration sets up a DNS proxy using a Network Extension app.

```json
{
    "Type": "com.apple.configuration.network.dns-proxy",
    "Identifier": "EB13EE2B-5D63-4EBA-810F-5B81D07F5017",
    "ServerToken": "E180CA9A-F089-4FA3-BBDF-94CC159C4AE8",
    "Payload": {
        "VisibleName": "DNS Proxy",
        "AppBundleIdentifier": "com.example.mydnsproxyapp",
        "ProviderComposedIdentifier": "com.example.mydnsproxyapp.mydnsproxyprovider",
        "ProviderConfiguration": {
            "resolver": {
                "ipaddress": "9.9.9.9"
            }
        }
    }
}
```

## Topics

### Objects

[`NetworkDNSProxyProviderConfigurationObject`](/documentation/DeviceManagement/NetworkDNSProxyProviderConfigurationObject)

The dictionary of vendor-specific configuration items.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)