Import the new certificates
TMA will provide new certificates to the Central Station (typically one for production and one for test).
On the machine where the AutoDispatch Gateway is installed, double-click the certificate file to import it. TMA will also have provided passwords.
Note: Install to Local Machine, not Current User.
When asked for a location to install, choose Browse and the Personal Store.
Once imported, open the server certificate manager: run > certlm.msc.
Check the certificates in the Personal location. The ca.tma-asap certificate should be moved to the Trusted Root folder. Only the Central Station certificate must remain in the Personal folder, and only the ca.tma-asap certificate must remain in the Trusted Root folder.
If these are replacement or updated certificates, once they are imported you can delete the old ones from the store.
Add the certificate thumbprint to the appsettings.json file.
Go to the certificate properties (double-click or right-click and choose properties), go to the Details tab then scroll down to thumbprint.
Copy the value and paste it into a notepad, there will be spaces in the thumbprint that will need to be removed.
Open the Appsettings.json file located in C:\Program Files (x86)\Bold Technologies\Manitou\AutoDispatch2
Scroll down and find the TMAASAP section and replace the thumbprint, there are two places it is entered and save the file.
Open the log viewer and select the AutoDispatch Gateway, restart the service via the MSM, and watch for any errors
Possible Issues
Occasionally when adding the new thumbprint to the appsetings.json file extra question marks get added to one end of the string. You will see an error like the following:
Auto Dispatch Gateway Couldn't find client certificate with thumbprint '??071dcfcfd82dfa39d2ee0b12b54f8ff054ce58d7' in certificate store. Ensure that the certificate is in the 'Local Computer' store, 'Personal' folder. Exception Message: Index was out of range. Must be non-negative and less than the size of the collection. (Parameter 'index')
If this occurs, close and reopen the appsetings.json file (preferably in Notepad++). If you do not see the question marks lace your cursor outside of the quotation marks and delete or backspace until you get to the thumbprint, then re-enter the quotation marks and restart the gateway.
