Skip to main content

Repositories

The Repositories Tab lists every team you belong to and its associated code repository platform integrations. Team Owners can add and manage the team's integrations, and Team Members can view details about the team's repository integrations and use them in the team's component implementations and workflows.

Image41

Repository Integrations#

Tangram Pro™ currently supports integrations with GitHub, GitLab, and Bitbucket, and can be used to connect to repositories via Distribution Key. Connecting to code repository platforms requires navigating between your Platform's site and Tangram Pro™.

How to connect Tangram Pro™ to code repositories#

  1. Click on the Repositories Tab
  2. Click the + Integration button for a team of which you are a Team Owner
  3. Select the platform you wish to integrate and complete OAuth Setup for the integration following the instructions for that platform
  4. Select your new integration and click Setup Integration Account
  5. Complete account setup on your repository platform
tip

Tangram Pro™ can be integrated to multiple repository platforms for each team, but only one account may be used for each individual platform integration. We recommend creating a master team account for each platform for this purpose.

Image42

note

Each supported platform has unique OAuth setup requirements. The sections below provide instructions for each.

Image43

OAuth Setup#

To create code repository platform integrations, Tangram Pro™ must be registered as an OAuth Application of your platform.

OAuth is an open-standard authorization protocol commonly used to grant applications secure access to resources through access tokens.

Tangram Pro™ integrates with GitHub.com, GitLab.com, and Bitbucket.com code repositories. These integrations require registering Tangram Pro™ as an OAuth Application of the platform.

How to connect to GitHub, GitLab, or Bitbucket#

  1. Click on the Repositories Tab of an organization for which you are an Owner
  2. Click Connect to Platform
  3. Select the Platform to integrate with
  4. Click Register a new OAuth App button in the Connect to Platform modal
  5. Complete OAuth Registration on your platform's site
  6. Return to Tangram Pro™
  7. Name your Integration and enter the Client ID and Client Secret provided by your Platform
  8. Click Complete Setup

The Add Platform Modal will close and your new integration is shown in the Repositories Tab.

Register Tangram Pro™ as an OAuth Application#

Selecting GitHub, GitLab, or Bitbucket from the Platform Selector opens the Add Platform Modal. The modal provides the Homepage URL and Authorization Callback URL that you will need for registering Tangram Pro™ as an OAuth application.

Image44

Clicking the Register a new OAuth App button will open a new browser tab and load the selected platform for setup. You will need to follow the instructions from your platform to complete registration. Each Platform has a slightly different workflow.

For GitHub.com#

GitHub's OAuth Application Registration page is opened automatically.nGitHub requires the Homepage URL and Authorization Callback URL provided in Tangram's *Add Platform Modal.*

For GitLab.com#

GitHub's OAuth Application Registration page is opened automatically. GitHub requires the Authorization Callback URL provided in Tangram's Add Platform Modal to be added in its Redirect URI Field.

For Bitbucket.com#

Bitbucket's Settings page is opened from Tangram Pro™ and requires a little extra work.

  1. Click OAuth
  2. Click Add Consumer
  3. Complete New Application registration in Bitbucket using the Authorization Callback URL provided in Tangram Pro™

Integration Completion#

After registering Tangram Pro™ as an OAuth application it's time to complete setup. Return to Tangram Pro™ to finish up in Step 2.

Enter an Integration Name, then copy and paste the Client ID and Client Secret provided by your platform and click Complete Setup. The new Platform Integration will be shown in the Repositories Tab.

Image45

Enterprise Integrations#

Tangram Pro™ can be integrated with GitHub Enterprise, GitLab Enterprise, and Bitbucket Server accounts. Tangram Pro™ must be registered as an application for the Enterprise Platform. This process requires an extra step.

For GitHub and GitLab#

How to connect to GitHub or GitLab Enterprise#

  1. Click on the Repositories Tab of an organization for which you are an Owner
  2. Click *Connect to Platform
  3. Select the Platform to integrate with
  4. Enter your instance's host URL and click Continue
  5. Click Register a new OAuth App button in the Connect to Platform modal
  6. Complete OAuth Registration on your platform's site
  7. Return to Tangram Pro™
  8. Name your Integration and enter the Client ID and Client Secret provided by your Platform
  9. Click Complete Setup
note

The Add Platform Modal will close. Your new integration is shown in the Repositories Tab.

Image46

For Bitbucket Server#

Connecting Tangram Pro™ to Bitbucket Server follows a different type of workflow.

How to connect to Bitbucket Server#

  1. Click on the Repositories Tab of an organization for which you are an Owner
  2. Click Connect to Platform
  3. Select Bitbucket Server (PAT)
  4. Generate a Personal Access Token in Bitbucket
  5. Return to Tangram Pro™ and click Continue in the Add Platform Modal
  6. Name your integration and enter the Root URL, your Bitbucket Username, and the Personal Access Token generated in step 4
  7. Click Complete Setup

For Personal Access Token#

How to generate a Bitbucket Personal Access Token#

  1. Log in to Bitbucket Server in a new browser tab and click on your User Avatar
  2. Click Manage Account and select Personal access tokens
  3. Click Create a Token, then enter a name and click Create
important

Copy the token and return to Tangram Pro™

Enter the platform's details and integration name and click Complete Setup. The new integration will be shown in the Repositories Tab.

  • Root URL: your Bitbucket Server URL prepended with https://

  • Bitbucket Username: your username for Bitbucket Server

  • Personal Access Token: the token generated above

Image47

For Distribution Key#

Tangram Pro™ can integrate with code repository platforms using Distribution Key. Setup is straightforward using a single-step modal.

How to set up a Platform Integration using a Distribution Key#

  1. Click on the Repositories Tab of an Organization for which you are an Owner
  2. Click Connect to Platform
  3. Select Distribution Key
  4. Name your Integration and enter the Host, URLs, and SSH Key provided by your Platform
  5. Click Complete OAuth Setup
note

Your new Platform Integration will be shown in the Repositories Tab.

Image48

Integration Account Setup#

When OAuth is complete for either standard or enterprise platform integrations, you are ready to set up an integration account and get to work.

How to set up an Integration Account#

  1. Click on your new integration
  2. Click Setup Integration Account. This will open your platform's setup page in a new tab.
  3. Complete account setup on your repository platform

Your new Platform Integration setup is complete, and you can view all of your repositories in Tangram Pro™.

Image49

Managing Integrations#

Tangram Pro™ supports one integration account per platform. If you need to switch integration accounts, you will first need to clear the existing account and can then connect a new one.

How to clear an integration account#

  1. Click on an integration for a Team of which you are an Owner
  2. Click on the Settings Gear Icon
  3. Click Clear Account and confirm in the Confirmation Modal

Your integration account has been removed and you can now connect a different one.

Image50

Team Owners can change an integration name and remove it entirely using the settings menu.

How to change an integration name#

  1. Click on an integration for a Team of which you are an Owner
  2. Click on the Settings Gear Icon
  3. Click Edit Name
  4. Enter a new integration name and click Update Name

The integration name will be saved and updated throughout Tangram Pro™.

Image51

How to remove an integration from Tangram Pro™#

  1. Click on an integration for a Team of which you are an Owner
  2. Click on the Settings Gear Icon
  3. Click Remove Integration
  4. Click Remove Integration in the confirmation modal
warning

The integration will be fully removed from Tangram Pro™

Image52

Removing an integration will impact every Component integration that is connected to source code from the integrated platform's repositories, as well as every workflow that uses the repositories in its webhooks.