OneX element

Article
06/24/2023

The OneX element specifies 802.1X configuration information for a wired or wireless LAN profile. This element is the unique root element for an 802.1X profile.

The target namespace for the OneX element is https://www.microsoft.com/networking/OneX/v1. Most child elements of the OneX element are in the OneX namespace. There is one exception: the EAPConfig element is in the https://www.microsoft.com/provisioning/EapHostConfig namespace.

Windows XP with SP3 and Wireless LAN API for Windows XP with SP2: Only the EAPConfig element is supported. Other elements, if present in a profile, will be ignored.

<xs:element name="OneX">
    <xs:complexType>
        <xs:sequence>
            <xs:element name="cacheUserData"
                minOccurs="0"
                type="boolean"
             />
            <xs:element name="heldPeriod"
                minOccurs="0"
             >
                <xs:simpleType>
                    <xs:restriction base="xs:integer">
                        <xs:minInclusive value="1">
                        <xs:maxInclusive value="3600">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="authPeriod"
                minOccurs="0"
             >
                <xs:simpleType>
                    <xs:restriction base="xs:integer">
                        <xs:minInclusive value="1">
                        <xs:maxInclusive value="3600">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="startPeriod"
                minOccurs="0"
             >
                <xs:simpleType>
                    <xs:restriction base="xs:integer">
                        <xs:minInclusive value="1">
                        <xs:maxInclusive value="3600">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="maxStart"
                minOccurs="0"
             >
                <xs:simpleType>
                    <xs:restriction base="xs:integer">
                        <xs:minInclusive value="1">
                        <xs:maxInclusive value="100">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="maxAuthFailures"
                minOccurs="0"
             >
                <xs:simpleType>
                    <xs:restriction base="xs:integer">
                        <xs:minInclusive value="1">
                        <xs:maxInclusive value="100">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="supplicantMode"
                minOccurs="0"
             >
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="inhibitTransmission">
                        <xs:enumeration value="includeLearning">
                        <xs:enumeration value="compliant">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="authMode"
                minOccurs="0"
             >
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="machineOrUser">
                        <xs:enumeration value="machine">
                        <xs:enumeration value="user">
                        <xs:enumeration value="guest">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="singleSignOn"
                minOccurs="0"
                ...
             />
            <xs:element name="EAPConfig"/>
            <xs:any
                processContents="lax"
                minOccurs="0"
                maxOccurs="unbounded"
                namespace="##other"
             />
        </xs:sequence>
    </xs:complexType>
</xs:element>

Parent elements

None.

Child elements

Element	Type	Description
cacheUserData	boolean	Specifies whether the user credentials are cached for subsequent connections.
heldPeriod		Specifies the length of time, in seconds, in which a client will not re-attempt authentication after a failed authentication attempt.
authPeriod		Specifies the maximum length of time, in seconds, in which a client waits for a response from the authenticator.
startPeriod		Specifies the length of time, in seconds, to wait before an EAPOL-Start is sent.
maxStart		Specifies the maximum number of EAPOL-Start messages sent.
maxAuthFailures		Specifies the maximum number of authentication failures allowed for a set of credentials.
supplicantMode		Specifies the method of transmission used for EAPOL-Start messages.
authMode		Specifies the type of credentials used for authentication.
singleSignOn		Specifies single sign-on (SSO) network configuration information.
EAPConfig		specifies the EAPHost configuration.

cacheUserData

The cacheUserData (OneX) element specifies whether the user credentials are cached for subsequent connections. When cacheUserData is TRUE, the credentials are cached. When cacheUserData is FALSE, the credentials are not cached and the user may be prompted for credentials on subsequent connection attempts.

This element is optional. When cacheUserData is not specified in a profile, the user credentials are cached.