Skip to main content
Version: v2.10.0

Git Credentials (Linked Accounts)

Git credential management lives in Settings → Linked Accounts. Linking a Git provider account lets you access repositories directly from a workspace: creating Git folders, syncing repositories, and managing code files inside the platform.

info

A linked account is a prerequisite for cloning. The Git Provider dropdown on the Git Repository Information modal is constrained to the providers you've linked here. See Git Clone (Git Folder).

  1. Click your username / avatar in the top-right corner of any page.
  2. Select Settings from the dropdown.
  3. In the left rail, under the USER group, click Linked Accounts.

The page opens at /tenant/{tenantId}/settings/linked-accounts.

git_credential.png

Settings left rail

The Settings page groups its pages into two sections:

GroupPages
USERToken, Linked Accounts
ADMINCloud Environment (expandable → Networks, Bootdisks), Credentials, Mounts

Page layout

The page is headed "Set your Git provider and personal access token" and shows three provider tiles:

TileState observed in this build
GitHubActive — bordered, full colour, selectable
GitLabGreyed out, doesn't respond to clicks
BitbucketGreyed out, doesn't respond to clicks

Beneath the tiles the page explains:

Connect to your Git provider and enter your access credentials or personal access token to enable repository access.

note

GitHub is the only supported Git provider in v2.10.1. The GitLab and Bitbucket tiles are permanently disabled in this build. They're rendered as static images with no clickable control, and there's no setting a platform administrator can change to enable them. The backend still carries GIT_LAB and BITBUCKET_CLOUD provider values, so support is planned but not yet enabled.

Creating a Git credential

  1. Go to Settings → Linked Accounts.
  2. Select GitHub as the Git provider.
  3. Enter the required information:
    • Username
    • Token (GitHub Personal Access Token)
  4. Click Save to create the credential.

create-git-credentials.png

Once the credentials are saved, the platform stores them securely and enables repository access for Git operations.

Linked account row

A successfully linked account appears as a row containing:

ElementExample
Status indicatorGreen check
ProviderGitHub
Account nameSadhvik-Modak
ActionsDelete, Edit

edit_delete_git_credential.png

Username and token validation

Yeedu validates the Username and Token fields against per-provider patterns supplied by the backend, so the credential must match the format GitHub itself publishes. In practice that means:

  • A GitHub username contains letters, numbers and single hyphens, starts and ends with a letter or number, and is at most 39 characters long.
  • A classic Personal Access Token starts with ghp_. The field's own placeholder is e.g., ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
  • A fine-grained Personal Access Token starts with github_pat_.

Ensure the token has sufficient permissions to access the required repositories.

note

The exact validation patterns are configured server-side and aren't part of the documented interface. If a credential is rejected, check it against GitHub's current username and token formats.

Editing a linked account

To edit credentials:

  1. Click the Edit button on the linked account row.
  2. Modify the necessary fields.
  3. Enter the token again for security verification.
  4. Click Save to apply the changes.

edit_git_credential.png

note

The username may remain the same or can be edited depending on configuration, but the token must always be provided again when editing credentials.

Deleting a linked account

To delete credentials:

  1. Click the Delete button on the linked account row.
  2. A confirmation popup will appear.
  3. Type the GitHub username to confirm the action.
  4. Click I understand the consequences, disable this git credential.

delete_git_credential.png

This step ensures that credentials aren't accidentally removed.

caution

Deleting a linked account removes the credential that Git folders resolve against. Existing Git folders cloned with that credential will no longer be able to authenticate for pull, commit, or push.

Benefits

  • Securely connect Git repositories to the platform.
  • Simplify repository access for workspace files and Git folders.
  • Enable seamless integration between Git workflows and data engineering pipelines.
  • Manage credentials directly from the platform without external configuration.