Skip to main content

Illumio Core What's New and Release Notes for Release 24.2

Support for Proxy

Release CLI 1.4.3 includes support for authenticated and unauthenticated proxies.

Type the ilo login --help command to see proxy-related options.

Table 2. ilo login --help

Command Options

Description

-v, --verbose

Verbose logging mode

--trace

Enable API Trace Mode

--server SERVER_NAME

Illumio API Access gateway server name

--login-server LOGIN_SERVER

Illumio login server name

--kerberos-spn KERBEROS_SPN

Illumio Kerberos SPN Kerberos authentication is only applicable to --login-server option

--proxy-server PROXY_SERVER

proxy server

--proxy-port PROXY_PORT

proxy port

--proxy-server-username PROXY_SERVER_USERNAME

proxy server username

--proxy-server-password PROXY_SERVER_PASSWORD

proxy server password

--logout

Logout

--username USER

User Name

--username USER

User Name

--auth-token AUTH_TOKEN

authorization token



Connecting via a Proxy

The command for connecting via an unauthenticated proxy:

❯ ilo login --server <fqdn:port> --proxy-server <proxy_ip> --proxy-port <proxy_port> --user-name [email protected]

An example of connecting via an unauthenticated proxy:

❯ ilo login --server 2x2testvc308.ilabs.io:8443 --proxy-server 10.2.184.62 --proxy-port 3128 --user-name [email protected]

An example of connecting via an authenticated proxy:

❯ ilo login --server 2x2testvc308.ilabs.io:8443 --proxy-server devtest30.ilabs.io --proxy-port 3128 --user-name [email protected] --proxy-server-username proxy_user --proxy-server-password proxy_124

After the command is executed, users are prompted to enter the PCE user's password, and then a session will be created in the context of the proxy server.

From this point on, all connections/traffic will use the proxy to send traffic.

Using API Keys and Secrets with a Proxy Server

With the command ilo use_api_key , you can use an API Key and a secret with a proxy server:

Table 3. ilo use_api_key --help

Command options

Description

--key-id

API Key ID

--key-secret

API Key Secret

--org-id

Illumio Org ID

--user-id Illumio

User ID

-v, --verbose

Verbose logging mode

--trace

Enable API Trace Mode

--server SERVER_NAME

Illumio API Access gateway server name

--login-server LOGIN_SERVER

Illumio login server name

--kerberos-spn KERBEROS_SPN

proxy server

--proxy-port PROXY_PORT

proxy port

--proxy-server-username PROXY_SERVER_USERNAME

proxy server username

--proxy-server-password PROXY_SERVER_PASSWORD

proxy server password



The command for using an API Key with an unauthenticated proxy:

❯ ilo use_api_key --key-id <key_id> --key-secret <secret> --server <pce_fqdn> --org-id <orgid> --proxy-server <proxy_server> --proxy-port <proxy_port>

The command for using an API Key with an authenticated proxy:

❯ ilo use_api_key --key-id <key_id> --key-secret <secret> --server <pce_fqdn> --org-id <orgid> --proxy-server <proxy_server> --proxy-port <proxy_port>  --proxy-server-username <proxy_username> --proxy-server-password <proxy_password>

After a command is executed,  all connections/traffic from this point on will use the proxy.