%3CLINGO-SUB%20id%3D%22lingo-sub-1506375%22%20slang%3D%22en-US%22%3ESecure%20enterprise%20Wi-Fi%20access%3A%20EAP-TLS%20on%20Azure%20Sphere%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-1506375%22%20slang%3D%22en-US%22%3E%3CP%3EFor%20enterprise%20and%20industrial%20customers%20with%20connected%20equipment%20and%20devices%2C%20a%20higher%20level%20of%20network%20security%20is%20an%20important%20part%20of%20protecting%20business-critical%20investments%20and%20infrastructure.%20When%20bringing%20connected%20devices%20onto%20a%20corporate%20network%2C%20customers%20want%20control%20and%20visibility%20over%20exactly%20what%20devices%20are%20connected.%20Instead%20of%20authenticating%20a%20device%20to%20a%20network%20using%20a%20password%2C%20which%20can%20be%20shared%20among%20multiple%20devices%2C%20secured%20enterprise%20Wi-Fi%20relies%20on%20mechanisms%20to%20support%20unique%20authentication%20of%20each%20device.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EExtensible%20Authentication%20Protocol-Transport%20Layer%20Security%20(EAP-TLS)%20is%20a%20common%20authentication%20method%20used%20in%20such%20security-focused%2C%20enterprise%20scenarios.%20Azure%20Sphere%20supports%20the%20EAP-TLS%20protocol%20to%20secure%20the%20connections%20to%20an%20access%20point%20via%20certificates%20on%20a%20device.%20The%20use%20of%20device%20certificates%20is%20more%20secure%20than%20sharing%20a%20global%20key%20among%20all%20devices.%3C%2FP%3E%0A%3CP%3E%3CSPAN%20class%3D%22lia-inline-image-display-wrapper%20lia-image-align-center%22%20image-alt%3D%22EAP-TLS%20diagram.png%22%20style%3D%22width%3A%20517px%3B%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fgxcuf89792.i.lithium.com%2Ft5%2Fimage%2Fserverpage%2Fimage-id%2F204180i951CA8815D3F7A55%2Fimage-size%2Flarge%3Fv%3D1.0%26amp%3Bpx%3D999%22%20title%3D%22EAP-TLS%20diagram.png%22%20alt%3D%22EAP-TLS%20diagram.png%22%20%2F%3E%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3ETo%20use%20EAP-TLS%20to%20connect%20to%20an%20access%20point%2C%20the%20network%20administrator%20must%20configure%20a%20RADIUS%20server%20and%20the%20access%20point(s)%20for%20WPA2-Enterprise%20and%20EAP-TLS.%20In%20this%20scenario%20a%20certificate%20authority%20(CA)%20generates%20client%20and%20server%20authentication%20certificates%20for%20the%20devices%20as%20well%20as%20the%20RADIUS%20server.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EThis%20post%20does%20not%20cover%20the%20details%20for%20the%20customer%20network%20configuration%20or%20PKI%20components%3B%20these%20items%20are%20well%20documented%20for%20network%20administrators%20setting%20up%20an%20enterprise%20network.%20Azure%20Sphere%E2%80%99s%20implementation%20on%20the%20client%20ensures%20that%20the%20customer%20maintains%20control%20over%20the%20existing%20network%20and%20security%20infrastructure.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EThis%20post%20will%20cover%20the%20basic%20steps%20needed%20to%20load%20a%20valid%20certificate%2C%20to%20configure%20a%20new%20EAP-TLS%20network%20with%20the%20certificate%2C%20and%20to%20connect%20to%20your%20secured%20network%20via%20the%20command%20line%20or%20programmatically.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3E%3CU%3EHow%20to%20get%20started%3CBR%20%2F%3E%3CBR%20%2F%3E%3C%2FU%3E%3C%2FSTRONG%3E%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3ECertificate%20acquisition%3C%2FSTRONG%3E%3C%2FP%3E%0A%3CP%3EIn%20the%2020.04%20release%20of%20the%20Azure%20Sphere%20OS%2C%20we%20added%20the%20ability%20to%20connect%20to%20a%20secured%20Wi-Fi%20network%20via%20EAP-TLS.%20There%20are%20multiple%20ways%20a%20device%20can%20acquire%20a%20certificate%20with%20the%20private%20key.%20Which%20pattern%20you%20choose%20to%20use%20depends%20on%20your%20network%20as%20well%20as%20your%20manufacturing%20and%20distribution%20process%2C%20but%20it%20can%20be%20summarized%20into%20two%20methods%3A%3C%2FP%3E%0A%3COL%3E%0A%3CLI%3E%3CSTRONG%3E%3CEM%3ESideload%3C%2FEM%3E%3C%2FSTRONG%3E%20the%20data%20during%20manufacturing%20or%20upon%20delivery%20of%20a%20device%20from%20a%20connected%20computer%20that%20contains%20the%20data%20and%20uses%20the%20%3CSTRONG%3Eazsphere%3C%2FSTRONG%3E%20command%20line%20interface%20to%20load%20it.%3C%2FLI%3E%0A%3CLI%3E%3CSTRONG%3E%3CEM%3EBootstrap%20%3C%2FEM%3E%3C%2FSTRONG%3Ethe%20data%20via%20an%20existing%20open%20or%20PSK%20network%20which%20has%20internet%20access.%20In%20this%20scenario%2C%20you%20must%20ensure%20there%20is%20a%20secure%20delivery%20mechanism%2C%20such%20as%20an%20on-premises%20web%20service%20that%20can%20authenticate%2C%20manage%2C%20and%20securely%20transport%20the%20certificate%20and%20private%20key%20to%20the%20device.%3C%2FLI%3E%0A%3C%2FOL%3E%0A%3CP%3E%3CSTRONG%3ECertificate%20formats%3C%2FSTRONG%3E%3C%2FP%3E%0A%3CP%3EAzure%20Sphere%20supports%20RSA%20x509%20certificates%20in%20the%20.PEM%20file%20format%20in%20PKCS1%20and%20PKCS8%20syntax.%20Azure%20Sphere%20devices%20have%20about%2024KB%20of%20onboard%20storage%20for%20certificates%2C%20managed%20by%20the%20OS.%20Applications%20can%20use%20the%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fazure-sphere%2Freference%2Fapplibs-reference%2Fapplibs-certstore%2Fcertstore-overview%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noopener%20noreferrer%20noopener%20noreferrer%22%3ECertstore%20API%3C%2FA%3E%20to%20manage%20the%20certificates.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3EEnable%20%3C%2FSTRONG%3E%3CSTRONG%3Esecure%20enterprise%20Wi-Fi%20access%20using%20the%20azsphere%20command%20line%20tool%3C%2FSTRONG%3E%3C%2FP%3E%0A%3CP%3EDuring%20testing%20and%20development%2C%20use%20the%20%3CSTRONG%3Eazsphere%3C%2FSTRONG%3E%20command-line%20tool%20to%20quickly%20iterate%20and%20test%20device%20connectivity.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3ENew%20functionality%20in%20azsphere%20device%20certificate%20allows%20certificate%20management%3C%2FSTRONG%3E%3C%2FP%3E%0A%3CTABLE%3E%0A%3CTBODY%3E%0A%3CTR%3E%0A%3CTD%20width%3D%2292%22%3E%3CP%3E%3CSTRONG%3EVerb%3C%2FSTRONG%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22492%22%3E%3CP%3E%3CSTRONG%3EInformation%3C%2FSTRONG%3E%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%2292%22%3E%3CP%3Eadd%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22492%22%3E%3CP%3EAdds%20a%20certificate%20to%20the%20attached%20device's%20certificate%20store.%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%2292%22%3E%3CP%3Edelete%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22499%22%3E%3CP%3EDeletes%20a%20certificate%20from%20the%20attached%20device's%20certificate%20store.%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%2292%22%3E%3CP%3Elist%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22499%22%3E%3CP%3ELists%20the%20certificates%20in%20the%20attached%20device's%20certificate%20store.%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%2292%22%3E%3CP%3Eshow%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22492%22%3E%3CP%3EShows%20details%20about%20a%20certificate%20in%20the%20attached%20device's%20certificate%20store.%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%2294%22%3E%3CP%3Eshow-quota%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22490%22%3E%3CP%3EDisplays%20the%20available%20free%20space%20in%20the%20attached%20device's%20certificate%20store.%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3C%2FTBODY%3E%0A%3C%2FTABLE%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3ENew%20parameters%20in%20azsphere%20device%20wifi%20add%3C%2FSTRONG%3E%3C%2FP%3E%0A%3CTABLE%3E%0A%3CTBODY%3E%0A%3CTR%3E%0A%3CTD%20width%3D%22120%22%3E%3CP%3EVerb%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22464%22%3E%3CP%3EInformation%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%22120%22%3E%3CP%3Eclientcertid%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22464%22%3E%3CP%3EA%20string%20value%20(up%20to%2016%20characters)%20that%20identifies%20the%20client%20certificate%20(containing%20both%20the%20public%20and%20private%20key).%20Required%20to%20set%20up%20an%20EAP-TLS%20etwork.%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%22120%22%3E%3CP%3Eclientid%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22464%22%3E%3CP%3EID%20recognized%20for%20authentication%20by%20this%20network's%20RADIUS%20server.%20Required%20for%20some%20EAP-TLS%20networks.%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%22120%22%3E%3CP%3Erootcacertid%3C%2FP%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%22464%22%3E%3CP%3EA%20string%20value%20(up%20to%2016%20characters)%20that%20identifies%20the%20server's%20root%20CA%20certificate%20for%20EAP-TLS%20networks%20where%20the%20device%20authenticates%20the%20server.%3C%2FP%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3C%2FTBODY%3E%0A%3C%2FTABLE%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3EProgramming%20model%3C%2FSTRONG%3E%3C%2FP%3E%0A%3CP%3EBefore%20an%20application%20can%20load%20certificates%2C%20its%20application%20manifest%20(app_manifest.json)%20must%20include%20the%20new%20CertStore%20capability.%20Likewise%2C%20to%20enable%20secure%20enterprise%20Wi-Fi%20access%2C%20the%20application%20manifest%20must%20include%20the%20EnterpriseWifiConfig%20capability.%3C%2FP%3E%0A%3CP%3E%3CSPAN%20class%3D%22lia-inline-image-display-wrapper%20lia-image-align-center%22%20image-alt%3D%22EAP-TLS%20code%20image.png%22%20style%3D%22width%3A%20780px%3B%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fgxcuf89792.i.lithium.com%2Ft5%2Fimage%2Fserverpage%2Fimage-id%2F204181i56AA4D522D460005%2Fimage-size%2Flarge%3Fv%3D1.0%26amp%3Bpx%3D999%22%20title%3D%22EAP-TLS%20code%20image.png%22%20alt%3D%22EAP-TLS%20code%20image.png%22%20%2F%3E%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EThe%20certificate%20data%20consists%20of%20the%20client%20authentication%20certificate%2C%20its%20corresponding%20private%20key%2C%20and%20the%20public%20certificate%20for%20the%20RootCA%20of%20the%20RADIUS%20server.%20After%20this%20data%20is%20loaded%2C%20the%20application%20must%20set%20the%20WifiConfig_Security_Wpa2_EAP_TLS%20flag%20used%20to%20indicate%20that%20the%20Wi-Fi%20security%20type%20is%20EAP-TLS.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EThe%20certificate%20data%20is%20then%20associated%20with%20the%20network%2C%20so%20the%20device%20can%20connect%20to%20the%20network%20using%20the%20specified%20client%20ID%20and%20certificate%20data.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3E%3CU%3ENext%20Steps%3C%2FU%3E%3C%2FSTRONG%3E%3C%2FP%3E%0A%3CP%3ECheck%20out%20the%20EAP-TLS%20feature%20overview%3A%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fazure-sphere%2Fnetwork%2Feap-tls-overview%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noopener%20noreferrer%20noopener%20noreferrer%22%3Ehttps%3A%2F%2Fdocs.microsoft.com%2Fazure-sphere%2Fnetwork%2Feap-tls-overview%3C%2FA%3E%3C%2FP%3E%0A%3CP%3ESamples%20are%20available%3A%3C%2FP%3E%0A%3COL%3E%0A%3CLI%3ELoading%20and%20managing%20certificates%3A%20%3CA%20href%3D%22https%3A%2F%2Fgithub.com%2FAzure%2Fazure-sphere-samples%2Ftree%2Fmaster%2FSamples%2FCertificates%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noopener%20noreferrer%20noopener%20noreferrer%22%3Ehttps%3A%2F%2Fgithub.com%2FAzure%2Fazure-sphere-samples%2Ftree%2Fmaster%2FSamples%2FCertificates%3C%2FA%3E%3C%2FLI%3E%0A%3CLI%3EConfiguring%20secure%20enterprise%20Wi-Fi%20access%3A%20%3CA%20href%3D%22https%3A%2F%2Fgithub.com%2FAzure%2Fazure-sphere-samples%2Ftree%2Fmaster%2FSamples%2FWiFi%2FWiFi_HighLevelApp%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noopener%20noreferrer%20noopener%20noreferrer%22%3Ehttps%3A%2F%2Fgithub.com%2FAzure%2Fazure-sphere-samples%2Ftree%2Fmaster%2FSamples%2FWiFi%2FWiFi_HighLevelApp%3C%2FA%3E%3C%2FLI%3E%0A%3C%2FOL%3E%3C%2FLINGO-BODY%3E%3CLINGO-TEASER%20id%3D%22lingo-teaser-1506375%22%20slang%3D%22en-US%22%3E%3CP%3EAzure%20Sphere%20supports%20the%20EAP-TLS%20protocol%20to%20secure%20the%20connections%20to%20an%20access%20point%20via%20certificates%20on%20a%20device.%20The%20use%20of%20device%20certificates%20is%20more%20secure%20than%20sharing%20a%20global%20key%20among%20all%20devices.%3C%2FP%3E%3C%2FLINGO-TEASER%3E%3CLINGO-LABS%20id%3D%22lingo-labs-1506375%22%20slang%3D%22en-US%22%3E%3CLINGO-LABEL%3Eazure%20sphere%3C%2FLINGO-LABEL%3E%3CLINGO-LABEL%3EAzure%20Sphere%20features%3C%2FLINGO-LABEL%3E%3C%2FLINGO-LABS%3E
Microsoft

For enterprise and industrial customers with connected equipment and devices, a higher level of network security is an important part of protecting business-critical investments and infrastructure. When bringing connected devices onto a corporate network, customers want control and visibility over exactly what devices are connected. Instead of authenticating a device to a network using a password, which can be shared among multiple devices, secured enterprise Wi-Fi relies on mechanisms to support unique authentication of each device.

 

Extensible Authentication Protocol-Transport Layer Security (EAP-TLS) is a common authentication method used in such security-focused, enterprise scenarios. Azure Sphere supports the EAP-TLS protocol to secure the connections to an access point via certificates on a device. The use of device certificates is more secure than sharing a global key among all devices.

EAP-TLS diagram.png

 

To use EAP-TLS to connect to an access point, the network administrator must configure a RADIUS server and the access point(s) for WPA2-Enterprise and EAP-TLS. In this scenario a certificate authority (CA) generates client and server authentication certificates for the devices as well as the RADIUS server.

 

This post does not cover the details for the customer network configuration or PKI components; these items are well documented for network administrators setting up an enterprise network. Azure Sphere’s implementation on the client ensures that the customer maintains control over the existing network and security infrastructure.

 

This post will cover the basic steps needed to load a valid certificate, to configure a new EAP-TLS network with the certificate, and to connect to your secured network via the command line or programmatically.

 

How to get started

Certificate acquisition

In the 20.04 release of the Azure Sphere OS, we added the ability to connect to a secured Wi-Fi network via EAP-TLS. There are multiple ways a device can acquire a certificate with the private key. Which pattern you choose to use depends on your network as well as your manufacturing and distribution process, but it can be summarized into two methods:

  1. Sideload the data during manufacturing or upon delivery of a device from a connected computer that contains the data and uses the azsphere command line interface to load it.
  2. Bootstrap the data via an existing open or PSK network which has internet access. In this scenario, you must ensure there is a secure delivery mechanism, such as an on-premises web service that can authenticate, manage, and securely transport the certificate and private key to the device.

Certificate formats

Azure Sphere supports RSA x509 certificates in the .PEM file format in PKCS1 and PKCS8 syntax. Azure Sphere devices have about 24KB of onboard storage for certificates, managed by the OS. Applications can use the Certstore API to manage the certificates.

 

Enable secure enterprise Wi-Fi access using the azsphere command line tool

During testing and development, use the azsphere command-line tool to quickly iterate and test device connectivity.

 

New functionality in azsphere device certificate allows certificate management

Verb

Information

add

Adds a certificate to the attached device's certificate store.

delete

Deletes a certificate from the attached device's certificate store.

list

Lists the certificates in the attached device's certificate store.

show

Shows details about a certificate in the attached device's certificate store.

show-quota

Displays the available free space in the attached device's certificate store.

 

New parameters in azsphere device wifi add

Verb

Information

clientcertid

A string value (up to 16 characters) that identifies the client certificate (containing both the public and private key). Required to set up an EAP-TLS etwork.

clientid

ID recognized for authentication by this network's RADIUS server. Required for some EAP-TLS networks.

rootcacertid

A string value (up to 16 characters) that identifies the server's root CA certificate for EAP-TLS networks where the device authenticates the server.

 

Programming model

Before an application can load certificates, its application manifest (app_manifest.json) must include the new CertStore capability. Likewise, to enable secure enterprise Wi-Fi access, the application manifest must include the EnterpriseWifiConfig capability.

EAP-TLS code image.png

 

The certificate data consists of the client authentication certificate, its corresponding private key, and the public certificate for the RootCA of the RADIUS server. After this data is loaded, the application must set the WifiConfig_Security_Wpa2_EAP_TLS flag used to indicate that the Wi-Fi security type is EAP-TLS.

 

The certificate data is then associated with the network, so the device can connect to the network using the specified client ID and certificate data.

 

Next Steps

Check out the EAP-TLS feature overview: https://docs.microsoft.com/azure-sphere/network/eap-tls-overview

Samples are available:

  1. Loading and managing certificates: https://github.com/Azure/azure-sphere-samples/tree/master/Samples/Certificates
  2. Configuring secure enterprise Wi-Fi access: https://github.com/Azure/azure-sphere-samples/tree/master/Samples/WiFi/WiFi_HighLevelApp