Connectors
  • 25 Mar 2024
  • 5 Minutes to read
  • Dark
    Light
  • PDF

Connectors

  • Dark
    Light
  • PDF

Article Summary

Third-party platforms and services can be easily integrated into Liquit Workspace with the connectors feature.

Currently, the following connectors are available:

Connector dependency

A connector is used only when importing resources and updating them. There is no need for a high-availability infrastructure ( e.g. multiple Liquit Workspace Satellite Servers). When you delete a connector, all resources are imported through it in Liquit Workspace are not affected.



The following screens are common for all connectors.

Overview screen

On the overview screen, you can view/configure the global settings for the connector.

Main menu

In the main menu of the Overview screen you can access the following options:

resources.png Resources - Displays all the resources available in the remote system. This option is available for On-demand synchronization method. You can select one or multiple resources and click enlarge.png Create package to create new packages within your Liquit Workspace environment. Note that when creating a package, the Default value of the Package type represents the value you set for the connector, in Overview > Default package type.
updates.png Updates - Displays a list with all the updates available for the packages created through the connector. This option is available for On-demand synchronization method.
refresh.png Synchronize - You can choose to only check the new available updates or download and apply them.
For an On-demand type connector, Download and apply updates updates only the packages you created based on the connector resources.
For a Synchronize type connector, Download and apply updates updates all existing packages and imports new ones.
remove.png Remove - Remove the connector from Liquit Workspace.

Screen elements

Method - Determines how the connector should be synchronized:

  • On-demand - Synchronizes only the packages you created based on the connector resources.
  • Synchronize - This option will automatically synchronize all packages with new available information.

Direction - Determines in which direction the connector sends information:

  • Push - The connector will create packages in the remote system.
  • Pull - Packages can be created from resources or imported from the remote system.

Default package type - This option determines the way a package will be handled after creation:

  • Managed - the package is eligible for automatic updates and it has an action set that is locked for editing. You are still able to add new action sets to this package.
  • Unmanaged - the package is not eligible for automatic updates and no locked action sets are added.

Package name prefix - The default prefix used for the names of the new packages from the connector, which will help you to easily identify all packages originating from a certain connector.

Entitlements screen

This screen is used to manage entitlements on packages created through the connector. This allows you to assign a default set of entitlements for all connectors. Some connectors support importing entitlements from the remote system.

This screen is available only when the connector is created with the synchronized method.

Import entitlements section

With the import entitlements functionality enabled, you are able to add matching policies to match an identity (user, group, device or device collection) configured in the remote system with an identity known within Liquit.

Add matching policy dialog box

Overview tab

Identity Source - The Liquit Workspace identity source to match users and groups from the remote system.
Applies To - Which Liquit Workspace identity types (user, group, context, device, device collection) inside the selected identity source should be matched.
Property - The property of the Liquit Workspace identity to use when matching with the remote system.

Value transformation tab

Compare - What operator needs to be used on the property selected in the Overview tab.
Match - The regex used to match part or all of the properties from the remote system; use .\* to match all of the properties.
Result - The value to compare against the regular expression's result. To match against the exact same property, use ${0}. To match against a different property from a Liquit Identity, use one of the predefined identity variables that appear in the drop-down list of the field when you try to edit it. See Variables for a complete list of all predefined variables within Liquit Workspace.
identity-variables.png

Settings tab

Keep the default settings for publishing packages on user's devices or override them. See Packages for more information.

Manual entitlements

With the manual entitlements functionality enabled, you are able to add entitlements by hand. You can do so by selecting the + Add static button in the table toolbar.

Add static dialog box

In the Overview tab select the Liquit Workspace identity (user, group, context, device or device collection) you want to entitle.
In the Settings tab keep the default settings for publishing packages on user's devices or override them. See Packages for more information.

Synchronization profile screen

Synchronization profiles allows you to specify whether the Liquit system or the remote system is controlling some of the packages' information.
The following options are available:

Synchronize from connector - If the entity exists in Liquit, it is updated with the value provided by the remote system. Liquit will not attempt to create entities if they don't exist.
Synchronize from connector, create entity if not exist - Updates the existing entities and creates new entities if they don't exist in Liquit Workspace yet.
Set from connector during creation - Updates the existing entities and creates new entities if they don't exist in Liquit Workspace yet. Uses the value provided by the remote system only initially and it can be modified without it getting changed by the connector afterwards.
Create entity from connector during creation - Associates entities and creates new ones if they don't exist in Liquit Workspace yet. The entities can be modified after creation without them getting changed by the connector afterwards.
Static - If you select this option, an adjacent empty field or check box appears, that lets you configure a permanent value for this package option.
Ignore - Never retrieve the value/entity from remote system.

Releases screen

This page allows you to define the way releases should be created on packages. For more information about each type of publishing stage see Packages.

The Test and Acceptance stages are available only when you have a Release & Patch Management license.

Publish - The stage to which the packages are published by default.
Enable release retention - Enables the Remove releases older than and Keep number of releases sections on this screen.
Remove releases older than section - Set the number of days after which the releases are automatically removed.
Keep number of releases section- Set the number of releases that should be preserved.

Managed Packages screen

This screen shows a list of packages that are managed by this connector.


Was this article helpful?