Set up a proxy
A proxy server is an intermediary between your local machine and the Internet. If your network requires a proxy, you need to configure it for the local components of Tosca Cloud so they can connect to the cloud.
Before you start
Make sure you have all the necessary information before you configure the proxy.
Determine if you need a proxy
Typically, whether you need a proxy or not depends on your company's internal policies and network setup. If your personal workstation or a testing VM is configured to use a proxy server, then, in most cases, Launcher must use it too, otherwise the local Tosca Cloud components, such as agents or a local module scanner, can't connect to the cloud and won't work properly.
By default, Launcher detects if a proxy is needed, and if so, it automatically retrieves the proxy configuration from your operating system. If that's not possible, Launcher sends you a notification that you need to manually enter the proxy details.
Get the proxy configuration details
You'll need the following information for the proxy setup:
- The proxy server's address (URL).
- The port number.
- The username and password, if the proxy server requires authentication.
Add or update proxy settings
To configure Launcher to use a proxy server, open the command prompt window and run the following command:
launcher configure-proxy --host <proxy server's address> --port <port number> --username <your username> --password <your password>
Host and port are mandatory. Username and password are only needed if the proxy server requires them.
To replace any existing proxy settings in Launcher with new ones, use the same command.
You can't display or review the proxy settings after you add them. If you're unsure whether they're correct or up to date, add them again.
Remove proxy settings
To stop using a proxy with Launcher, open the Command Prompt window and run the following command:
launcher remove-proxy
What's next
Now that your proxy is set up, Launcher can connect to the cloud. Check out Launcher overview to learn more about what Launcher does and how it works.