You have 2 possibilities for generating SSH keys: - generate a key pair on c4science and download the private key to your computer. C4science will not store your private key. - generate a key pair on your computer (please google this for your OS) and upload the public key to c4science. !!prefered method!! We will here explain how to generate a key on c4science and how to use it. If you wish to upload your key, it is pretty straightforward, please keep on reading to know how to use your key on c4science. Click on the wrench at the top right corner {F230721} and then choose, from the left hand side menu, `SSH Public Keys`. # Generate a key pair on c4science Click on `SSH Key actions` and then `Generate Keypair`. Follow the dialogs and download the private key to the correct directory (this depends on your Operating System, it usually is `~/.ssh`). You will need to change the permission to the downloaded key: ``` chmod 600 ~/.ssh/id_rsa_phabricator.key ``` Now, you will need to declare which key you use for c4science. Add the following to your `~/.ssh/config` file: ``` host c4science.ch HostName c4science.ch IdentityFile ~/.ssh/id_rsa_phabricator.key User git ```

You have 2 possibilities for generating SSH keys: - generate a key pair on your computer and upload the public key to c4science. !!prefered method!! - generate a key pair on c4science and download the private key to your computer. C4science will not store your private key. # Generate an SSH key If you are using Windows, you must first install a Shell, see [[#using-ssh-from-windows | below]] # Open a terminal # Copy the text below and press {key Enter} ``` ssh-keygen -t rsa -b 4096 ``` # If you have no other SSH key, keep the default file path `/home/user/.ssh/id_rsa` # When prompted, enter a secure passphrase # Voila, your public and private key pair is located at `/home/user/.ssh/` # Upload your SSH key - At the top right on your user icon, select `Settings` - On the left menu, go to {nav AUTHENTICATION > SSH Public Keys} - At the top right, click on {nav SSH Key actions > Upload Public Key} - Give it a name and paste the content of the `public` key (the .pub file) - You can find the public key by running this command ``` cat ~/.ssh/id_rsa.pub ``` - Click `Upload Public Key` - And you're done, you can start clone repositories using SSH # Generate a key pair on c4science If you don't know how to generate a key on your computer, c4science can do it for you. If you already uploaded your key, you don't need this. Click on {nav SSH Key actions >Generate Keypair}. Follow the dialog and download the private key to the correct directory (this depends on your Operating System, it usually is `~/.ssh`). Rename the keys to `id_rsa` and `id_rsa.pub` or SSH won't recognize them (see below). You will also need to change the permission of the key: ``` chmod 600 ~/.ssh/id_rsa ``` If you don't have the standard key name `id_rsa`, configure SSH to use your custom key. Add the following to your `~/.ssh/config` file: ``` host c4science.ch HostName c4science.ch IdentityFile ~/.ssh/id_rsa_phabricator.key User git ``` # Using SSH from Windows ## Git Bash (preferred) - Download [[https://git-scm.com/download/win | Git Bash for Windows]], which allow to use standard Bash commands - Launch Git Bash - Create and upload the key like [[https://c4science.ch/w/c4science/sshkeys/#generate-an-ssh-key | documented above]] with `ssh-keygen.exe` instead, display the content of the pubkey using `cat ~/.ssh/id_rsa.pub` from git bash - You can now clone your repository from git bash, `git clone ssh://git@c4science.ch/[...]` - The key should be added to your SSH Agent, if not you can add your key temporarily using `eval "$(ssh-agent -s)"` ## TortoiseGIT / TortoiseSVN - Download one or the other depending on your case, - [[https://tortoisegit.org/download/ | TortoiseGIT]] - [[https://tortoisesvn.net/downloads.html | TortoiseSVN]] - After the install, run PuTTYgen - Click Generate - Add a passphrase to your key - Click Save public key, this is what you'll upload to c4science on your account - Upload the public key on your profile as [[https://c4science.ch/w/c4science/sshkeys/#upload-your-ssh-key | documented above]] - You can now clone/checkout your first repository from any explorer window by right clicking {F899649}

You have 2 possibilities for generating SSH keys: - generate a key pair on your computer and upload the public key to c4science. !!prefered method!! - generate a key pair on c4science and download the private key to your computer. C4science will not store your private key. - generate a key pair on your computer (please google this for your OS) and upload the public key to c4science. !!prefered method!! # Generate an SSH key We will here explain how to generate a key on c4science and how to use it. If you wish to upload your keyIf you are using Windows, it is pretty straightforwardyou must first install a Shell, please keep on reading to know how to use your key on c4science.see [[#using-ssh-from-windows | below]] Click on the wrench at the top right corner# Open a terminal # Copy the text below and press {key Enter} ``` ssh-keygen -t rsa -b 4096 ``` # If you have no other SSH key, keep the default file path `/home/user/.ssh/id_rsa` # When prompted, enter a secure passphrase # Voila, your public and private key pair is located at `/home/user/.ssh/` {F230721}# Upload your SSH key and then choose- At the top right on your user icon, select `Settings` - On the left menu, go to {nav AUTHENTICATION > SSH Public Keys} - At the top right, from the left hand side menuclick on {nav SSH Key actions > Upload Public Key} - Give it a name and paste the content of the `public` key (the .pub file) - You can find the public key by running this command ``` cat ~/.ssh/id_rsa.pub ``` - Click `Upload Public Key` - And you're done, `SSH Public Keys`.you can start clone repositories using SSH # Generate a key pair on c4science Click on `SSH Key actions` and then `Generate Keypair`.If you don't know how to generate a key on your computer, Follow the dialogs and download the private key to the correct directory (this depends onc4science can do it for your Operating System,. it usually is `~/.ssh`).If you already uploaded your key, You will need to change the permission to the downloaded key:you don't need this. Click on {nav SSH Key actions >Generate Keypair}. Follow the dialog and download the private key to the correct directory (this depends on your Operating System, it usually is `~/.ssh`). Rename the keys to `id_rsa` and `id_rsa.pub` or SSH won't recognize them (see below). You will also need to change the permission of the key: ``` chmod 600 ~/.ssh/id_rsa_phabricator.key ``` NowIf you don't have the standard key name `id_rsa`, you will need to declare which key youconfigure SSH to use for c4scienceyour custom key. Add the following to your `~/.ssh/config` file: ``` host c4science.ch HostName c4science.ch IdentityFile ~/.ssh/id_rsa_phabricator.key User git ``` # Using SSH from Windows ## Git Bash (preferred) - Download [[https://git-scm.com/download/win | Git Bash for Windows]], which allow to use standard Bash commands - Launch Git Bash - Create and upload the key like [[https://c4science.ch/w/c4science/sshkeys/#generate-an-ssh-key | documented above]] with `ssh-keygen.exe` instead, display the content of the pubkey using `cat ~/.ssh/id_rsa.pub` from git bash - You can now clone your repository from git bash, `git clone ssh://git@c4science.ch/[...]` - The key should be added to your SSH Agent, if not you can add your key temporarily using `eval "$(ssh-agent -s)"` ## TortoiseGIT / TortoiseSVN - Download one or the other depending on your case, - [[https://tortoisegit.org/download/ | TortoiseGIT]] - [[https://tortoisesvn.net/downloads.html | TortoiseSVN]] - After the install, run PuTTYgen - Click Generate - Add a passphrase to your key - Click Save public key, this is what you'll upload to c4science on your account - Upload the public key on your profile as [[https://c4science.ch/w/c4science/sshkeys/#upload-your-ssh-key | documented above]] - You can now clone/checkout your first repository from any explorer window by right clicking {F899649}