Entrust PKI as a Service

Migrating a WSTEP on-premises enrollment workflow

Follow the steps below to migrate an on-premises WSTEP enrollment workflow to PKIaaS.

Creating the new WSTEP enrollment workflow

Create a new PKIaaS enrollment workflow by following Automating WSTEP enrollment. The sections below provide deployment-specific considerations.

  1. When Planning your WSTEP deployment, determine the required number of Agents based on your current deployment.
  2. When evaluating the WSTEP integration requirements, determine the networking requirements based on your current deployment. Make any necessary adjustments to the DNS server and firewall rules.
  3. You can skip the section Configuring an issuing CA for WSTEP because WSTEP is already configured for your on-premises deployment.
  4. When Preparing the Active Directory forest for WSTEP:
    • Repeat Adding Active Directory nodes for each root Active Directory in every Microsoft Active Directory forest. Create a new service account for the PKIaaS WSTEP enrollment workflow to allow the existing on-premises WSTEP enrollment workflow to continue functioning until decommissioned.
    • You can skip Installing the default set of certificate templates, as the templates should already exist for each Microsoft Active Directory forest.
    • Repeat Setting up LDAPS on domain controllers for the entire Microsoft Active Directory forest. In contrast, the on-premises WSTEP enrollment workflow requires LDAPS TLS certificates only on the root Active Directory domain controllers.
  5. When Configuring WSTEP automation in PKIaaS, complete all the steps. When Preparing the Active Directory forest for WSTEP, ensure the selected certificate authority matches the one used for the on-premises WSTEP enrollment workflow.
  6. When Enabling WSTEP for users and devices, do not reuse the Group Policy Object (GPO) of the on-premises WSTEP enrollment workflow. Complete the following steps to allow rollback if needed.
    1. Create a new GPO.
    2. Apply the GPO to a single test user.
    3. Complete the migration testing.
    4. Apply the GPO across the entire forest.
    5. Unlink the existing GPO for the on-premises WSTEP enrollment workflow.
 Keep the on-premises WSTEP enrollment workflow running until the PKIaaS WSTEP enrollment workflow is fully deployed and integrated into the Microsoft Active Directory forest.

Cleaning up the Windows domain after migrating WSTEP to PKIaaS

Follow the steps below in your Windows domain to complete the migration.

To clean up the Windows domain after migration:

  1. Remove all Group Policy Objects (GPOs) for the on-premises WSTEP enrollment workflow.
  2. Run the gpupdate /force command to force a group policy update.
  3. In the root domains of the Microsoft Active Directory forests, delete the WSTEP service account for the on-premises WSTEP enrollment workflow.
  4. Turn off the Microsoft servers that host the Certificate Enrollment Policy (CEP) service. If these are virtual machines, you can delete them.
  5. Open the ADSI Edit console and remove the Enrollment Service for the on-premises WSTEP enrollment workflow.

Cleaning up the appliance after migrating WSTEP to PKIaaS

The required cleanup operations on the appliance vary depending on the following situations.

  • The on-premises Entrust enrollment workflow runs other protocols such as ACME, MDM, Intune, or SCEP.
  • The appliance cluster hosts other solutions such as Certificate Hub or CA Gateway.

The table below shows the required cleanup actions for each appliance cluster.

Protocol Other solutions Cleanup actions
WSTEP ✔ Run the sudo kubectl delete namespace ceg command to delete the ceg namespace from the appliance. This operation keeps the configuration and the license in case you need to redeploy.
WSTEP ❌ You can shut down or delete the nodes of the appliance cluster.
WSTEP and other protocols ✔ Do nothing.
WSTEP and other protocols ❌ Do nothing.