Command Reference

adwebproxyconf

The adwebproxyconf command configures the HTTP proxy server settings and credentials on the local system. Typical use cases are:

  • Set up the HTTP proxy credential to be used by agent.
  • Delete the HTTP proxy credentials.
  • Get information about the HTTP proxy credentials.
  • Test the proxy connection using the configured credentials
  • Test the proxy connection using the supplied credentials

Requirements

  • Only root can run this command.
  • To run, the system must have joined a zone.

Synopsis

adwebproxyconf --set,-S [--username,-u <username>] 
[--password, -p <password>]  [--machine,-m] 
[--server,-s <servername:port|"">] 
[--authreq,-r <true|false|"">] 
[--authtype,-t <basic|digest|ntlm|negotiate|anyauth|"">], 
'--version,-v','--help,-h' and '--verbose,-V'
adwebproxyconf --delete,-D 
adwebproxyconf --list,-L
adwebproxyconf --test,-T <--cip,-c <cip url> > 
[--server, -s <servername:port>] 
[--username,-u <username>] 
[--password, -p <password>]  [--machine,-m]

Command options

--set,-S

Set the HTTP proxy server and credentials for the local system. After using adwebproxyconf -S, use adreload to force the Centrify agent process (adclient) to reload its configuration files.

the configuration properties in the /etc/

centrifydc.conf file and in other files in the /etc/

centrifydc directory.

--delete,-D

Delete the HTTP proxy credentials from the local computer and reset the HTTP Proxy configurations in centrifydc.conf:

  • HTTP Proxy Server
  • HTTP Proxy authentication type
  • HTTP Proxy authentication required
--list,-L

List the HTTP proxy username and server from the configuration on the local system.

--test,-T

Test the HTTP proxy credential using configured or supplied settings.

--username,-u <username>

Proxy username. If a username is not supplied but --password is supplied, the username defaults to Administrator'

--password, -p <password>

Proxy user's password, if not provided, will be prompted

--machine,-m

Use local machine account for proxy authentication, and SPNEGO authentication is used.

This option cannot be used with -u, -p, or -t.

--authreq,-r <true|false|"">

Specify if HTTP Proxy authentication is required in centrifydc.conf, Optional.

Can use individually or with other options.

--authtype,-t <basic|digest|ntlm|negotiate|anyauth|"">

Specify if HTTP Proxy authentication authentication type in centrifydc.conf. Optional.

Please refer to above section for valid values.

Can use individually or with other options.

--server, -s <servername:port|"">

Specify HTTP Proxy Server to use to update to centrifydc.conf. Optional.

Empty string unsets the value in centrifydc.conf.

Can use individually or with other options.

--version,-v

Specify the version.

--help,-h

Get command line help.

--verbose,-V

Get additional details while the settings are being applied.

--cip,-c <cip url>

Specify the URL of the Cloud Identity Platform.

Must be specified.

--server, -s <servername:port>

Specify HTTP Proxy Server to test.

If not specified, get it from centrifydc.conf

--username,-u <username>

Proxy username.

If not specified, get it from proxy cred file.

-–password,-p <password>

Proxy user's password.

If username is specified, but password is not, prompt for it.

If both username and password are not specified, get it from proxy cred file.

-–machine,-m

Use local machine account for proxy authentication, and SPNEGO auth type is used.

This option cannot be used with -u, -p, or -t.

This test option always use the proxy credential to check the connection to CIP thru the specified HTTP Proxy server.

You can also use the adcdiag command to check HTTP proxy server settings.