Skip to content

Manage a SCEP server

After you create a SCEP server, you can check its status, edit it, regenerate its authentication credential, download or renew its registration authority (RA) certificate chain, and deactivate the server when it is no longer needed.

To manage the certificates a SCEP server issues, see Manage SCEP certificates.

Server status

The Status column in the SCEP Servers list shows whether a server's registration authority (RA) certificates are in place:

Status Meaning
Pending Certificate Manager - SaaS is requesting the RA certificates from the certificate authority. This happens shortly after you create the server.
Ready The RA certificates are issued. The server accepts enrollment requests.
Failed The RA certificates could not be issued. The server can't accept enrollment requests until they are.

A server usually changes to Failed for one of these reasons:

  • The certificate authority refused the RA certificate request. Check that the CA template behind each RA request policy allows enrollment from a user-provided CSR.
  • The certificate authority issued an RA certificate with the wrong or overlapping key usages. See Certificate authority requirements.
  • A temporary service problem interrupted issuance.

To see why a server failed, select it. The details panel shows the status and the error message. After you correct the cause, select Renew Registration Authority to retry. See Renew the registration authority certificate.

Edit a SCEP server

You can change an active server's name and its request policies. You can't change its authentication type; to use a different one, create a new server. You can't edit a deactivated server.

  1. Sign in to Certificate Manager - SaaS.
  2. In the Certificate Manager - SaaS console, select Configurations > SCEP Servers.

  3. Select the SCEP server that you want to edit.

  4. On the Properties tab, under General Properties, change the Name, the End Entity Request Policy, the Registration Authority Signing Request Policy, or the Registration Authority Encryption Request Policy.
  5. Select Save.

Note

A change to an RA request policy takes effect the next time the RA certificates are issued: when they renew automatically, or when you select Renew Registration Authority.

Regenerate the authentication credential

Regenerate a server's authentication credential if it is lost or compromised. Regenerating creates a new credential and invalidates the previous one, so any client or mobile device management (MDM) platform still using the old credential stops enrolling until you update it. What you regenerate depends on how the server authenticates:

  • A static server has a Challenge Password.
  • A dynamic server that uses a service account has a Username and Password.
  • A dynamic server that uses a header token has a Header Token.

  • Sign in to Certificate Manager - SaaS.

  • In the Certificate Manager - SaaS console, select Configurations > SCEP Servers.

  • Select the SCEP server that you want to update.

  • Select Regenerate.
  • If you are regenerating a service account credential, for Credential Generation Method select System Generated or Custom. For Custom, enter a Username and Password.
  • Review the warning, and then select Proceed.
  • Copy and store the new credential. It is displayed only once.
  • Select the acknowledgement checkbox, and then select Done.
  • Update the credential in each SCEP client or MDM that enrolls against this server.

Download the RA certificate chain

Each SCEP server has a registration authority (RA) certificate chain that clients use to secure SCEP messages. Most SCEP clients retrieve the RA certificate automatically over the SCEP protocol, so a manual download is usually not required.

Download the RA certificate chain only if your client requires it to establish trust:

  1. Sign in to Certificate Manager - SaaS.
  2. In the Certificate Manager - SaaS console, select Configurations > SCEP Servers.

  3. Select the SCEP server.

  4. Under Registration Authority Details, select Download Certificate Chain.

Note

Certificate Manager - SaaS issues the RA certificate chain shortly after you create the server. If the chain has not been issued yet, it is not available to download; it appears here once issuance completes.

Renew the registration authority certificate

Certificate Manager - SaaS renews a server's registration authority (RA) certificates automatically before they expire. As the current RA certificates near expiration, the server prepares the next ones, and SCEP clients that support it pick them up before the switch. You don't need to renew RA certificates on a schedule.

Use Renew Registration Authority to reissue the RA certificates yourself:

  • To retry after the server's Status changes to Failed, once you've corrected the cause. See Server status.
  • To pick up a change to an RA request policy right away.
  • To replace the RA certificates for any other reason, such as a security concern.

Renewing reissues the RA certificate chain from the same certificate authority.

Note

You can't renew while the server's Status is Pending, or after the server is deactivated. Renew Registration Authority becomes available once issuance finishes, or fails.

  1. Sign in to Certificate Manager - SaaS.
  2. In the Certificate Manager - SaaS console, select Configurations > SCEP Servers.

  3. Select the SCEP server.

  4. Select Renew Registration Authority.
  5. Select Proceed.

Certificate Manager - SaaS issues new RA signing and encryption certificates and replaces the current ones. SCEP clients must trust the issuing certificate authority's chain to keep enrolling.

Deactivate a SCEP server

Deactivate a SCEP server when it is no longer required. A deactivated server stops responding to enrollment requests.

Warning

Deactivation is permanent. You cannot reactivate a deactivated SCEP server.

Note

You cannot delete a SCEP server from Certificate Manager - SaaS. Deactivate the server instead.

  1. Sign in to Certificate Manager - SaaS.
  2. In the Certificate Manager - SaaS console, select Configurations > SCEP Servers.

  3. Select the SCEP server that you want to deactivate.

  4. Select Deactivate.
  5. Select Deactivate again to confirm.