Merge branch 'master' of github.com:BetterCrypto/Applied-Crypto-Hardening
[ach-master.git] / src / howtoread.tex
1 \section{How to read this guide}
2 \label{sec:how-read-this}
3 This guide tries to accommodate two needs: first of all, having a handy reference on how to configure the most common services's crypto settings and second of all, explaining a bit, how to chose your own cipher settings.
4
5 System administrators who want to copy \& paste recommendations quickly without spending a lot of time on background reading on cryptography or cryptanalysis can do so, by simply searching for the corresponding section in chapter \ref{chapter:PracticalSettings} (``Practical recommendations''). However, for the quick copy \& paste approach it is important to know that this guide assumes users are happy with \textit{cipher String B} which is the baseline and most compatible recommendation that the authors came up with. \textit{Cipher string B} is described in \ref{section:recommendedciphers}. \textit{Cipher String B} covers the most common use-cases (such as running an e-commerce shop, a private homepage, a mail server, $ \ldots $)
6
7 While chapter \ref{chapter:PracticalSettings} is intended to serve as a copy \& paste reference, chapter \ref{chapter:Theory} (``Theory'') explains the reasoning behind \textit{cipher string B}. In particular, section \ref{section:CipherSuites} explains how to choose individual cipher strings. We advise the reader to actually read this section and challenge our reasoning in choosing \textit{cipher string B} and to come up with a better  or localized solution.
8
9 %We start with some general remarks in sections \ref{section:DH},\ref{section:EllipticCurveCryptography},\ref{section:keylengths} on 
10 %If you are a system administrator and want to quickly update your services, jump right to section \ref{section:PracticalSettings}. However, we recommend that you take some time and first read through the theory part (chapter \ref{chapter:Theory}), especially section \ref{section:CipherSuites} on how to choose your own cipher string and then adapt the settings in section \ref{section:PracticalSettings} to your own needs.
11
12 \tikzstyle{terminator} = [ellipse, draw,  minimum height=2em,
13     text width=4.5em, text badly centered, inner sep=0pt]
14 \tikzstyle{decision} = [diamond, draw,aspect=2,
15      text width=10em, text badly centered, node distance=8em, inner sep=0pt]
16 \tikzstyle{block} = [rectangle, draw,inner sep=0pt,
17      text width=17em, text centered, rounded corners, minimum height=4em]
18 \tikzstyle{line} = [draw, very thick, -latex']
19 \tikzstyle{decision answer}=[near start,color=black]
20 \begin{tikzpicture}[scale=1, node distance = 6em, auto]
21     % Place nodes
22     \node [terminator] (start) {Start};
23     \node [block, right of=start, text width=7em, node distance=8em] (intro) {%
24       \nameref{chapter:Intro}};
25     \node [decision, below of=intro] (evaluate) {%
26       No time, I just want to copy \& paste};
27     \node [block, right of=evaluate, node distance=20em] (practical1) {%
28       read \nameref{chapter:PracticalSettings}};
29     \node [block, below of=evaluate,node distance=8em ] (theory) {%
30       To understand why we chose certain settings, read
31       \nameref{chapter:Theory} first};
32     \node [block, right of=theory, node distance=20em] (practical2) {%
33       re-read \nameref{chapter:PracticalSettings}};
34     \node [block, below of =practical2] (appendix) {%
35       \hyperref[appendix]{Appendix}: references, links};
36     % Draw edges
37     \path [line] (start) -- (intro);
38     \path [line] (intro) -- (evaluate);
39     \path [line] (evaluate) -- node [decision answer]  {yes} (practical1);
40     \path [line] (evaluate) -- node [decision answer]  {no} (theory);
41     \path [line] (practical1) -- (theory);
42     \path [line] (theory) -- (practical2);
43     \path [line] (practical2) -- (appendix);
44 \end{tikzpicture}
45
46 %%% Local Variables: 
47 %%% mode: latex
48 %%% TeX-master: "applied-crypto-hardening"
49 %%% End: