Hitachi

JP1 Version 12 JP1/Client Process Automation Configuration and Administration Guide


2.3.4 Using the Windows log-on function

To use the Windows log-on function, you have to set it up.

The Windows log-on function is available only with Windows 10. Do not set up this function with an OS other than Windows 10. If you set up this function with an OS other than Windows 10, unset up the function.

For details on the Windows log-on function, see 4.2.1 Windows log-on function.

CPA virtual users to be linked with information regarding the users logging on to Windows (Windows user names and passwords) must be registered in the user mapping file (usrprof.xml). You must therefore register virtual users when setting up the Windows log-on function.

Organization of this subsection

(1) Setting up the Windows log-on function

The procedure for setting up the Windows log-on function is provided below.

After setting up the function, restart the machine.

  1. As a member of the Administrators group, log in to the host on which to set up the Windows log-on function.

  2. Start the command prompt by selecting Run as administrator.

  3. Execute the following command:

    cpaalsetup

    For details on the setup command (cpaalsetup), see cpaalsetup in 9. Commands.

  4. Restart the machine.

Important
  • If, in addition to CPA, an application in which the customized Windows log-on function is implemented runs in your environment, confirm that the application works fine even when the Windows log-on function is used. Even when the log-on action of the Windows log-on function implemented on CPA ends successfully, logging on to Windows while not logging on to the other application running in your environment can cause a problem.

    Examples of applications that customize the Windows logon function

    - JP1/HIBUN Data Encryption

    [Figure] [Figure] [Figure] [Figure]HIBUN login window

    [Figure] [Figure] [Figure] [Figure]Extended authentication

    - JP1/HIBUN Device Control

    [Figure] [Figure] [Figure] [Figure]Screen Lock function by area search

  • When you no longer need the Windows log-on function, (when you set up the function with an OS other than Windows 10), or when a problem is discovered during the verification of Windows log-on behavior, you must use the cpaalsetup command to unset up the Windows log-on function. For details on the cpaalsetup command, see cpaalsetup in 9. Commands.

  • If the cpaalsetup command is executed by a user who does not have administrator privileges, the command ends abnormally with a return value of 52. Always execute this command with administrator privileges.

  • If the cpaalsetup command is executed while a file managed by CPA is opened in either a security software program or a text editor or when a log-on window is open, the command ends abnormally with a return value of either 45 or 111.

    When you execute this command, ensure that no file managed by CPA is open and that the log-on window is not displayed.

  • If you execute the cpaalsetup command when the setting specified for the PATH environment variable exceeds 1,958 bytes in length, the command might end abnormally with a return value of 119. When you execute this command, ensure that there is sufficient empty space in the length reserved for the PATH environment variable setting.

  • Do not execute the cpaalsetup command while a Remote Desktop connection is established.

(2) Setting virtual users

To register both virtual users and the user information to be linked to the virtual users in the user mapping file (usrprof.xml), you have to execute the cpasetumap command. For details on the cpasetumap command, see cpasetumap in 9. Commands.