Microsoft Intune
Fundamentals

Configure Infrastructure to Support SCEP Certificate Profiles with Microsoft Intune - Microsoft Intune | Microsoft Learn

In brief

The article received capitalization, grammar, wording, metadata, and authoring-reference updates. Its guidance continues to cover configuring the on-premises AD domain, certification authority, NDES server, and Certificate Connector for SCEP.

What Intune admins need to know

Use the refreshed article as the current reference when configuring SCEP infrastructure.

This summary was assembled from the tracked documentation change. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

Configure infrastructureInfrastructure to supportSupport SCEP certificate profilesCertificate Profiles with Microsoft Intune - Microsoft Intune | Microsoft Learn

Important

To support Windows requirements for strong mapping of SCEP certificates that were introduced and announced in KB5014754 from May 10, 2022 we’ve, Microsoft made changes to Intune SCEP certificate issuance for new and renewed SCEP certificates. With these changes, new or renewed Intune SCEP certificates for iOS/iPadOS, macOS, and Windows now include the following tag in the Subject Alternative Name (SAN) field of the certificate: URL=tag:microsoft.com,2022-09-14:sid:<value>

ThisStrong mapping uses this tag is used by strong mapping to tie a certificate to a specific device or user SID from Entra ID. With this change and requirement to map a SID from Entra ID:

  • Device certificates are supported for Windows hybrid-joined devices when that device has a SID in Entra ID that has beenis synchronized from an on-premises Active Directory.
  • User certificates use the User's SID from Entra ID, synced from on-premises Active Directory.

Certification Authorities (CAs) that do notdon't support the URL tag in the SAN might fail to issue certificates. Microsoft Active Directory Certificate Services servers that installed the update from KB5014754 support the use of this tag. If you use a third-party CA, check with your CA provider to ensure they support this format, or how and when this support will be added.they plan to add support.

For more information, see Support tip: Implementing strong mapping in Microsoft Intune certificates - Microsoft Community Hub.

Intune supports use of the Simple Certificate Enrollment Protocol (SCEP) to authenticate connections to your apps and corporate resources. SCEP uses the Certification Authority (CA) certificate to secure the message exchange for the Certificate Signing Request (CSR). When your infrastructure supports SCEP, you can use Intune SCEP certificate profiles (a type of device profile in Intune) to deploy the certificates to your devices.

TheYou need the Certificate Connector for Microsoft Intune is required to use SCEP certificate profiles with Intune when you also use an Active Directory Certificate Services Certification Authority, also called a Microsoft CA. The connector isnYou can't supporteduse the connector on the same server as your issuing Certification Authority (CA). TheAuthority. You don't need the connector isn't required when usingyou use Third-party Certification Authorities.

The information in thisThis article can help you configure your infrastructure to support SCEP when usingyou use Active Directory Certificate Services. After you configure your infrastructure is configured,infrastructure, you can create and deploy SCEP certificate profiles with Intune.

Tip

Prerequisites for using SCEP for certificates

Before you continue, ensure you've create and deploy a trusted certificate profile to devices that use SCEP certificate profiles. SCEP certificate profiles directly reference the trusted certificate profile that you use to provision devices with a Trusted Root CA certificate.

  • Servers and server roles
  • Accounts

To support SCEP, the following on-premises infrastructure must run on servers that are domain-joined to your Active Directory, with the exception of the Web Application Proxy Server.

  • Certificate Connector for Microsoft Intune – The Certificate Connector for Microsoft Intune is required to. To use SCEP certificate profiles with Intune when you use a Microsoft CA. It installsCA, you need the Certificate Connector for Microsoft Intune. Install it on the server that also runs the NDES server role. However, theThe connector isn't supported on the same server as your issuing Certification Authority (CA).

    For information about the certificate connector, see:

  • Certification Authority –. Use a Microsoft Active Directory Certificate Services Enterprise Certification Authority (CA) that runs on an Enterprise edition of Windows Server 2008 R2 with service pack 1, or later. The version of Windows Server you use must remain in support by Microsoft. A Standalone CA isn't supported. For more information, see Install the Certification Authority.

    If your CA runs Windows Server 2008 R2 SP1, you must install the hotfix from KB2483564.

  • NDES server role –. To support using the Certificate Connector for Microsoft Intune with SCEP, you must configure the Windows Server that hosts the certificate connector with the Network Device Enrollment Service (NDES) server role. The connector supports installation on Windows Server 2012 R2 or later. In a later section of this article, we guide you through installinginstall NDES.

    • The server that hosts NDES and the connector must be domain-joined and in the same forest as your Enterprise CA.
    • The server that hosts NDES must not be a domain controller.

Support for NDES on the internet

To allow devices on the internet to get certificates, you must publish your NDES URL external to your corporate network. To do this, youYou can use a reverse proxy like Microsoft Entra application proxy, Microsoft's Web Application Proxy Server, or a third-party reverse proxy service or device.

  • Microsoft Entra application proxy –. You can use the Microsoft Entra application proxy instead of a dedicated Web Application Proxy (WAP) Server to publish your NDES URL to the internet. This solution allows both intranet and internet facing devices to get certificates. For more information, see Integrate with Microsoft Entra application proxy on a Network Device Enrollment Service (NDES) server.

  • Web Application Proxy Server -. Use a server that runs Windows Server 2012 R2 or later as a Web Application Proxy (WAP) server to publish your NDES URL to the internet. This solution allows both intranet and internet facing devices to get certificates.

    The server that hosts WAP must install an update that enables support for the long URLs that are used by the Network Device Enrollment Service. This update is included with the December 2014 update rollup, or individually from KB3011135.

    The WAP server must have an SSL certificate that matches the name that's published to external clients and trust the SSL certificate that's used on the computer that hosts the NDES service. These certificates enable the WAP server to terminate the SSL connection from clients and create a new SSL connection to the NDES service.

    For more information, see Plan certificates for WAP and general information about WAP servers.

  • Third-party reverse proxy –. When you use a third-party reverse proxy, ensure that the proxy supports a long URI get request. As part of the certificate request flow, the client makes a request with the certificate request in the query string. As a result, the URI length can be large, up to 40 kb in size.

SCEP protocol limitations prevent use of preauthentication. When you publish the NDES URL viaby using a reverse proxy server, you must have Pre Authentication set to Passthrough.

Intune secures the NDES URL when you install the Intune Certificate connector,connector by installing an Intune-SCEP policy module on the NDES server. The module helps to secure the NDES URL by preventing certificates from being issued to invalid or digitally tampered certificate requests. This approach limits access to only Intune enrolled devices that you manage with Intune and that have well-formed certificate requests.

When an Intune SCEP certificate profile is delivered to a device, Intune generates a custom challenge blob that it encrypts and signs. The blob isn't readable by the device. Only the policy module and the Intune service can read and verify the challenge blob. The blob includes details that Intune expects to be provided by the device in its certificate signing request (CSR). For example, the expected Subject and Subject Alternative Name (SAN).

Accounts

To configure the connector to support SCEP, use an account that has permissions to configure NDES on the Windows Server and to manage your Certification Authority. For details,more information, see Accounts in the Prerequisites for the Certificate Connector for Microsoft Intune article..

Network requirements

In addition to the network requirements for the certificate connector, we recommend publishing the NDES service through a reverse proxy, such as the Microsoft Entra application proxy, Web Access Proxy, or a third-party proxy. If you don't use a reverse proxy, then allow TCP traffic on port 443 from all hosts and IP addresses on the internet to the NDES service.

Allow all ports and protocols necessary for communication between the NDES service and any supporting infrastructure in your environment. For example, the computer that hosts the NDES service needs to communicate with the CA, DNS servers, domain controllers, and possibly other services or servers withinin your environment, like Configuration Manager.

Certificates and templates

Object Details
SCEP Certificate Template Template that you configure on your issuing CA that's used to fullfilfulfill the devices SCEP requests.
Server authentication certificate Web Server certificate requested from your issuing CA or public CA. You install and bind this SSL certificate in IIS on the computer that hosts NDES.
Trusted Root CA certificate To use a SCEP certificate profile, devices must trust your Trusted Root Certification Authority (CA). Use a trusted certificate profile in Intune to provision the Trusted Root CA certificate to users and devices. - Use a single Trusted Root CA certificate per operating system platform and associate that certificate with each trusted certificate profile you create. - You can use additional Trusted Root CA certificates when needed. For example, you might use additional certificates to provide a trust to a CA that signs the server authentication certificates for your Wi-Fi access points. Create additional Trusted Root CA certificates for issuing CAs. In the SCEP certificate profile you create in Intune, be sure to specify the Trusted Root CA profile for the issuing CA. For information about the trusted certificate profile, see Export the trusted root CA certificate and Create trusted certificate profiles in Use certificates for authentication in Intune.

Note

The following certificate is notisn't used with the Certificate Connector for Microsoft Intune. This information is provided for those who have not yet replaceddidn't replace the older connector for SCEP (installed by NDESConnectorSetup.exe) with the new connector software.

Object Details
For Android Enterprise, the version of encryption on a device determines whether the device must be configured with a PIN before SCEP can provision that device with a certificate. The available encryption types are:
  • Full-disk encryption, which requires the device have a PIN configured.
  • File-based encryption, which is required on devices that are installed by the OEMmanufacturer installs with Android 10 or later. These devices wondon't require a PIN. Devices that upgrade to Android 10 might still require a PIN.

Note

The version of Android on a device can affect the available encryption type:

  • Android 10 and later: Devices installedthat the hardware manufacturer installs with Android 10 or later by the OEM use file-based encryption and wondon't require a PIN for SCEP to provision a certificate. Devices that upgrade to version 10 or later and begin to use file-based encryption might still require a PIN.
  • Android 8 to 9: These versions of Android support the use of file-based encryption, but itdon's not required.t require it. Each OEMmanufacturer chooses which encryption type to implement for a device. It's also possible that OEMmanufacturer modifications will result in a PIN not being required even when full-disk encryption is in use.

For more information, see the following articles in the Android documentation:

For devices that run 9.0 and later and receive a kiosk-mode policy, you can use a device compliance or device configuration policy to enforce the password requirement. View Support Tip: New Google-based Compliance Screens for Kiosk Mode from the Intune Support Team, to understand the device experience.

For devices that run 8.x and earlier, you can also use a device compliance or device configuration policy to enforce the password requirement. However, toTo set up a PIN, you need to manually enter the settings application on the device and configure the PIN.

Configure the certification authority

In the following sections, you'll:you:

  • Configure and publish the required template for NDESNDES.
  • Set the required permissions for certificate revocation.

The following sections require knowledge of Windows Server 2012 R2 or later, and of Active Directory Certificate Services (AD CS).

Access your Issuingissuing CA

  1. Sign in to your issuing CA with a domain account withthat has rights sufficient to manage the CA.
  2. Open the Certification Authority Microsoft Management Console (MMC). Either Run 'certsrv.msc' or or, in Server Manager, select Tools, and then Certification Authority.
  3. Select the Certificate Templates node, select Action > Manage.

Create the SCEP certificate template

  1. Create a v2 Certificate Template (withwith Windows 2003 compatibility)compatibility for use as the SCEP certificate template. You can:

    • Use the Certificate Templates snap-in to create a new custom template.
    • Copy an existing template (liketemplate, like the Web Server template)template, and then update the copy to use as the NDES template.
  2. Configure the following settings on the specified tabs of the template:

    • General:

      • Select Supply in the request. The Intune policy module for NDES enforces security.

        Screenshot shows certificate template Subject Name tab with Supply in the request option selected.

    • Extensions:

      • Ensure that Description of Application Policies includes Client Authentication.

        Important

        Only addAdd only the application policies that you require. Confirm your choices with your security admins.

      • For iOS/iPadOS and macOS certificate templates, also edit Key Usage and make sure Signature is proof of origin isn't selected.

      Screenshot shows certificate template Extensions tab showing application policies and key usage settings.

    • Security:

      • Add the NDES service account. This account requires Read and Enroll permissions to this template.
      • Add additional Accountsaccounts for Intune administrators who willcan create SCEP profiles. These accounts require Read permissions to the template to enable these admins to browse to this template while creating SCEP profiles.

      Screenshot shows certificate template Security tab with NDES service account permissions configured.

    • Request Handling:

      The following image is an example. Your configuration might vary.

      Screenshot shows certificate template Request Handling tab showing purpose and key export settings.

    • Issuance Requirements:

      The following image is an example. Your configuration might vary.

      Screenshot shows certificate template Issuance Requirements tab with approval and signature settings.

  3. Save the certificate template.

Create the client certificate template

Note

The following certificate is notisn't used with the Certificate Connector for Microsoft Intune. This information is provided for those who have not yet replaceddidn't replace the older connector for SCEP (installed by NDESConnectorSetup.exe) with the new connector software.

The Microsoft Intune Connector requires a certificate with the Client Authentication Enhanced Key Usage and Subject name equal to the FQDN of the machine where the connector is installed. AYou need a template with the following properties is required:properties:

  • Extensions > Application Policies must contain Client Authentication.
  • Subject name > Supply in the request.

If you already have a template that includes these properties, you can reuse it, otherwiseit. Otherwise, create a new template by either duplicating an existing one or creating a custom template.

Create the server certificate template

Communications between managed devices and IIS on the NDES server use HTTPS, which requires use of a certificate. You can use the Web Server certificate template to issue this certificate. Or, ifIf you prefer to have a dedicated template, use the following properties are required:properties:

  • Extensions > Application Policies must contain Server Authentication.
  • Subject name > Supply in the request.

Grant permissions for certificate revocation

ForTo enable Intune to be able to revoke certificates that are no longer required, you must grant permissions in the Certificate Authority.

On the server that hosts the certificate connector, use either the NDES server system account or a specific account such as the NDES service account.

  1. On your Certificate Authority console, Right-right-click the CA name and select Properties.

  2. In the Security tab, select Add.

  3. Grant the Issue and Manage Certificates permission:

    • If you optchoose to use the NDES server system account, providegrant the permissionspermission to the NDES server.
    • If you optchoose to use the NDES service account, provide permissions forgrant the permission to that account instead.account.

Modify the validity period of the certificate template

It's optional toYou can modify the validity period of the certificate template.

After you create the SCEP certificate template, you can edit the template to review the Validity period on the General tab.

By default, Intune uses the value configured in the template, but you can configure the CA to allow the requester to enter a different value, so you can set that value can be set from within the Microsoft Intune admin center.

Plan to use a validity period of five days or greater. When the validity period is less than five days, there's a high likelihood of the certificate entering a near-expiry or expired state, which can cause the MDM agent on devices to reject the certificate before it's installed.

Publish certificate templates

  1. On the issuing CA, use the Certification Authority snap-in to publish the certificate template.

    1. Select the Certificate Templates node, select Action > New > Certificate Template to Issue, and then select the certificate template you created in the previous section.
    2. Validate that the template hasis published by viewing it in the Certificate Templates folder.

    Set up NDES

    The following procedures can help you configure the Network Device Enrollment Service (NDES) for use with Intune. These procedures are provided as examplesexamples, as the actual configuration might vary depending on your version of Windows Server. Ensure required configurations you addadd, like those for .NET FrameworkFramework, meet the prerequisites for the Certificate Connector for Microsoft Intune.

    For more information about NDES, see Network Device Enrollment Service Guidance.

    Install the NDES service

    1. On the server that willyou want to host your NDES service, sign in as an Enterprise Administrator, and then use the Add Roles and Features Wizard to install NDES:

      1. In the Wizard,wizard, select Active Directory Certificate Services to gain access to the AD CS Role Services. Select Network Device Enrollment Service, uncheck Certification Authority, and then complete the wizard.

        Tip

      • In Role Services, select the Network Device Enrollment Service.
      • In Service Account for NDES, specify the NDES Service Account.
      • In CA for NDES, click Select, and then select the issuing CA where you configured the certificate template.
      • In Cryptography for NDES, set the key length to meet your company requirements.
      • In Confirmation, select Configure to complete the wizard.
    2. After the wizard completes, update the following registry key on the computer that hosts the NDES service:

      HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\MSCEP\

      To update this key, identify the certificate templates' Purpose (found on itsthe Request Handling tab).tab. Then, update the corresponding registry entry by replacing the existing data with the name of the certificate template (nottemplate, not the display name of the template)template, that you specified when you created the certificate template.

      The following table maps the certificate template purpose to the values in the registry:

      | Encryption | EncryptionTemplate | Key Encipherment | | Signature and encryption | GeneralPurposeTemplate | Key Encipherment Digital Signature |

      For example, if the Purpose of your certificate template is Encryption, then edit the EncryptionTemplate value to be the name of your certificate template.

    3. Restart the server that hosts the NDES service. Don't use iisreset; iireset because it doesn't complete the required changes.

    4. Browse to http://Server\_FQDN/certsrv/mscep/mscep.dllhttp://<Server_FQDN>/certsrv/mscep/mscep.dll. You should see an NDES page similar to the following image:

      Screenshot shows NDES service page confirming mscep.dll is running and responding successfully.

      If the web address returns a 503 Service unavailable, error, check the computerscomputer's event viewer. This error commonly occurs when the application pool is stoppedstops due to a missing permission for the NDES service account.

    Install and bind certificates on the server that hosts NDES

    1. Request a **server authentication** certificate from your internal CA or public CA, and then install the certificate on the server.
    
        Depending on how you expose your NDES to the internet, there are different requirements.
    
        A good configuration is:
    
    
        Note
    
        If you are're using Microsoft Entra application proxy, the Microsoft Entra application proxy connector will translatetranslates the requests from the external URL to the internal URL. As such, NDES will only respondresponds to requests directed to the internal URL, usually the FQDN of the NDES Server.
    
        In this situation, the external URL is notisn't required.
    2. Bind the server authentication certificate in IIS:
    
        1. After installingyou install the server authentication certificate, open **IIS Manager**, and select the **Default Web Site**. In the **Actions** pane, select **Bindings**.
        2. Select **Add**, set **Type** to **https**, and then confirm the port is **443**.
        3. For **SSL certificate**, specify the server authentication certificate.
    

    Note

    When configuring NDES for the Certificate Connector for Microsoft Intune ,Intune, only the Server authentication certificate is used. If you're configuring NDES to support the older certificate connector (NDESConnectorSetup.exe), you must also configure a Client authentication certificate. You can use a single certificate for both server authentication and client authentication when that certificate is configured to meet the criteria of both uses.

    Regarding the Subject Name, it must meet the client authentication certificate requirements.

    The following information is provided for those who have not yet replaceddidn't replace the older connector for SCEP (installed by NDESConnectorSetup.exe) with the new connector software.

    • Client authentication certificate
Daily Intune.Admin.News

Get daily email updates

Get a concise summary of the latest Microsoft Intune updates delivered straight to your inbox.

Loading the secure signup form…