PayloadKit

802.1X Ethernet: Global

com.apple.globalethernet.managed

The payload that configures the default fallback global Ethernet interface.

iOS 17.0+macOS 10.13+tvOS 17.0+
Apple schemacombined

Only one instance per profile

Configuration Keys (3)

KeyTypeDescriptionDefaultRange

EAP Setup Modes

arraySelect "Login Window" to authenticate the Mac to the network when the user logs in.Default: —Range: —
SetupModestring

Setup Mode

string—Default: —Range: System (System), Login Window (Loginwindow)

EAP Client Configuration

dictSpecifies 802.1x EAP authentication parameters.Default: —Range: —

Accept EAP Types

required
arrayThe EAP types accepted.Default: —Range: —
EAPTypeinteger

EAP Type

integerAn integer representing an EAP type, inside of the Accept EAP Types array.Default: —Range: TLS (13), LEAP (17), TTLS (21), PEAP (25), EAP-FAST (43), EAP-SIM (18), EAP-AKA (23)
UserNamestring

Username

stringUsername. If not provided, the user may be prompted during login.Default: —Range: —

Password

stringPassword. If not provided, the user may be prompted during login.

Depends on: EAPClientConfiguration.AcceptEAPTypes; EAPClientConfiguration.OneTimeUserPassword

Default: —Range: —

Per-Connection Password

booleanIf set, the user will be prompted for a password each time they connect to the network.Default: falseRange: —

Certificate Anchor UUID

arrayArray of UUIDs corresponding to the trusted certificates for this authentication.Default: —Range: —

Individual Certificate Anchor UUID

stringA UUID for a trusted certificateDefault: —Range: —

Trusted Server Certificate Names

arrayCertificate Common Names expected from authentication server. The wildcard * can be used to match a range of strings.Default: —Range: —

Individual Trusted TLS Server Name

stringAn item in the TLS Trusted Server Names array representing a Common Name of a server certificate.Default: —Range: —

Inner Authentication

stringSpecifies the inner authentication used by the TTLS module.

Depends on: EAPClientConfiguration.AcceptEAPTypes

Default: "MSCHAPv2"Range: PAP, EAP, CHAP, MSCHAP, MSCHAPv2

Outer Identity

stringExternally visible identification (for TTLS, PEAP, and EAP-FAST). This string is used instead of the user's identity outside the encrypted tunnel. This value can be used to mask the true identity of the person using the network.Default: —Range: —

TLS Minimum Version

string—Default: "1.0"Range: 1.0, 1.1, 1.2, 1.3

TLS Maximum Version

string—Default: "1.2"Range: 1.0, 1.1, 1.2, 1.3

Use PAC

booleanIf set, the device will use an existing PAC if it's present. Otherwise the server must present its identity using a certificate.Default: falseRange: —

Provision PAC

booleanIf set, allows PAC provisioning.

Depends on: EAPClientConfiguration.AcceptEAPTypes; EAPClientConfiguration.EAPFASTUsePAC ∈ [true]

Default: falseRange: —

Provision PAC Anonymously

booleanIf set, provisions the device anonymously. Note that there are known man-in-the-middle attacks for anonymous provisioning.Default: falseRange: —

Number of RANDs

integerThe minimum number of RAND values accepted from the server. 3 is the default, and 2 is allowed, but offers less security.Default: 3Range: 2, 3

System Profile Credentials Source

stringUse an alternate set of credentials when in System mode (AKA not a loginwindow profile). This can be used to tell EAPOLClient to use the computer password in a bound active directory scenario for authentication.Default: —Range: ActiveDirectory

Use OpenDirectory System Profile Credentials

booleanThis indicates if the connection should try to use the OpenDirectory machine credentials.Default: falseRange: —

TLS Trusted Certificates

arrayAn array of trusted certificates. Each entry in the array must contain certificate data that represents an anchor certificate used for verifying the server certificate.Default: —Range: —
stringA certificate identifier.Default: —Range: —
booleanIf 'true', allows for two-factor authentication for EAP-TTLS, PEAP, or EAP-FAST. If 'false', allows for zero-factor authentication for EAP-TLS. If you don't specify a value, the default is 'true' for EAP-TLS, and 'false' for other EAP types.Default: —Range: —
Interfacestring

Interface

required
stringThe wired interface to useDefault: —Range: Any Ethernet (AnyEthernet)