Skip to main content

How to Re-authenticate the Engagement Bridge After an Eaglesoft Password Reset

Learn how to re-authenticate your Engagement Bridge and extend your Eaglesoft password expiration to prevent sync interruptions after password resets

Updated over a week ago

When you reset your Eaglesoft provider password, you'll need to re-authenticate the Engagement Bridge to restore your connection to Dental Intelligence. This article walks you through the complete process, including how to extend your password expiration to minimize future disruptions.

Re-authenticating your Engagement Bridge once you've changed your Eaglesoft password is a time sensitive task. For best results, re-authenticate the bridge immediately after changing your Eaglesoft password. Delays can cause timeout errors that require a 30-minute waiting period, as well as issues with forms writeback and other patient updates that require a bridge connection to sync.


Part 1: Setting Your Eaglesoft Password Expiration

By default, Eaglesoft passwords expire every 90 days. To reduce bridge disconnection interruptions, we recommend extending the password expiration for the admin provider account used for the Engagement Bridge sync (not individual staff accounts).

  1. Follow Patterson's instructions to set up or change passwords and adjust the expiration period: Eaglesoft Password Setup Guide

  2. Set the password expiration to the maximum available (up to 365 days) for the account used for bridge authentication

  3. Note your new Eaglesoft password because you'll need it for re-authentication to Dental Intelligence

Note: Only the admin provider account used for bridge authentication needs an extended expiration. Regular staff passwords can remain on standard expiration schedules.


Part 2: Creating a Desktop Shortcut for Re-authentication

Setting up a desktop shortcut makes it easy to re-authenticate the bridge whenever needed.

  1. Navigate to the following location on your server computer:

    C:\ModentoBridge\Wrapper\bat\
  2. Locate the file named runInstall.bat

  3. Right-click on runInstall.bat

  4. Select Send to > Desktop (create shortcut)

  5. The shortcut will now appear on your desktop for easy access. You can rename the shortcut by right-clicking on it and choosing Rename. We recommend renaming the shortcut to something that you'll remember, ie "Re-Auth Modento Sync"


Part 3: Re-authenticating the Modento Bridge

After changing your Eaglesoft password, follow these steps to re-authenticate:

  1. Locate the runInstall.bat shortcut on your desktop (created in Part 2 above)

  2. Right-click the shortcut and select Run as administrator

  3. A window will appear prompting you to enter:

    • Provider ID (the admin provider account used for bridge sync)

    • New Password (the password you just changed in Eaglesoft)

  4. Click Submit

  5. Restart the ModentoBridge services

  6. The Eaglesoft API error should resolve within a few minutes


Troubleshooting

If You See a "Locked Out" Message

If you receive an error stating you're "Locked out of service for too many bad attempts," this means there was a delay between when you changed your password and when you re-authenticated.

To resolve:

  1. Wait a minimum of 30 minutes

  2. Re-run the shortcut (right-click > Run as administrator)

  3. Re-enter your provider ID and new password

  4. Click Submit

  5. In rare cases, you may need to repeat this process twice

If You're Prompted for an Installation Key

If the runInstall.bat window asks for an installation key instead of login credentials, please contact Engagement Support for assistance.

If You're Unsure of Your Provider ID

If you don't know which provider ID is used for the bridge authentication, contact Engagement Support and we can help identify it.


Important Notes

  • Time Matters: For best results, re-authenticate the bridge immediately after changing your Eaglesoft password. Delays can cause timeout errors that require a 30-minute waiting period.

  • Performance Impact: When the bridge fails to authenticate, Eaglesoft creates an XML file each time the connection attempt fails. This can impact server and Eaglesoft performance until the bridge is properly re-authenticated.

  • Admin Account Only: Make sure you're extending the password expiration and re-authenticating with the admin provider account used for bridge sync, not a regular staff member's account.


Need Help?

If you continue to experience API errors after following these steps, or if you encounter any issues during the process, please reach out to Engagement Support for assistance.

Did this answer your question?