Installing and Configuring the IdExchange MicroService

Installation Requirements

1. CMS Notification Plugin is installed Installing the CMS Notification Plugin

2. .NET 4.8

3. Client certificate issued to the IDMS Operator (installed in local computer certificate store) that will be used by the MicroService

4. Role assignment of EnrollmentOfficer and NotificationService for the IDMS Operator that will be used by the MicroService

5. IDMS has the CMS PIV_AUTHENTICATION certificate mapping

6. Microsoft MSMQ Service

To Install the IdExchange MicroService

1. The IdExchange MicroService insteraller is in the IDMS Client\CMS Notification folder and is named IdExchangeWcfInstaller.msi.

   

2. Open an administrative command prompt and run the IdExchangeWcfInstaller.msi.

3. After the installation completes, open the Service snap-in by running services.msc (Windows key + R)

4. Verify the installation was successful by analyzing the services . If successful, the "IdExchange" will appear in the list.

   

Configuration Procedures

1. Using an administrative command prompt, go to the C:\Program Files (x86)\CyberArmed\IdExchangeSvc folder

2. Open the IdExchangeSvc.exe.config with notepad.

   

3. Verify the UseMsmq key exists.

   

4. With the IdExchangeSvc.exe.config opened, scroll to the bottom to the "AppSettings" section of the file.

   

5. Go to the IdmsOperatorSerialNumber and insert the certificate serial number of the client certificate

   

6. Next, go to the WebAPIURL key and update the DNS value to the value of the IDMS DNS.

   

   
   

7. Save the IdExchangeSvc.exe.config file and close.

8. Log into to the IDMS, Administration → Operators and add/update the account with the thumbprint from the certificate configured in the previous step.

9. In the command prompt, enter "net start IdExchange".

   

10. View the in the c:\temp\idexchange-service.txt logs to verify the service started properly.