Skip to content
English
More support Sign in
Contact us
  • There are no suggestions because the search field is empty.

Authentication options using a Repo URL

In some cases it is required to authenticate when accessing a repo by URL. This article explains how to use username:password and Personal Access Tokens (PAT)

Using a plain-text Personal Access Token (PAT) or username:password in a Git repo's URL may be considered unsafe because it can be easily exposed in logs, shared unintentionally, and is vulnerable to interception, compromising the security of your account and repositories. This article is only provided for informational purposes.

When preforming certain operations (such as cloning a repository via the Git CLI), authentication may be required.  Typically a username and password can be used, but in some cases (such as when 2FA is configured) a Personal Access Token may be required.

Username/Password

When using a username and password, you can configure the URL for your repository as shown below:
https://username:password@copia_url/org_name/reponame.git

(NOTE: In the example above, the "copia_url" is "app.copia.io", unless you have a self-hosted instance of Copia) 

Personal Access Token (PAT)

To use a Personal Access Token, you first need to create one.  Follow these instructions on creating a Personal Access Token: How do I create an Access Token?

Once created, you can configure the URL for your repository as shown below:

https://personal_access_token@copia_url/org_name/reponame.git

(NOTE: In the example above, the "copia_url" is "app.copia.io", unless you have a self-hosted instance of Copia) 

Accessing a remote repo using a PAT

These are the steps for adding a PAT to a remote repo's URL in your Git client. The steps below describe how to do this for the Copia desktop application. The same approach can be used with other clients such as Git Bash or the Git CLI.

  1. Navigate to the repo in the Copia desktop app.
  2. In the Menu Bar, click Repository > Repository Settings
  3. On the Remote tab, beneath Primary remote repository (origin), paste in your PAT in the format shown above
  4. Click Save