How To Distribute Network Profiles to Windows Devices via ManageEngine Mobile Device Manager Plus

Learn how to create and distribute Keytos Shield Wi-Fi profiles to ManageEngine Windows Devices for certificate-based authentication.

Overview - How to Distribute Network Profiles to Windows Devices via ManageEngine

To connect your ManageEngine Windows Devices to your network, you need to distribute a configuration profile that includes the necessary network settings, authentication methods, and certificates. This guide will walk you through the steps to configure and push these profiles to Windows Devices using ManageEngine for EAP-TLS.

Step-by-Step Guide - How To Configure Network Profile ManageEngine Configuration Policies for Windows Devices

Follow these steps to configure and push the necessary ManageEngine configuration policies for Windows Devices:

Prerequisites for Configuring Windows Network Profiles via ManageEngine

Before you begin configuring network profiles for Windows Devices via ManageEngine, ensure that you have completed all the necessary prerequisites:

  1. The Keytos Entra ID applications are registered in your tenant.
  2. You have signed up for a Keytos Shield Plan.
  3. You have existing access policies in Keytos Shield.
  4. You are a Subscription Owner or Network Administrator.
  5. You are an ManageEngine Administrator.

Step 1 - How to Push your Shield CA Certificates as Trusted Certificates in ManageEngine

The first step is to push your Shield CA certificates as trusted certificates in ManageEngine. This ensures that your Windows devices recognize and trust the certificates issued by your Shield CA.

How to Download Your Root and Issuing CA Certificates in Keytos Shield

Begin by downloading your Root and Issuing CA certificates from the Keytos Shield portal.

If you are still working through the onboarding guide, you can simply download the Root and Issuing CA certificate without leaving the page.

  1. Scroll down and expand step 6, Set Up Mobile Device Management (MDM).

  2. Expand the ManageEngine subsection.

    Not seeing the ManageEngine subsection? Make sure to enable ManageEngine in step 2, Tell us about your environment and save your changes.

  3. Next to rootca.cer, click Download and save it to your local machine.

  4. Next to issuingca.cer, click Download and save it to your local machine as well.

    Keytos Shield Download Root CA and Issuing CA Certificate File button highlighted

If you’ve already gone through the onboarding guide, you can download your Root and Issuing CA certificates from the Network profiles page.

  1. Log in to your Keytos Shield portal.

  2. From the left-hand navigation bar, click on Network Profiles.

  3. At the top of the page, select the Settings tab.

    Keytos Shield Settings tab highlighted
  4. Scroll down to the Certificate Authority and Enrollment section and expand the ManageEngine subsection.

    Not seeing the ManageEngine subsection? Make sure to enable ManageEngine under the Mobile Device Management section further up on the page and save your changes.

  5. Next to rootca.cer, click Download and save it to your local machine.

  6. Next to issuingca.cer, click Download and save it to your local machine as well.

    Keytos Shield Download Root CA and Issuing CA Certificate File button highlighted

How to Upload Your Shield CA Certificates to ManageEngine

Now that you have downloaded your Shield Root and Issuing CA certificates, you can upload them to ManageEngine.

  1. In your ManageEngine Mobile Device Manager Plus portal, navigate to the Device Mgmt page.

  2. Using the left-hand menu, under Manage select Certificates.

    ManageEngine Mobile Device Manager Plus Device Mgmt page with Certificates page highlighted
  3. Using the tabs at the top of the Certificates page, ensure you are on Certificates.

    ManageEngine Mobile Device Manager Plus Device Mgmt page with Certificates tab highlighted
  4. Click the + Add Certificate button.

    ManageEngine Mobile Device Manager Plus Device Mgmt page with Add Certificate button highlighted
  5. Upload the Root CA certificate you just downloaded from Keytos Shield. ManageEngine Mobile Device Manager Plus Device Mgmt page with Upload Certificate button highlighted

  6. Once uploaded, click Add Certificate.

  7. If you also have an Issuing CA certificate, repeat the above steps to upload it as well.

How to Add Your Shield CA Certificates to a ManageEngine Profile

To add your Shield CA certificates to a ManageEngine profile, follow these steps:

  1. From Device Mgmt, navigate to Profiles.

    Navigate to Profiles
  2. Either selecting an existing Profile Name or select + Create Profile.

    Select a Profile
  3. From the left-hand nav-bar, select Certificate.

    Select Certificate
  4. From the Certificate drop-down menu, select the Root CA certificate that you uploaded earlier and then click Save.

    Select Root CA Certificate
  5. Click the Publish button to apply the changes to the profile. We’ll come back to this in a bit to finish configuring the profile.

  6. Done. This certificate will now be pushed to all devices that are associated with this profile.

Step 2 - How to Create a CA Server for Windows Devices in ManageEngine

A SCEP (Simple Certificate Enrollment Protocol) certificate allows your Windows device to authenticate with its own unique certificate, which can be used for secure network access and other authentication purposes. Follow these steps to issue a SCEP certificate to your Windows device via ManageEngine.

How to Get Your Keytos Shield Static SCEP URL and Password

Begin by retrieving your Keytos Shield Static SCEP URL and password from the Keytos Shield portal.

If you are still working through the onboarding guide, you can simply copy the static SCEP URL without leaving the page.

  1. Scroll down and expand step 6, Set Up Mobile Device Management (MDM).

  2. Expand the ManageEngine subsection.

    Not seeing the ManageEngine subsection? Make sure to enable ManageEngine in step 2, Tell us about your environment and save your changes.

  3. Next to Static SCEP URL, click Copy. You’ll need this in a little bit.

    Keytos Shield Copy Static SCEP URL button highlighted

If you’ve already gone through the onboarding guide, you can copy the static SCEP URL directly from the network profiles page.

  1. Log in to your Keytos Shield portal.

  2. From the left-hand menu, navigate to Network profiles.

  3. At the top of the page, select the Settings tab.

    Keytos Shield Settings tab highlighted
  4. Expand Certificate Authority and Enrollment, and then expand the ManageEngine subsection.

    Not seeing the ManageEngine subsection? Make sure to enable ManageEngine under the Mobile Device Management section further up on the page and save your changes.

  5. Click the Copy button next to the Static SCEP URL.

    Keytos Shield Copy Static SCEP URL button highlighted
  6. Click the Copy button next to the Static SCEP password to copy the password without displaying it. You will need both values when you create the SCEP profile in your MDM.

How to Create a SCEP CA Server in ManageEngine

Now that you have your SCEP URL, you will have to create a SCEP CA Server in ManageEngine.

  1. In your ManageEngine Mobile Device Manager Plus portal, navigate to the Device Mgmt page.

  2. Under Manage select Certificates.

    ManageEngine Mobile Device Manager Plus page with Certificates page highlighted
  3. Using the tabs at the top of the Certificates page, ensure you are on CA Servers.

    ManageEngine Mobile Device Manager Plus with CA Server page highlighted
  4. Click the + Add CA Server button.

    ManageEngine Mobile Device Manager Plus with Add CA Server button highlighted
  5. For the Server Type dropdown, select Generic SCEP.

    ManageEngine Mobile Device Manager Plus with Server Type dropdown highlighted
  6. Give the CA a friendly name.

  7. Paste the SCEP URL you copied from Keytos Shield.

    ManageEngine Mobile Device Manager Plus with SCEP URL textbox highlighted
  8. For the CA certificate dropdown, select the issuing CA certificate you previously added to ManageEngine.

    ManageEngine Mobile Device Manager Plus with CA Certificate dropdown highlighted
  9. Click Save at the bottom of the page.

Step 3 - How to Create a SCEP Template in ManageEngine

The following steps will guide you on how to create a ManageEngine SCEP profile to issue device certificates to your Windows devices.

How to Create a SCEP CA Template in ManageEngine

  1. In your ManageEngine Mobile Device Manager Plus portal, navigate to the Device Mgmt page.

  2. Under Manage select Certificates.

    ManageEngine Mobile Device Manager Plus Device Mgmt page with Certificates tab highlighted
  3. Using the tabs at the top of the Certificates page, select Templates.

    ManageEngine Mobile Device Manager Plus Device Mgmt with Templates tab on Certificates page highlighted
  4. Click the + Add Template button.

    ManageEngine Mobile Device Manager Plus Device Mgmt with Add Template button on Templates page highlighted
  5. For the Select server dropdown, select the server you just created.

    ManageEngine Mobile Device Manager Plus Device Mgmt with Select Server Dropdown on Certificate Template page highlighted.
  6. Specify a friendly name for the Certificate Template Name.

  7. For the Subject field, enter:

    • User Certificates: CN=%username%
    • Device Certificates: CN=%devicename%
  8. For the Subject Alternative Name Type dropdown, select RFC 822 Name.

  9. Set the Subject Alternative Name Value:

    • User Certificates: %email%
    • Device Certificates: %devicename%
    ManageEngine Mobile Device Manager Plus Device Mgmt with Subject field on Certificate Template page highlighted.
  10. Set NT Principal Name to:

    • User Certificates: %username%
    • Device Certificates: %devicename%@ezradius.io
  11. Enter the following values:

    • Maximum number of failed attempts: 10.
    • Time interval between attempts: 5 seconds.
    • Challenge type: Static.
    • Enrollment challenge password: paste the SCEP challenge you copied from Keytos Shield.
    • Key Size: 2048.
    • Use as Digital Signature: Yes.
    • Use for Key Encipherment: Yes.
    • Certificate Automatic Renewal Before: 15 days.
    ManageEngine Mobile Device Manager Plus Device Mgmt with Maximum number of failed attempts, key usage, renewal time, and key size values configured for RADIUS authentication on Certificate Template page.
  12. Scroll to the bottom of the page and click Save.

  13. Repeat these steps for all CA server(s) you added to ManageEngine.

Step 4 - How to Create a Wi-Fi Profile in ManageEngine for Certificate-Based Authentication

Now that you have all the building blocks in place, you can create a Wi-Fi profile that uses certificate-based authentication for your Windows devices.

How to Configure a SCEP Profile in ManageEngine

Begin by configuring a SCEP certificate in your profile.

  1. From Device Mgmt, navigate to Profiles.

    Navigate to Profiles
  2. Either selecting an existing Profile Name or select + Create Profile.

    Select a Profile
  3. Give the profile a name then click Continue.

  4. Set the Profile Type to MDM Profile.

  5. On the Configure Profile page, navigate to the SCEP section using the left-hand menu.

    ManageEngine Mobile Device Manager Plus Wi-Fi Configuration page with SCEP Template highlighted
  6. For Certificate Type, select Device to make your ManageEngine devices use device certificates or User for user certificates.

  7. From the Key storage provider (KSP) dropdown, select Enroll to trusted Platform Module (TPM) KSP if present, otherwise Software KSP.

    ManageEngine Mobile Device Manager Plus Wi-Fi Configuration page with Key storage provider highlighted
  8. Select the SCEP Template you previously created.

    ManageEngine Mobile Device Manager Plus Wi-Fi Configuration page with SCEP Template highlighted
  9. Scroll down the bottom of the page and click Save.

How to Configure a Wi-Fi Profile in ManageEngine

Next, add a Wi-Fi profile to your profile.

  1. Click on the Wi-Fi section using the left-hand menu.

    ManageEngine Mobile Device Manager Plus Wi-Fi Configuration page with Wi-Fi tab highlighted
  2. In the Wi-Fi SSID textbox, type the SSID of your Wi-Fi network (this is case sensitive). ManageEngine Mobile Device Manager Plus Wi-Fi Configuration page with Wi-Fi SSID highlighted

  3. Enable Connect to this Wi-Fi automatically if you would like devices to automatically join the network without prompting users.

  4. Select Yes for Hidden network only if your Wi-Fi access point does not broadcast its SSID.

  5. Set the Security type to WPA2-Enterprise.

    ManageEngine Mobile Device Manager Plus Wi-Fi Configuration page with Wi-Fi Security type
  6. From the EAP method dropdown, select TLS.

  7. In the CA certificate dropdown, select the Root CA certificate you previously uploaded.

    ManageEngine Mobile Device Manager Plus Wi-Fi Configuration page with CA certificate highlighted
  8. Scroll down to the bottom of the page and click Save.

  9. Once the profile is saved, click Publish.

Done! You have now created a Wi-Fi profile for EAP-TLS authentication in ManageEngine.

Step 5 - How to Associate Your Wi-Fi Profile to Groups or Devices in ManageEngine

Now that you have create a Wi-Fi profile for certificate-based authentication, you will need to distribute it to all your Windows devices.

  1. In your ManageEngine Mobile Device Manager Plus portal, navigate to the Device Mgmt page.

  2. Using the left-hand menu, under Manage select Groups & Devices.

  3. Select any Group, Device, or User you would like to add this Wi-Fi profile to.

  4. Click Action > Associate Profile > Configuration Profile.

    ManageEngine Group & Devices page with Associate Profile button highlighted
  5. Under Available Profiles select the Windows Wi-Fi profile you just created.

    ManageEngine Available Profiles page with Windows Profile highlighted
  6. At the bottom of the page, click Associate.

Done! Your Wi-Fi profile is now created and will be pushed to your devices. Once the profile is applied, users will be able to connect to the Wi-Fi network using certificates.

How to Test the Wi-Fi Certificate Authentication Setup

Now that you have created and deployed the Wi-Fi profile, it’s important to test the setup to ensure everything is functioning correctly. Follow these steps to test your Wi-Fi profile:

  1. On a managed Windows device, go to Settings > Network & Internet > Wi-Fi > Manage known networks. You should see the SSID you configured in the list.
  2. If you use User-based certificate authentication, attempt to connect to the Wi-Fi network. You should be connected without being prompted for a username or password. If you use Device-based certificates, the device should connect automatically without user interaction. You may need to restart the device to trigger the connection.

How to Troubleshoot RADIUS Authentication for Keytos Shield

If you are unable to connect to your network, refer to our troubleshooting guide.

Shield RADIUS Troubleshooting Guide