Version: 2023.2
Language : English
Enable automatic proxy configuration
Trusting the web proxy security certificate

Store credentials for automatic proxy configuration

If your organization’s web proxy requires user authentication and is configured to accept basic authentication (username and password), users must store their credentials before using Unity applications.

If you use Unity on Windows, follow the procedure below. For other platforms and environments, refer to Alternatives for other platforms and environments.

Before you begin, make sure you enable automatic proxy configuration.

Procedure

Follow these steps to store your proxy credentials in Windows, replacing the proxy address of webproxy.mycompany.com and the user name of proxyuser.

  1. To open Credential Manager, type credential manager in the search box on the taskbar to find Credential Manager Control panel.

  2. Open Credential Manager.

  3. Select Windows Credentials.

  4. Select Add a generic credential.

    Add a generic credential in Windows Credential Manager
    Add a generic credential in Windows Credential Manager
  5. For Internet or network address, type the web proxy’s host name or IP address.

  6. Type your Username and Password.

    Type the proxy address and your credentials in Windows Credential Manager

  7. Click OK.

Unity applications will use these stored credentials when authenticating with the specified web proxy.

Alternatives for other platforms and environments

Some platforms and environments don’t fully support Unity’s automatic proxy configuration feature, or the storage of user credentials, or both. Some examples are:

  • macOS, which supports Unity’s automatic proxy configuration feature, but doesn’t support storage of user credentials.
  • A continuous integration (CI) or continuous delivery (CD) environment, where a pipeline (rather than a user) interacts with the web proxy.

In such cases, consider the following alternatives:

  • For CI\CD pipelines that run in a Windows environment, use cmdkey to add credentials to Windows Credential Manager from the command line interface (CLI). Refer to cmdkey on Microsoft Learn for examples.

  • For environments that don’t support storage of credentials, you can define the proxy configuration in environment variables. This definition can also include username and password, if necessary. For more information, refer to Use environment variables to identify your web proxy.

  • If neither basic authentication nor Unity’s automatic proxy configuration is an option, you’ll need to define exceptions in your web proxy so it doesn’t require authentication for resources requested by Unity applications.

Next steps

Additional resources

Enable automatic proxy configuration
Trusting the web proxy security certificate