Revert MID Servers from IPKI to basic authentication

task brazil Updated Nov 3, 2026 1 min read mid-revert-ipki-to-basic-authentication.md
Raw file servicenow.com

Move a MID Server that uses IPKI authentication back to basic authentication by changing its configuration and restarting the service.

Before you begin

Role required: admin or agent_admin

About this task

Revert a MID Server to basic authentication when it must no longer use IPKI. You need the credentials that the MID Server should use to authenticate to the instance.

Procedure

  1. Stop the MID Server service.

  2. On the MID Server host, open config.xml in the agent folder and set these parameters:

    XML
    <parameter name="mid.ipki.enabled" value="false"/><parameter name="mid.instance.username" value="<user_name>"/><parameter name="mid.instance.password" value="<password>"/>

    Replace user_name and password with the credentials that the MID Server should use.

  3. Start the MID Server service.

Result

The MID Server authenticates to the instance with basic authentication. The certificate mapping record for the MID Server becomes inactive after the MID Server is running on basic authentication again.

Parent Topic:MID Server IPKI authentication

Keywords IPKIbasic authenticationMID Server configuration
Search documentation
Search document titles and file paths on the brazil branch