Connections
UniPortal does not require multiple instances to function. It operates perfectly on a single Jira Service Management instance, serving as a custom landing page and upgrading the native customer view with an advanced request table.
How to connect tools
- Go to the global settings > UniPortal > Connections
- Click Connect new tool
- Choose which tool you want to connect:
- Jira Service Management (JSM): You will be automatically redirected to the native Atlassian authorization page to grant permissions via a 3LO app.
- Salesforce: Enter your Salesforce instance credentials and complete the authentication setup screen to finalize your Salesforce to Jira integration.
- Azure DevOps: Provide your Azure DevOps instance details and authenticate using a secure token.
After completing this procedure, your connected instance will appear in the dashboard. For JSM environments, one specific instance will be visually designated as the “Master”.
Tip
By default, the name in the Connected tool column is the base URL from your Instance URL. Because this exact name will be displayed on the customer portal as the tab title where users view their tickets, we highly recommend clicking the pencil icon to edit and rename it to something clear (e.g., “IT Help Desk” or “Dev Tasks”).
Inside the connections dashboard
At the very top of the screen, you will find quick-reference cards showing your essential licensing metrics: your total number of licensed users and exactly which JSM environment is currently being counted toward your license size.
Right below that sits your main configuration table, which breaks down everything you need to know about your integrations at a glance:
- Connected tool: Shows the platform icon, its display name, and system badges like the purple “Master” tag
- Instance URL: A direct, clickable link to that specific platform’s base address
- Connected by: Tells you exactly who authorized the connection
- Status: A live, green “Connected” badge letting you know the integration is up and running smoothly
Quick actions you can take here:
- Edit layout: Jump straight into configuring the ticket tables and custom fields for that specific instance.
- More options (…): Found at the far right of each row whenever you need to reconnect or delete an integration.
Caution
A critical rule for configuration is that all connected instances must be authorized by the exact same user account. If a different user attempts to authorize a subsequent instance, it will automatically deauthorize the previously connected sites. To prevent this, you must use a dedicated “technical user” (service account) to handle all instance authorizations.