Securely Passing Parameters via the Command Line¶
In addition to passing arguments via the Command Line, you can also provide parameters via the standard input stream using the --ask-extra-args-as-json
parameter. This approach is preferred when you want to pass sensitive data, such as user credentials, to the pcoip-client
process. The --ask-extra-args-as-json
parameter accepts arguments as JSON strings, thereby ensuring that user data is prevented from being recorded in the shell history.
To launch the client, using the --ask-extra-args-as-json
parameter:
-
From the CLI, run the following command:
2. When the following prompt appears, provide the required arguments as a JSON string:pcoip_client_cli.exe --ask-extra-args-as-json
These arguments are passed through the standard input of the `pcoip-client process, and are not recorded in the command history or process list.Arguments should be specified with '-' prefixes and flags specified under a 'flags' section. For example: {"--username": "alice","flags": ["--use-egl"]} For a more detailed description of the format, please see the help by using flag --help. Please enter extra arguments (as JSON):
JSON String Format¶
The JSON string should consist of key value pairs, such that the keys are the names of the command line parameters and the associated values are the values of the parameters.
- The keys in the JSON object must be strings enclosed within quotes.
- The parameters may be specified in long form, for example,
--username
. They can also be specified as short form. For example,-u
. - Parameters can be of the following types: string, boolean, or numeric.
- The JSON object cannot contain new lines. It can contain spaces and tabs.
- Flags such as
--help
and--use-egl
that have no associated values can be included as values in the special "flags" array.
Here are some examples of valid JSON strings, which can be passed to the client from standard input of the pcoip-client
process:
{ "-u": "<username>", "-p": "<password>", "--connection-broker": "<connectionManager>", "--domain": "<domain>", "--log-level": 3 }
{ "--connect-tag": "<encodedConnectTag>", "--session-id": "<encodedSessionId>" }
{ "flags" : ["--use-egl"] }