IdExchange 1.9.1

Installing the IDMS.Core HSM MicroService

The iDMS.Core HSM Microservice enables the IDMS to security interact with the HSM over the network. This enables multiple IDMS servers to share a single HSM, regardless of where the IDMS is physically. The IDMS does not need a direct physical connection to the IDMS.

Before getting started, verify that the HSM is operational and the IDMS Security key for Thales or Luna has been created.

To install the IDMS.Core HSM MicroService

Prepare the IIS Application Server

  1. Install aspnetcore-runtime-8.0.7-win-x64 Download Link: https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-8.0.7-windows-x64-installer

  2. Install dotnet-hosting-8.0.7-win Download Link: https://builds.dotnet.microsoft.com/dotnet/aspnetcore/Runtime/8.0.7/dotnet-hosting-8.0.7-win.exe

  3. Create a directory: C:\Program Files\CyberArmed\IDMS.Core

    image-20250704-160346.png
  4. Copy the IDMS publish folder to the C:\Program Files\CyberArmed\IDMS.Core

    image-20250704-160441.png


  5. Verify the web.config is in the publish folder


    <?xml version="1.0" encoding="utf-8"?>
    <configuration>
      <location path="." inheritInChildApplications="false">
        <system.webServer>
          <handlers>
            <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
          </handlers>
          <aspNetCore processPath="dotnet" arguments=".\IdExchange.WebApi.Core.dll" stdoutLogEnabled="false" hostingModel="InProcess" stdoutLogFile=".\logs\stdout">
            <environmentVariables>
              <environmentVariable name="ASPNETCORE_HTTPS_PORT" value="454" />
              <environmentVariable name="ASPNETCORE_ENVIRONMENT " value="Development" />
            </environmentVariables>
          </aspNetCore>
        </system.webServer>
      </location>
      <system.webServer>
        <security>
    
        </security>
      </system.webServer>
    </configuration>
    <!--ProjectGuid: 1AB95E96-2CD5-4CEA-AD84-47D5A2A453C3-->
    

Update IIS

  1. Open IIS Manager

    image-20250704-164335.png
  2. Expand the server folder, right click sites

    image-20250704-164433.png
  3. Click Add web site
    Site Name: IDMS.Core
    Physical Path: C:\Program Files\CyberArmed\IDMS.Core\publish
    Binding: https:
    Port 454
    hostname: enter the DNS of the server
    Select the correct SSL Certificate, Press OK

    image-20250704-164558.png
  4. Click the SSL Settings, client certificate, require

    image-20260702-225130.png
  5. Click the IDMS.Core web site

  6. Click the Configuration Editor

    image-20250704-164936.png
  7. Select the system.webServer/serverRuntime

    image-20250704-165034.png
  8. set uploadReadAheadSize setting to 6655360

    image-20250704-165200.png


  9. Click Application Pools

    image-20250704-165238.png
  10. Right Click on IDMS.Core and select Basic Settings

  11. .NET CLR Version, select "No Managed Code"

    image-20250704-165346.png


Test the connection

Open a web browser, and enter the DNS of the IDMS.Core MicroService. If a gRPC message appears, the service is running.

image-20250704-182806.png

Troubleshooting:

HTTP 403.14 - Forbidden

Fix: Verify that the Windows Server Hosting is installed

image-20250704-173322.png