GitLab SSH
Description
Here you will learn how to use your TKey for SSH operations towards GitLab together with our app tkey-ssh-agent.
Installation and usage
Linux / macOS / Windows
Adding your public SSH key to your GitLab account
Note: Before proceeding, you must install tkey-ssh-agent on your device and generate a public SSH key, as described here.
- Follow the instructions on GitLab about two-factor authentication.
- Follow the instructions on GitLab about how how to use SSH keys to communicate with GitLab.
Testing your TKey for GitLab operations
- Enter a git command in your terminal that requires your permission. For example cloning a private repository. The status indicator on your TKey flashes green when a confirmation is needed.
git clone git@gitlab.com:<username>/<repository>.git
- Touch the touch sensor on your TKey to confirm the operation.
Troubleshooting
If you run into trouble with the SSH connection, the best place to start are:
- Check out the GitLab help topics.
- Make sure tkey-ssh-agent are running
- Make sure either the environment variable SSH_AUTH_SOCK or your SSH agent configuration is set. See our instructions over at TKey ssh-agent.