Knowledge Base > Licensing > Network requirements for licensing
Network requirements for licensing
Diffblue Cover needs an active internet connection to authorize its use *. It needs to connect to both a Diffblue server and a LicenseSpring server; these servers are accessed on port 443:
- https://licensing.diffblue.com/
- https://api.licensespring.com/
To identify individual devices we transfer data about hardware components over this connection. Further details are available in the Privacy Notice.
* (Unless you are using Diffblue Cover Enterprise Edition, in which case please see these separate instructions.)
Troubleshooting
- Check you have an active internet connection at all times when using Diffblue Cover.
- Ensure you can access https://licensing.diffblue.com/ via a web browser; you will automatically receive a confirmation message when this is successful.
- Ensure you can access https://api.licensespring.com/ via a web browser, you should see the message “Welcome to the LicenseSpring API”.
- Ensure that any Proxy Server settings are correctly setup (see the bottom of this page).
- Please speak to your network manager about whitelisting the URLs above, and checking that port 443 is open.
- For the Diffblue Cover IntelliJ Plugin, restart IntelliJ.
- Try temporarily disabling anti-virus, malware detector or any firewall software.
- A detailed logfile is available which shows further diagnostic information about the license check process - please review the logs:
- IntelliJ Plugin: https://docs.diffblue.com/knowledge-base/intellij/log-file/
- CLI: https://docs.diffblue.com/knowledge-base/cli/log-file/
For further help troubleshooting licensing network connection issues, please contact Diffblue Support.
Using a Proxy Server
Diffblue Cover IntelliJ Plugin
Please ensure you have the Proxy Server details configured in the IntelliJ settings page and then restart IntelliJ:
- Windows and Linux: File | Settings | Appearance and Behavior | System Settings | HTTP Proxy
- macOS: IntelliJ IDEA | Preferences | Appearance and Behavior | System Settings | HTTP Proxy
Please also see the HTTPS certificate errors information below.
Diffblue Cover CLI
Diffblue Cover CLI utilizes the system Java proxy configurations; these can be set via the environment variable JVM_ARGS
which details the proxy server FQDN and port, for example:
JVM_ARGS="-Dhttps.proxyHost=proxy.domain.com -Dhttps.proxyPort=8080"
As shown in this example:
JVM_ARGS
passes extra options to the Java process from Diffblue Cover.- Passing
-Dname=value
sets a system property. You can use system properties to set the proxy config as shown here: https://docs.oracle.com/javase/8/docs/technotes/guides/net/proxies.html
HTTPS certificate errors
If you have a proxy server that rewrites HTTPS connections and packages them with its own certificate, you may get an L018 output code. The simplest way to fix this is to disable certificate checks. You can do this by setting either the java system property dcover.disable.ssl.license.cert.check
or the environment variable DCOVER_DISABLE_SSL_LICENSE_CERT_CHECK
to true
. In IntelliJ you can add system properties using Help -> Edit custom properties...
. This will open a file to which you should add a line such as:
dcover.disable.ssl.license.cert.check=true
If you are using the CLI, it is usually easier to set the environment variable, for example:
DCOVER_DISABLE_SSL_LICENSE_CERT_CHECK=true
To avoid typing this every time you use the product, you should set this variable in your user profile or startup scripts. For help, please contact Diffblue Support.
Offline Mode and Offline License Activation
Users of the Diffblue Cover Enterprise Edition are not required to maintain an active internet connection. In addition Enterprise users can use the Cover CLI command dcover activate --offline
to activate a license while offline. For more details follow the articles here: