Skip to page contentSkip to chat
ServiceNow support
    • Community
      Ask questions, give advice, and connect with fellow ServiceNow professionals.
      Developer
      Build, test, and deploy applications
      Documentation
      Find detailed information about ServiceNow products, apps, features, and releases.
      Impact
      Accelerate ROI and amplify your expertise.
      Learning
      Build skills with instructor-led and online training.
      Partner
      Grow your business with promotions, news, and marketing tools
      ServiceNow
      Learn about ServiceNow products & solutions.
      Store
      Download certified apps and integrations that complement ServiceNow.
      Support
      Manage your instances, access self-help, and get technical support.
How to change MID Server user - Support and Troubleshooting
  • >
  • Knowledge Base
  • >
  • Support and Troubleshooting (Knowledge Base)
  • >
  • How to change MID Server user
KB0752979

How to change MID Server user


9875 Views Last updated : Jul 24, 2025 public Copy Permalink English (Original)
  • English (Original)
  • Japanese
KB Summary by Now Assist

Issue

The MID Server connects to an instance by using the SOAP web service. To allow authentication with the instance, a separate user account is created for each MID Server. Once a MID Server is configured, the mid server user rarely needs to be modified however in case such a requirement exists, this article lists the steps to perform this procedure.

 Note: Changing a MID Server user will cause disruption to applications that depend on the MID Server.

Resolution

  1. Create a new MID Server user and grant the mid_server role as per the documentation.
  2. Access the MID server host and open up the config.xml file located at <Install path>\agent folder
  3. Update the mid.instance.username parameter with the new username and update the mid.instance.password with the new password. The password value is in plain text. The two parameters would look like as in the following example:
  4. Scroll to the bottom of the config.xml file and remove the parameter below:
    <parameter name="keypairs.mid_id" value="XXXX"/>
  5. Save the config.xml file and restart the MID Server service.
  6. Go back to the MID server page on the instance and you should see a message similar to this:

    Logged in user 'miduser' does not match configured user 'newmiduser'. Check the MID Server user configuration.

  7. To update the new user, invalidate and validate the MID server.
  8. When the MID Server status is changed to UP the updated username should be listed on the page:

Related Links

Create the MID Server user and grant the role


The world works with ServiceNow.

Sign in for more! There's more content available only to authenticated users Sign in for more!
Did this KB article help you?
Did this KB article help you?

How would you rate your Now Support digital experience?

*

Very unsatisfied

Unsatisfied

Neutral

Satisfied

Very satisfied

Very unsatisfied

Unsatisfied

Neutral

Satisfied

Very satisfied

What can we improve? Please select all that apply.

What are we doing well? Please select all that apply.

Tell us more

*

Do you expect a response from this feedback?

  • Terms and conditions
  • Privacy statement
  • GDPR
  • Cookie policy
  • © 2025 ServiceNow. All rights reserved.