RoboServer 設定 - ヘッドレス モード
Kofax RPA には RoboServer をコマンド ラインで設定するためのユーティリティがいくつか同梱されています。ユーティリティの場所は、Kofax RPA インストール フォルダの bin サブフォルダの中です。設定ファイルはユーザー依存で、ユーザー フォルダに保存されます。詳細については、『Kofax RPA インストール ガイド』 の「Kofax RPA の重要なフォルダー」を参照してください。
- ConfigureRS: JMX パスワードと Management Console パスワードを RoboServer 設定ファイル (roboserver.settings) に設定します。
- ConfigureMC: mc.settings ファイルで、プロトコルとポートの使用、証明書のパスワード、 JDBC jar ファイルのアップロード権限を設定します。
- ConfigureRSUser: ユーザーの追加や除去を行い、rsusers.xml ファイル内のユーザー クレデンシャルをアップデートします。このファイル内の情報を使用して、API 要求を認証します。
使用上のヘルプについては、 -h オプションでユーティリティを実行します。
Management Console (RoboServer の登録先) に接続を設定するには、次のコマンドをタイプします。
ConfigureRS -mcUrl http://admin:password@localhost:8080/ManagementConsole
すべての権限と Password1 というパスワードを持つ user1 というユーザーを作成するには、次のコマンドをタイプします。
ConfigureRSUser user1 Password1 -a
API 要求の認証を有効にするには、rsusers.xml を開いて、有効になっている属性を true にする必要があります。以下に例を示します。
- rsusers.xml 設定ファイルのサンプル
-
<?xml version="1.0" encoding="UTF-8"?> <userConfiguration enabled="true"> <users> <user username="user1" password_hash="20c7628c31534b8718a1da00435505e4262e3f4dc305"> <startRobot/> <stopRobot/> <shutdownRoboServer/> </user> </users> </userConfiguration>
- roboserver.settings 設定ファイルのサンプル
-
# Settings file for RoboServers. Some configurations contains encrypted passwords and should not be edited by hand, these should be modified using dedicated commandline tools. # The directory for use on RoboServers when the API used the DefaultRoboLibrary. On Windows \ must be escaped in the following way: c:\\\\users\\AppData\\Local\\Kofax RPA\\... defaultProject = /home/TestUser/Kofax RPA/trunk # Should RoboServers be allowed to access the fileSystem, or call commands/scripts. Values: true/false sec_allow_file_system_access = false # Will RoboServers accept JDBC drivers sent from the Management Console. Values: true/false sec_accept_jdbc_drivers = true # Should RoboServers log all loaded URLs to the log4j2 audit log. Values true/false sec_log_http_traffic = false # If enabled RoboServers will check credentials for API requests. Values: true/false sec_authenticate_api_requests = false # If enabled RoboServers generate an error when accessing a https site without a valid certificate. Values: true/false cert_verify_https_certificates = false # If enabled, RoboServers will only allow SSL connections from trusted client. Values true/false cert_verify_api_certificates = false # Configures if the the JMX service should be enabled enable_jmx = false # The port number for the JMX service to listen on. jmx_port_Number = 50100 # If enabled, input for robots is exposed through JMX. Values: true/false jmx_show_inputs = true # Heartbeat notification interval, in seconds jmx_heartbeat_interval = 0 # Configure if JMX should use RMI enable_jmx_rmi = false # Optional RMI host and port for the JMX service. Use if you need to connect through a firewall. Example: example.com:51001 jmx_rmi_url = # Enables authentication for JMX requests. Values: true/false jmx_enable_authentication = true # The user-name used for JMX authentication jmx_username = # The password used for JMX authentication. This should be created using the ConfigureRS command line tool. jmx_password = # Configures if the socket service should be enabled enable_socket_service = false # Configures which port the RoboServers should be listening on port = 50000 # Configures if the ssl socket service should be enabled enable_ssl_socket_service = false # Configures which ssl port the RoboServers should be listening on ssl_port = 50001 # Configures if the JMS service should be enabled enable_jms_service = false # Configures which id the RoboServers should have when running JMS jms_id = 1 # Configures the URL of the message broker when running JMS broker_url = # Specify which Management Console to register to formatted as: http[s]://<hostname>:<port number> mc_URL = # The user name to use for authentication to the Management Console mc_username = # The password to use for authentication to the Management Console mc_password = # Specifies which cluster the RoboServers should be registered to cluster = # Causes RoboServers to output status and runtime events verbose = false
- mc.settings 設定ファイルのサンプル
-
# Settings file for Management Console. Passwords should not be edited by hand, but using the 'ConfigureMC' command line utility. # Should the MC web-server start a HTTP listener. Values true/false mc_http = true # Configures the port of the http listener. mc_http_port = 50080 # Should the MC web-server start a HTTPs listener. Values true/false mc_https = false # Configures the port of the HTTPS listener. mc_https_port = 50443 # Password for the certificate used by the HTTPs listener. This should be created using the ConfigureMC command line tool. mc_https_cert_password = 3W2MTrL/b2k= # Configures which hosts are allowed to upload JDBC jar files to MC. Values: NONE, LOCALHOST, ANY_HOST mc_allow_jdbc_upload = LOCALHOST