|
|
|
**Your regular password will not work with git**. You have to set up a **Personal Access Token** in order to use git+https, since gitlab.esa.int is federated to the ESA Corporate Authentication System and we do not store your passwords.
|
|
|
|
|
|
|
|
A Personal Access Token (PAT) is a password local to Gitlab. You need to create a PAT to fetch the code from the command-line, or other tools like TortoiseGit or Visual Studio.
|
|
|
|
|
|
|
|
# Steps to create a PAT
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1. In the upper-right corner, click your avatar and select Settings.
|
|
|
|
2. On the User Settings menu, select Access Tokens.
|
|
|
|
3. Choose a name and optional expiry date for the token.
|
|
|
|
4. Choose the desired scopes. Normally to work in git from the command-line you will need `read_repository` and `write_repository`.
|
|
|
|
5. Click the Create personal access token button.
|
|
|
|
6. Save the personal access token somewhere safe. Once you leave or refresh the page, you won’t be able to access it again.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Stuff to bear in mind
|
|
|
|
- Your username when using a PAT will be the text after the @ when you click in your avatar in the upper-right corner.
|
|
|
|
- The `git` command line tool will probably store your username & PAT in your OS credentials secure store system. So it is possible that you will only need to input it once.
|
|
|
|
- For Windows https://github.com/Microsoft/Git-Credential-Manager-for-Windows
|
|
|
|
- For macOS, use the included osxkeychain.
|
|
|
|
- For Linux, depending on your distro you can user Gnome Keyring as described in https://askubuntu.com/a/776335.
|
|
|
|
- If `git` is not asking you for your password, please try specifying your username by doing `git clone https://YOUR_USERNAME@gitlab.esa.int/namespace/project.git`.
|
|
|
|
- If you change your PAT, you will have to reset them with `git config --global --unset user.password`
|
|
|
|
- **DO NOT** store your PAT in clear text by setting your `git remote` to https://YOUR_USERNAME:YOUR_PAT@gitlab.esa.int/foo/bar.git. Please use the secure credentials storage of your OS as described above.
|
|
|
|
- We have a very aggressive rate limit policy. If you input your credentials wrong 5 times in 10 mins you will be banned one hour.
|
|
|
|
- Do not hesitate to contact us in gitlab@esa.int if you are having any issue accessing gitlab.esa.int from the command-line.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**Your regular password will not work with git**. You have to set up a **Personal Access Token** in order to use git+https, since gitlab.esa.int is federated to the ESA Corporate Authentication System and we do not store your passwords.
|
|
|
|
|
|
|
|
A Personal Access Token (PAT) is a password local to Gitlab. You need to create a PAT to fetch the code from the command-line, or other tools like TortoiseGit or Visual Studio.
|
|
|
|
|
|
|
|
# Steps to create a PAT
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1. In the upper-right corner, click your avatar and select Settings.
|
|
|
|
2. On the User Settings menu, select Access Tokens.
|
|
|
|
3. Choose a name and optional expiry date for the token.
|
|
|
|
4. Choose the desired scopes. Normally to work in git from the command-line you will need `read_repository` and `write_repository`.
|
|
|
|
5. Click the Create personal access token button.
|
|
|
|
6. Save the personal access token somewhere safe. Once you leave or refresh the page, you won’t be able to access it again.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Stuff to bear in mind
|
|
|
|
- Your username when using a PAT will be the text after the @ when you click in your avatar in the upper-right corner.
|
|
|
|
- The `git` command line tool will probably store your username & PAT in your OS credentials secure store system. So it is possible that you will only need to input it once.
|
|
|
|
- For Windows https://github.com/Microsoft/Git-Credential-Manager-for-Windows
|
|
|
|
- For macOS, use the included osxkeychain.
|
|
|
|
- For Linux, depending on your distro you can user Gnome Keyring as described in https://askubuntu.com/a/776335.
|
|
|
|
- If `git` is not asking you for your password, please try specifying your username by doing `git clone https://YOUR_USERNAME@gitlab.esa.int/namespace/project.git`.
|
|
|
|
- If you change your PAT, you will have to reset them with `git config --global --unset user.password`
|
|
|
|
- **DO NOT** store your PAT in clear text by setting your `git remote` to https://YOUR_USERNAME:YOUR_PAT@gitlab.esa.int/foo/bar.git. Please use the secure credentials storage of your OS as described above.
|
|
|
|
- We have a very aggressive rate limit policy. If you input your credentials wrong 5 times in 10 mins you will be banned one hour.
|
|
|
|
- Do not hesitate to contact us at esait.service.desk@esa.int if you are having any issue accessing gitlab.esa.int from the command-line.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
More info available in https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html |
|
|
\ No newline at end of file |
