diff --git a/swarmlab/files/help/HowTo-gitea-ssh.adoc b/swarmlab/files/help/HowTo-gitea-ssh.adoc new file mode 100644 index 0000000..9282ca2 --- /dev/null +++ b/swarmlab/files/help/HowTo-gitea-ssh.adoc @@ -0,0 +1,107 @@ += Generating a new SSH key and adding it to the ssh-agent! +Apostolos rootApostolos@swarmlab.io +// Metadata: +:description: IoT Εισαγωγή στο SwarmLab +:keywords: iot, swarm +:data-uri: +:toc: right +:toc-title: Πίνακας περιεχομένων +:toclevels: 4 +:source-highlighter: highlight +:icons: font +:sectnums: + + + +{empty} + + + +This HowTo teaches you how to Generating a new SSH key and adding it to the ssh-agent. + + +[WARNING] +==== + + Write Access is *ONLY* with "SSH Key-Based Authentication" Allowed + + +[NOTE] +==== +Using the SSH protocol, you can connect and authenticate to remote servers and services. With SSH keys, you can connect to Swarmlab.io git Service without supplying your username or password at each visit. +==== + +==== + +== Generating a new SSH key + +- Open Terminal. + +[source, bash] +---- +ssh-keygen -t rsa -b 4096 -C "your_email@swarmlab.io" +---- + +- This creates a new ssh key, using the provided email as a label. + +[NOTE] +==== + When you're prompted to "Enter a file in which to save the key," press Enter. This accepts the default file location. + +[source, bash] +---- + > Enter a file in which to save the key (/home/you/.ssh/id_rsa): [Press enter] + + At the prompt, type a secure passphrase. For more information, see "Working with SSH key passphrases". + + > Enter passphrase (empty for no passphrase): [Type a passphrase] + > Enter same passphrase again: [Type passphrase again] +---- +==== + + +== Adding your SSH key to the ssh-agent + + +[source, bash] +---- +Host git.swarmlab.io + HostName git.swarmlab.io + Preferredauthentications publickey + IdentityFile /home/user/.ssh/file_ssh_key // <1> + User git + Port 2222 +---- +<1> key path + + + +== Adding a new SSH key to your Swarmlab.io account + + +- Copy the SSH key to your clipboard. + +- In the upper-right corner of "Git Service", click Settings. + +image::images/gitea-ssh-key-1.png[] + +- In the user settings menou, click "SSH/GPG keys". + +image::images/gitea-ssh-key.png[] + +- Paste your key into the "Content" field. + + + + + + +:hardbreaks: + +{empty} + +{empty} + +{empty} + +:!hardbreaks: + +''' + diff --git a/swarmlab/files/help/faq.adoc b/swarmlab/files/help/faq.adoc index e84bbb9..57633dc 100644 --- a/swarmlab/files/help/faq.adoc +++ b/swarmlab/files/help/faq.adoc @@ -19,6 +19,8 @@ For any questions not addressed in this list please do not hesitate to contact o === http://docs.swarmlab.io/SwarmLab-HowTos/swarmlab/files/help/HowTo-gitea.adoc.html[HowTo-create Repo] +=== http://docs.swarmlab.io/SwarmLab-HowTos/swarmlab/files/help/HowTo-gitea-ssh.adoc.html[HowTo-Generating a new SSH key] + == noVNC diff --git a/swarmlab/images/gitea-ssh-key-1.png b/swarmlab/images/gitea-ssh-key-1.png new file mode 100644 index 0000000..03bc82d Binary files /dev/null and b/swarmlab/images/gitea-ssh-key-1.png differ diff --git a/swarmlab/images/gitea-ssh-key.png b/swarmlab/images/gitea-ssh-key.png new file mode 100644 index 0000000..61909bb Binary files /dev/null and b/swarmlab/images/gitea-ssh-key.png differ