Troubleshoot Helix Plan integration issues

If problems occur when viewing related Helix Plan links on assets or saving Helix Plan webhooks, use the following information to troubleshoot and resolve the problems.

Warning icon and 'Helix DAM cannot connect to the application server' error when viewing Helix Plan links on assets

Problem

When viewing an asset with related Helix Plan links, no additional information about the Helix Plan item is displayed and a warning icon is displayed next to the link. Mouse over the icon to view more information.

This error indicates that either Helix DAM cannot connect to the Helix Plan instance or the Helix Plan item does not exist in the instance.

Solution

You can delete the link and try re-adding it to the asset to see if it works.

If the link still does not work, there is a Helix Plan connection problem. Contact your Helix DAM administrator for help.

'Invalid URL. Must start with http:// or https://' error when configuring the URL

Problem

When configuring the webhook and clicking the Finish button, an error message is displayed under the URL field.

This error indicates an invalid URL.

Solution

Use a valid URL that includes the following parts:

  • Starts with http:// or https://.

  • A hostname or IP address.

  • Optionally, a port number between 0 and 65535.

Examples of valid URLs:

  • http://helixplan.company.com/

  • https://helixplan.company.com/

  • https://helixplan.company.com:8443/

  • http://10.1.2.100/

  • https://10.1.2.200:8443/

'Invalid URL' error when configuring the URL

Problem

When configuring the webhook and clicking the Finish button, an error message is displayed under the URL field.

This error indicates an invalid URL caused by an invalid port number or other invalid URL syntax issues.

Solution

Check that your URL includes the following parts:

  • Starts with http:// or https://.

  • A hostname or IP address.

  • Optionally, a port number between 0 and 65535.

Examples of valid URLs:

  • http://helixplan.company.com/

  • https://helixplan.company.com/

  • https://helixplan.company.com:8443/

  • http://10.1.2.100/

  • https://10.1.2.200:8443/

'Invalid domain name in the URL' error when configuring the URL

Problem

When configuring the webhook and clicking the Finish button, an error message is displayed under the URL field.

This error indicates the domain name can’t be resolved to a valid server address due to a typo in the domain name or incorrect DNS settings on the Helix DAM Server.

Solution

Use a valid domain name or IP address in the URL.

'Connection refused. Invalid port number in URL or incorrect firewall configuration' error when configuring the URL

Problem

When configuring the webhook and clicking the Finish button, an error message is displayed under the URL field.

This error indicates a failed connection.

Solution

Use a valid port number between 0 and 65535.

Check your firewall configuration.

'http:// used in the URL, but requires https://' error when configuring the URL

Problem

When configuring the webhook and clicking the Finish button, an error message is displayed under the URL field.

This error indicates an invalid protocol in the URL.

Solution

Use the https: protocol in the URL.

'Connection failed. Invalid SSL certificate. Select 'Insecure SSL'' error when configuring the URL

Problem

When configuring the webhook and clicking the Finish button, an error message is displayed under the URL field.

This indicates an invalid SSL certificate (self-signed).

Solution

Select the Insecure SSL checkbox.

'Login failed. Verify the specified credentials are correct' error when configuring the Authentication parameters

Problem

When configuring the Authentication parameters and clicking the Finish button, an error message is displayed under the Username and Password or token fields.

This indicates your log in credentials are incorrect.

Solution

Reenter your log in credentials.

'Invalid domain name in the proxy URL' error when configuring the Proxy configuration

Problem

When configuring the Proxy configuration, an error message is displayed under the Custom proxy URL field.

This indicates an invalid proxy URL.

Solution

Use a valid domain name or IP address in the proxy URL.

'Connection refused. Invalid proxy port number in the URL or incorrect firewall configuration' error when configuring the Proxy configuration

Problem

When configuring the Proxy configuration, an error message is displayed under the Custom proxy URL field.

This indicates a failed connection.

Solution

Use a valid port number between 0 and 65535.

Check your firewall configuration.

'Cannot communicate with Helix Plan. Check the connection information or contact your Helix Plan administrator for help' error when configuring the URL

Problem

When configuring the webhook and clicking the Finish button, an error message is displayed under the URL field and the Custom proxy URL fields.

This error indicates a communication error between Helix DAM and the Helix Plan Server.

Solution

Verify the information is correct in the URL field and the Proxy configuration field under Advanced settings.

Make sure the Helix Plan Server is running.

Check the network configuration.