Selaa lähdekoodia

Added key generation info

Kristian Schultz 4 vuotta sitten
vanhempi
commit
4365b00b46
4 muutettua tiedostoa jossa 74 lisäystä ja 8 poistoa
  1. 2 1
      src/config.tex
  2. 2 0
      src/content.tex
  3. 63 7
      src/faq/keys.tex
  4. 7 0
      src/faq/whatisgit.tex

+ 2 - 1
src/config.tex

@@ -101,9 +101,10 @@
 
 \newcommand{\badvar}[1]{\texttt{\color{red} #1}}
 \newcommand{\var}[1]{\texttt{\color{grey} #1}}
-\newcommand{\code}[1]{\colorbox{lightgray}{\texttt{#1}}}
+\newcommand{\code}[1]{\colorbox{lightgrey}{\texttt{#1}}}
 \newcommand{\codeline}[1]{\par\colorbox{lightgrey}{\parbox{\linewidth}{\tt #1}}}
 \newcommand{\bobOnEarth}[2]{\textcolor{gray}{[bob@earth {#1}] (#2)\$}}
+\newcommand{\bobOnEarth*}[1]{\textcolor{gray}{[bob@earth {#1}]\$}}
 \newcommand{\home}{{\~{}}}
 \newcommand{\projectDir}{{\~{}/myProject}}
 \newcommand{\placeholder}[1]{{\tt\bf\color{darkgreen} #1}}

+ 2 - 0
src/content.tex

@@ -16,6 +16,8 @@
 \setcounter{page}{1}
 \tableofcontents
 
+\newpage
+\input{src/faq/whatisgit}
 \newpage
 \input{src/faq/login}
 \newpage

+ 63 - 7
src/faq/keys.tex

@@ -17,16 +17,72 @@
     \includegraphics[width=\linewidth]{images/keys/keyOverview.png}
 \end{itemize}
 
+
+\newpage
+\subsection{\de{Ein SSH-Schlüssel erzeugen}\en{Create an SSH key}}
+\de{Wenn Sie bereits ein SSH-Schl\"ussel auf Ihren Computer haben, k\"onnen Sie diesen Schritt \"uberspringen.}
+\en{If you have already an SSH key on your computer you might skip this step.}
+
+\begin{itemize}
+\item
+    \de{Starten Sie eine Kommandozeile auf ihrem Computer.}
+    \en{Start a commandline on your computer.}
+
+\item
+    \de{F\"uhren Sie das folgende Kommando aus:}
+    \en{Run the following command:}
+    \codeline{ssh-keygen -t ecdsa -b 521}
+
+    \de{Die Ausgabe sieht so \"ahnlich aus wie:}
+    \en{The Output looks like:}
+
+    \begin{Code}
+\bobOnEarth{\home} ssh-keygen -t ecdsa -b 521
+\color{gray}
+\\{}Generating public/private ecdsa key pair.
+\\{}Enter file in which to save the key (/home/bob/.ssh/id\_ecdsa):
+\\{}\mbox{} \hfill \placeholder{/home/bob/.ssh/id\_ecdsa\_git\_ur}
+\\{}Enter passphrase (empty for no passphrase): \placeholder{mySecredPassword}
+\\{}Enter same passphrase again: \placeholder{mySecredPassword}
+\\{}Your identification has been saved in /home/bob/.ssh/id\_ecdsa\_git\_ur
+\\{}Your public key has been saved in /home/bob/.ssh/id\_ecdsa\_git\_ur.pub
+\\{}The key fingerprint is:
+\\{}SHA256:5vKu{\ldots}9Jk0 bob@earth
+\\{}The key's randomart image is:
+\\{}+-{}-{}-[ECDSA~521]-{}-{}-+
+\\{}|~~~~~~~~~~~~~~..~|
+\\{}|~~~~~~~~~~~~~..~~|
+\\{}|~~~~~~~~~~~~o~~.~|
+\\{}|~~~~~o~.~.~+..o~~|
+\\{}|~~.~=~.~S~+o.+~.~|
+\\{}|~....+~+~~~.E~o~~|
+\\{}|~+.*..+~o~~o~+~.~|
+\\{}|.~Booo.+~o.~o +~~|
+\\{}|~o..oooo+~o=++~~~|
+\\{}+----[SHA256]-----+
+    \end{Code}
+
+    \par
+    \de{Die Passphrase wird w\"ahrend der Eingabe nicht angezeigt. Diese Passphrase ist bei jedem Senden oder Empfangen von Daten vom GIT-Server einzugeben.}
+    \en{As you enter the passphrase it will not shown. You will need the passphrase on every transfear of data from or to the GIT server.}
+
+\end{itemize}
+
+
+
+
 \subsection{\de{Ein SSH-Schlüssel hinzufügen}\en{Add an SSH key}}
+\label{ch:ssh:addkey}
 
 \begin{itemize}
 \item
-   \de{Sie finden Ihre SSH-Schlüssel in Ihrem Home-Verzeichnis, im Ordner \var{.ssh}.
-   Die für diesen Schritt intessanten Dateien haben die Endung \var{.pub}.
-   Z.B: \var{id\_ecdsa.pub} oder \var{id\_rsa.pub}
-   }\en{You find your SSH keys in your home folder in the folder \var{.ssh}.
-   The files we need have the extension \var{.pub}.
-   E.g: \var{id\_ecdsa.pub} or \var{id\_rsa.pub}}
+    \de{Sie finden Ihre SSH-Schlüssel in Ihrem Home-Verzeichnis, im Ordner \var{.ssh}.
+    Die für diesen Schritt intessanten Dateien haben die Endung \var{.pub}.
+    Z.B: \var{id\_ecdsa.pub} oder \var{id\_rsa.pub}
+    }\en{You find your SSH keys in your home folder in the folder \var{.ssh}.
+    The files we need have the extension \var{.pub}.
+    E.g: \var{id\_ecdsa.pub} or \var{id\_rsa.pub}}
+    \de{Falls Sie im vorherigen Schritt ein SSH-Schl\"ussel angelegt haben wurde Ihnen in der Zeile \q{\var{Your public key has been saved in \ldots}} der Dateiname der gesuchten Datei angegeben.}\en{If you have generated a key in the previous step you will find the name of the needed file in the line: \q{\var{Your public key has been saved in \ldots}}}
 
 \item
    \de{Öffnen sie die Datei mit Ihrem public key in einem Text-Editor.
@@ -34,7 +90,7 @@
    }\en{Open your public key in a text editor.
    The content is a single line and should look like this:}
 
-    \codeline{ecdsa-sha2-nistp521 AAAA...FHw== user@computer}
+    \codeline{ecdsa-sha2-nistp521 AAAA{\ldots}FHw== user@computer}
 
 \item \de{Kopieren Sie den Schlüssel in das Feld \var{key}.
    }\en{Copy your key in the field \var{Key}.}

+ 7 - 0
src/faq/whatisgit.tex

@@ -0,0 +1,7 @@
+\section{\de{Wozu GIT?}\en{Why GIT?}}
+\begin{DE}
+GIT ist ...
+\end{DE}
+\begin{EN}
+GIT is ...
+\end{EN}