<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: 17.0.0 -",
    "macOS: 10.13.0 -",
    "tvOS: 17.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/8021XGlobalEthernet",
  "metadataVersion" : "0.1.0",
  "role" : "Device Management Profile",
  "symbol" : {
    "kind" : "Device Management Profile",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "mdm-profiles:8021XGlobalEthernet"
  },
  "title" : "8021XGlobalEthernet"
}
-->

# 8021XGlobalEthernet

The payload that configures the default fallback global Ethernet interface.

```
object 8021XGlobalEthernet
```

## Discussion

Specify `com.apple.globalethernet.managed` as the payload type.

This payload’s contents contain these profile-specific keys:

- Interface (String): This payload uses the value `GlobalEthernet`.
- EAPClientConfiguration ([`WiFi.EAPClientConfiguration`](/documentation/DeviceManagement/WiFi/EAPClientConfiguration-data.dictionary)): The dictionary that defines the enterprise profile for the network.
- SetupModes (String): The type of connection mode, which is either `System` or `Loginwindow`. `System` is the default.

### Profile availability

|||
|--------------------------|-----------------------------|
|Device channel            |iOS, macOS, Shared iPad, tvOS|
|User channel              |macOS                        |
|Allow manual install      |iOS, macOS, tvOS             |
|Requires supervision      |N/A                          |
|Requires user-approved MDM|N/A                          |
|Allowed in user enrollment|iOS, macOS                   |
|Allow multiple payloads   |N/A                          |

### Profile example

```plist
<?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">
<plist version="1.0">
<dict>
    <key>PayloadContent</key>
    <array>
        <dict>
            <key>AuthenticationMethod</key>
            <string></string>
            <key>AutoJoin</key>
            <true/>
            <key>CaptiveBypass</key>
            <false/>
            <key>EAPClientConfiguration</key>
            <dict>
                <key>AcceptEAPTypes</key>
                <array>
                    <integer>25</integer>
                </array>
                <key>UserName</key>
                <string>user</string>
                <key>UserPassword</key>
                <string>password</string>
            </dict>
            <key>EncryptionType</key>
            <string>WPA2</string>
            <key>HIDDEN_NETWORK</key>
            <false/>
            <key>Interface</key>
            <string>GlobalEthernet</string>
            <key>Password</key>
            <string>password</string>
            <key>ProxyType</key>
            <string>None</string>
            <key>SetupModes</key>
            <array>
                <string>System</string>
            </array>
            <key>PayloadIdentifier</key>
            <string>com.example.myglobalethpayload</string>
            <key>PayloadType</key>
            <string>com.apple.globalethernet.managed</string>
            <key>PayloadUUID</key>
            <string>f3d469f1-d7cc-45c5-ac2d-024195a6454b</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
        </dict>
    </array>
    <key>PayloadDisplayName</key>
    <string>802.1x Global Ethernet</string>
    <key>PayloadIdentifier</key>
    <string>com.example.myprofile</string>
    <key>PayloadType</key>
    <string>Configuration</string>
    <key>PayloadUUID</key>
    <string>9a0d652e-1ace-450c-9449-7bcc5d1d62c4</string>
    <key>PayloadVersion</key>
    <integer>1</integer>
</dict>
</plist>
```

---

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)