Advanced integration permissions

In response to our users’ needs, we have prepared some major changes to integration management structure.

Today, we replace previous limited sharing options with a brand new Permissions tab, where you can control who can do what with integrations. Since the options are now similar to how you manage permissions for pipelines, this improvement allows you to achieve level of flexibility not possible up until now.

Integration permissions

In the Permissions tab of an integration, you can grant different permissions to user groups or individuals. There are 4 predefined permission types:

• None (Deny): when set, users won't see the integration
• None (Delete-only): integration will be visible for administrators, and they will be able to delete, but not use or edit it
• Use: users will be able to use the integration
• Manage: open permission to use and edit the integration

Permissions tab in integration

Just as before, when adding an integration, it is added either with the Workspace or Project scope, depending on the place you add it from:

Integration scope

Allowed pipelines

In addition to that, we’ve added a possibility to decide which pipelines can use a specific integration. You can either allow all pipelines to use an integration, or restrict the permissions only to specific one(s).

If a pipeline run fails due to the Missing permissions to the following integration: error, a button will appear allowing you to grant permissions to this pipeline and retry the run. This feature is accessible to users holding the Use and Manage role within the integration. Adding pipeline to allowed pipelines in integration

Changes to API

The new permissions result in some changes to the REST API as well. The changes involve the scope of the integration being now limited to WORKSPACE and PROJECT and adding a new Permissions field.

Benefits

With these changes in place, you gain more control and flexibility in how you manage integrations. Explore the possibilities we enabled and customize your integrations based on your needs.

Keep an eye out for more exciting things coming soon!