Change the session IDs

You can change the system session ID and limited system session ID of TotalAgility.

Change the system session ID

You can regenerate the session ID if there is a security breach or set this value. For example, regenerate the session ID if someone has used the session ID to access the system without approval, or set the value if moving from a development to production environment and you want to use the same session ID for both the environments.

  1. Navigate to System > System settings > Logon and authentication > User sessions.
    The User sessions dialog box is displayed.
  2. Do one of the following for System session ID:
    • To set the session ID value, enter or paste the value in the field. This value must be a GUID.

    • To regenerate the session ID, click Generate next to the field and click OK to confirm.

  3. Click Save.
  4. The changes in Session ID impacts the following TotalAgility configuration files: Export Service, Export Connector, and Core Worker Service.
    Once a new session ID is generated, you must manually update the application setting values with the newly generated session ID under <appSettings> section in the following configuration files:
    • ...\\<installation folder>\Kofax\TotalAgility\CoreWorkerService\Agility.Server.Core.ExportService.exe.config

      <add key="SystemSessionId" value="="
      <replace with the regenerated session id>"/>

    • ...\\<installation folder>\Kofax\TotalAgility\ExportConnectors\bin\RegAscSc.exe.config

      <add key="DefaultSessionId" value="
      <replace with the regenerated session id>"/>

    • ...\\<installation folder>\Kofax\TotalAgility\CoreWorkerService\Agility.Server.Core.WorkerService.exe.config

      <add key="SystemSessionId" value="="
      <replace with the regenerated session id>"/>

Important For the session ID changes to take effect, restart the TotalAgility IIS Application Pool, TotalAgility Core Worker Service, TotalAgility Streaming Service and Kofax Transformation Server Service. In an Azure environment, this change takes place automatically.

Change the limited user session ID

The limited user session ID is a mandatory field and is editable.

  1. Navigate to System > System settings > Logon and authentication > User sessions.
    The User sessions dialog box is displayed.
  2. Click Generate next to the Limited user session ID field.
  3. On the prompt, click OK to confirm.
  4. Click Save.