Skip to main content

Configuring User SCEP and Enterprise WiFi Policies for Zero-Touch Network Access

JumpCloud Managed PKI and MDM work together so employees get a usercertificate and corporateWiFi automatically when they sign in to a managed device — no manual certificate import and no WiFi setup. You create a Users SCEP endpoint in PKI, copy the URL and challenge into a UserSCEPCertificate MDM policy, then pair an EnterpriseWi-Fi policy on the sameusergroups. JumpCloud delivers the SCEP profile first, then WiFi, and binds EAP-TLS to the SCEP-issued identity.

Prerequisites

  • Access to the JumpCloud Admin portal permission to manage Certificate Authority resources and MDM policies.
  • An active JumpCloud-managed Client Certificate Authority configured.
  • Target devices must be enrolled in JumpCloud MDM (Windows or macOS for user-scoped policies).
  • A RADIUS server configured for EAP-TLS / 802.1X (JumpCloud RADIUS or your NAS).
  • RADIUS server TLS certificate thumbprint(s) and trusted server hostnames for the Wi-Fi policy.

Considerations

  • Save the challenge password immediately. It is shown only once and cannot be recovered or revealed later. If the password is lost, regenerate it from the SCEP endpoint row.
  • Each SCEP endpoint is attached to one Client CA and one profile (Users or Devices). Create separate endpoints if you need both user and device certificates from the same CA.
  • The endpoint hostname is region-specific. The URL hostname differs by data center. Examples: scep.jumpcloud.com for US, scep.eu.jumpcloud.com for EU, scep.in.jumpcloud.com for India.
  • Do not select a certificate in the Wi-Fi policy. Assign UserSCEP and EnterpriseWi-Fi to the sameusergroups, JumpCloud orchestrates delivery order (SCEP before Wi-Fi) and platform binding.
  • The SCEP policy delivers the client certificate chain. The WiFi policy carries RADIUS / NAS server trust (CA thumbprints and trusted server names). These are separate trust materials.

Adding SCEP Endpoint

A Simple Certificate Enrollment Protocol (SCEP) endpoint lets MDM request and install certificates from your JumpCloud CA without manual distribution.

Add a User SCEP endpoint

To create an endpoint with the Users profile:

  1. Log in to the JumpCloud Admin Portal.
  2. Go to Security > Certificate Authority.
  3. Click the SCEP Endpoints tab.
  4. Click + Add SCEP Endpoint. The Create SCEP Endpoint dialog opens.
  5. In the SCEP Name field, enter a name for the endpoint. For example: Corporate WiFi User Certs.
  6. Under Profile, select Users. The endpoint accepts only user-scoped certificate signing requests and issues user certificates.
  7. The Authentication Type drop-down is set to the default value of Challenge Password.
  8. From the Client Certificate Authority drop-down, select the CA that issues certificates through this endpoint.
  9. Click Next. A success message is displayed.
  10. Copy the Unique Endpoint URL and Challenge Password. You enter these in the User SCEP MDM policy in the next section.

note

The Challenge Password is displayed only in this success step. After you click Close, JumpCloud does not show this password again in the Admin Portal. If you do not copy it now, regenerate it and update every MDM SCEP policy that uses this endpoint.

The SCEP Endpoints list displays the following columns:

Column NameDescription
NameDisplay name set when the endpoint was created.
ProfileVerification type: User or Device.
CA IDIdentifier of the linked Client Certificate Authority.
Unique EndpointFull SCEP URL. Use the copy icon in the row to copy the value.
Created timeTimestamp when the endpoint was created.
trash iconDeletes the endpoint.

Add a Device SCEP Endpoint

To create an endpoint with the Users profile:

  1. Log in to the JumpCloud Admin Portal.
  2. Go to Security > Certificate Authority.
  3. Click the SCEP Endpoints tab.
  4. Click + Add SCEP Endpoint. The Create SCEP Endpoint dialog opens.
  5. In the SCEP Name field, enter a name for the endpoint.
  6. Under Profile, select Devices. The endpoint accepts only device-scoped certificate signing requests and issues user certificates.

  1. The Authentication Type drop-down is set to the default value of Challenge Password.
  2. From the Client Certificate Authority drop-down, select the CA that issues certificates through this endpoint.
  3. Click Next. A success message is displayed.
  4. Copy the Unique Endpoint URL and Challenge Password. You enter these in the User SCEP MDM policy in the next section.
note

The Challenge Password is displayed only in this success step. After you click Close, JumpCloud does not show this password again in the Admin Portal. If you do not copy it now, regenerate it and update every MDM SCEP policy that uses this endpoint.

Column NameDescription
NameDisplay name set when the endpoint was created.
ProfileVerification type: User or Device.
CA IDIdentifier of the linked Client Certificate Authority.
Unique EndpointFull SCEP URL. Use the copy icon in the row to copy the value.
Created timeTimestamp when the endpoint was created.
trash iconDeletes the endpoint.

Regenerating a Challenge Password

If the challenge password is lost or compromised, regenerate it from the endpoint details. This invalidates the old password.

  1. Go to Security > Certificate Authority > SCEP Endpoints.
  2. Click the row for the endpoint. The Edit SCEP Endpoint view opens.
  3. Click Regenerate under Challenge Password and confirm.
  4. Copy the new challenge password from the success step.
  5. Click Save.
  6. Update every MDM SCEP policy that uses this endpoint with the new challenge password, and redeploy those policies.
note

Regenerating the challenge password invalidates the old password. Existing certificates remain valid, but new enrollments and renewals fail until MDM policies are updated.

Deleting a SCEP Endpoint

  1. Go to Security > Certificate Authority > SCEP Endpoints.
  2. In the endpoint row, click the trash icon.

note

Deleting an endpoint stops new enrollments and renewals through that URL. Devices keep issued certificates until expiry but cannot renew.

Creating a User SCEP Certificate MDM Policy

When a user in an assigned group signs in to a managed Windows or macOS device, JumpCloud pushes a user level SCEP profile. The device enrolls a certificate in the user store (CurrentUser on Windows; login keychain on macOS).

To create the policy:

Selecting the policy template

  1. Log in to the JumpCloud Admin Portal.
Important

If your data is stored outside of the US, check which login URL you should be using depending on your region. If your organization uses LDAP, RADIUS, or requires firewall allow list configuration, the Fully Qualified Domain Names (FQDNs) will also be region specific. See JumpCloud Data Centers for the URLs, FQDNs, and IP addresses.

  1. Go to Device Management > Policy Management.
  2. Click + Add New.
  3. Select User Policy.
  4. Select the Windows or macOS tab (create one policy per platform you support).
  5. Search for and select User SCEP Certificate (or the SCEP user policy name shown in your tenant).
  6. Click Configure.

Configuring SCEP settings

On the Details tab, configure the following fields using values from the SCEP endpoint success step:

Field NameDescription
CA thumbprintThumbprint of the issuing CA. May auto-fill when you upload a root CA file below.
ChallengeChallenge password from the SCEP endpoint (masked in the portal).
Server URLFull SCEP URL from Unique Endpoint.
Key lengthDefault 2048 (options: 1024, 2048, 4096).
Subject nameDefault suitable for users (for example, CN=%UserEmail%). UI lists supported substitution tokens.
Subject Alternative NamesDefault suitable for user identity (for example, RFC822 email SAN).
Retry count / retry delayDefaults 3 / 1 second.
Template nameOptional SCEP template name when required by the endpoint.
Renewal period (days)Default 30.
EKU — Client AuthenticationKeep enabled for RADIUS / 802.1X. UI warns if disabled.
EKU — Document Signing / Smart Card Logon(Optional) Default off unless needed.
Root / CA fileUpload PEM/CRT/DER from your CA inventory; ships trusted root material to devices.

Applying the Policy

  • (Optional) Select the Policy Groups tab. Select one or more policy groups where you want to add this policy.
  • Select the User Groups tab. Select one or more user groups where you want to apply this policy. For user groups with multiple OS member types, the policy only applies when a user logs into a supported Windows device that is enrolled in MDM.
  • Or, select the Users tab. Select one or more users to whom you want to assign this policy.
  • Click Create Policy. A success message is displayed indicating the completion of policy creation.

Viewing Policy Status

  1. Select the Statustab.
  2. To see the last Result Log for a device where this policy is applied, click view.
note
  • If any errors occur, they're listed inExit Status. If you have an Exit Status of 0, no errors occurred when applying or enforcing this policy.

Policy status may show Pending User Registration until the user signs in to a managed device.

Creating a Device SCEP Certificate MDM Policy

Creating an Enterprise WiFi MDM Policy

Pair an Enterprise Wi-Fi policy with the same user groups. JumpCloud delivers WiFi after SCEP and binds EAP-TLS to the SCEP-issued user certificate — no separate certificate reference field. See Create a Device Level Windows WiFi Configuration Policy to learn more.

What Happens at User Login

  1. The user signs in to a managed Windows or macOS device enrolled in JumpCloud MDM.
  2. The JumpCloud Agent detects the session and sends a check-in with device and user identity.
  3. The backend resolves User SCEP and Enterprise Wi-Fi policies for that user.
  4. MDM delivers the user-scoped SCEP profile; the device enrolls via SCEP and stores the cert in the user store.
  5. MDM delivers the user-scoped Wi-Fi profile, bound to the SCEP identity.
  6. The device auto-connects to the configured SSID using EAP-TLS.

On shared devices, each user receives their own certificate in their own user store when they sign in. Certificates are not removed when another user logs in.

Coexistence With Manual Certificates

Auto-provisioned SCEP certificates may coexist with manually issued certificates (Admin Portal or User Portal). The orchestrated Wi-Fi profile uses the SCEP / AGENT_MDM identity for that policy pair, not an arbitrary client certificate. Manual certificates are not deleted during automated provisioning. Certificate inventory shows distinct source values for audit.

Was this information helpful?