Connecting to License Vault

Last modified: 18 December 2024

This section explains how JetBrains products interact with License Vault to obtain a license and which other services are involved in the process. It also provides guidance on connecting to License Vault via proxy.

Connections established to obtain and use a license

The diagram below illustrates all of the connections established between your product, License Vault, and authentication services from the moment you initiate the activation procedure.

License Vault connections diagram

  1. When you enter the License Vault URL in the product activation dialog and click Activate, your product connects to License Vault.

  2. When you click the authentication link in the activation dialog, the product opens your web browser.

  3. The browser takes you to JetBrains Hub to select your preferred authentication provider.

  4. You're redirected to the authentication provider website, where you enter your credentials and log in. This happens automatically if only one authentication module is configured in your JetBrains Hub.

  5. Once logged in, you return to your JetBrains product and click Activate again. At this point, the product connects to License Vault with the authentication token received from JetBrains Hub.

  6. License Vault connects to JetBrains Hub to verify the token.

  7. Once the token is verified, License Vault provides a license to the product.

  8. When activation is completed, the product connects to JetBrains Hub in the background from time to time to refresh the authentication token.

Connecting to License Vault via a proxy

You can use either of the methods described below to make JetBrains products connect to License Vault via a proxy.

note

Before you configure the settings, make sure the following URLs are reachable via your proxy. Otherwise, your products won't be able to connect to License Vault.

  • The License Vault URL: https://<servername>.fls.jetbrains.com

  • The authentication URL: https://<servername>.oauth.fls.jetbrains.com

In both URLs, <servername> stands for the name specified by the License Vault administrator during setup.

Default proxy settings

Normally, JetBrains products use their default proxy settings to connect to License Vault. For instructions on how to configure these settings, refer to the documentation of the product you're using. For example, here are the instructions for IntelliJ IDEA.

JVM option

For the products that can be configured with JVM options, you can override the default proxy settings using the -Djba.http.proxy option. For the option's value, provide the proxy URL and, optionally, the port number. Here's an example:

-Djba.http.proxy=http://my-proxy.com:4321.

With this configuration, the product will use the proxy specified in the JVM option to connect to License Vault and JetBrains Account and the default settings for all other connections.

To check whether your product supports JVM options and how to specify them, refer to your product's documentation. For example, here are the instructions for IntelliJ IDEA.