Troubleshoot your connection to Enterprise Insights

If you’re having trouble connecting your software and systems to Enterprise Insights (EI), here are a few things to check before reaching out to Atlassian Jira Align Support.

Note: If you’re unable to connect to your EI instance, Jira Align Support will not be able to view any log entries or other information that can help uncover the root cause of an issue. Our teams can only access logs for a connected environment. A problem with the initial connection is often caused by a configuration or setting choice made on your corporate network, data visualization software, or other tools that connect to EI.

On this page:

• Check outbound traffic
• Check network settings
• Check authentication settings
• Check server and database names
• Still need help?

Check outbound traffic

Confirm with your network team that your firewall allows outbound traffic on TCP port 1433. You can check this by attempting to access the Microsoft Azure gateway IP addresses for the region your Enterprise Insights instance is hosted on. EI is hosted in the following Azure regions:

• Central US
• West Europe
• Australia East

Each region has a unique set of gateway IP addresses. See the full list on Microsoft’s Azure Architecture site. 

You can also use the Azure SQL Connectivity Checker from Microsoft to test the connection to your EI server name and database.

Note: If your business intelligence tools are hosted on an Azure hosted server, you will need to open additional ports to use Azure's Redirect connection policy. 

Check network settings

When using IP allowlisting (standard connections)

If you use IP allowlisting to connect to EI, you created firewall rules in the Enterprise Insights settings page or setup wizard. Examine the following conditions to ensure there’s a match between the IP addresses created in your rules and the IP addresses attempting connection from your network:

• Verify that the NAT IP addresses and ranges created in firewall rules are correct, public, and static.
• Confirm that your users are connected to your corporate network or VPN when attempting to connect to EI.
• If connecting through a VPN, work with your network team to ensure that a user’s home IP address is not being passed on to EI. Some VPNs separate traffic on and off the corporate network. Only your company’s network IP addresses that were configured in firewall rules will be able to connect.

When using the VPN connection option with VPC

If you use the VPN connection option for EI VPC, check the following:

• Ensure that you've created a DNS A record within your private network, overriding the public IP address of the SQL server with the private IP address provided after you completed the Enterprise Insights VPN Connectivity Questionnaire.

Check authentication settings

Enterprise Insights access can be authenticated through Microsoft Entra. Ensure that your Azure presence has been configured to allow guest authentication tenant access. For more information, review Microsoft’s article on allowing guest access.

Check server and database names

When connecting to your Enterprise Insights instance, ensure that the correct EI server name and database names are entered correctly in your data visualization software, SQL editor, or other tools. If a database name is not specified, EI will attempt to connect to the Master DB, which will result in an “IP address not allowed” error.

Still need help?

If you’ve followed the guidance in all of these troubleshooting steps and still can't connect to Enterprise Insights, please open a support ticket with Atlassian Jira Align Support.