commit 3ca577f4df34dc0207b07fe866961944e3af9a80 Author: Thibaut Le Page <`echo dGhpbHAuaXMK | base64 -d`@gmail.com> Date: Mon Jan 20 07:37:00 2014 +0100 add existing guide translated to XeTeX Missing: - server certificates installation - test for client certificate installation under Windows (8) - certificate installation on Mac OS with Safari (use keystore directly?) - serveur.der or serveur.pem (or something else) on Mac OS? A PDF version of guide.tex is tracked in this repository so that people without the required packages or fonts can view it anyway. diff --git a/Makefile b/Makefile new file mode 100644 index 00000000..9a2ceae3 --- /dev/null +++ b/Makefile @@ -0,0 +1,9 @@ +all: guide.pdf + +.tex.pdf: + latexmk --xelatex ${.IMPSRC} + +clean: + latexmk -c + +.SUFFIXES: .tex .pdf diff --git a/guide.pdf b/guide.pdf new file mode 100644 index 00000000..0e5f6ef2 Binary files /dev/null and b/guide.pdf differ diff --git a/guide.tex b/guide.tex new file mode 100644 index 00000000..a095ccd4 --- /dev/null +++ b/guide.tex @@ -0,0 +1,145 @@ +\documentclass[a4paper]{article} + +\usepackage[frenchb]{babel} +\usepackage{fullpage} +\usepackage{fontspec} +\usepackage{hyperref} +\usepackage{keystroke} + +\setmainfont[Ligatures=TeX,Numbers={OldStyle,Proportional}]{Myriad Pro} +\setmonofont{Inconsolata} + +\title{Challenge FIC 2014 : Guide introductif} +\author{EPITA} +\date{22 janvier 2014} + +\newcommand{\certClient}[1]{\texttt{client\_#1.p12}} +\newcommand{\certServeurWin}[0]{\texttt{serveur.der}} +\newcommand{\certServeurLinux}[0]{\texttt{serveur.pem}} +\newcommand{\WindowsLogo}{\raisebox{-0.1em}{\includegraphics[height=0.75em]{windows_key}}} +\newcommand{\WinKey}{\keystroke{\WindowsLogo}} + +\begin{document} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\maketitle{} + +\textbf{\textsc{Bienvenue}} à cette seconde épreuve du challenge +\emph{forensics} ! Votre première activité consiste à accéder au site dédié à +cet événement ; ce guide est là pour vous aider à y parvenir. + +\paragraph{Important :} La clef USB qui vous a été donnée contient des +fichiers permettant votre authentification auprès de nos serveurs. Ne la +laissez pas sans surveillance ! + +\tableofcontents{} +\noindent {\vrule depth 2pt height 2pt width \textwidth} + +\vspace{\baselineskip} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\section{Installation du certificat \emph{client}} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +Le certificat \emph{client} est envoyé à notre serveur pour vous identifier et +authentifier. Si votre numéro d'équipe était \emph{X}, il s'agirait du +fichier nommé \certClient{X} sur votre clef USB. + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\subsection{Mozilla Firefox} +\label{sec:clFFox} + +\begin{enumerate} + \item Ouvrez la fenêtre des préférences du navigateur. + \item Choisissez la catégorie \textbf{Avancé}. + \item Sélectionnez l'onglet \textbf{Certificats}. + \item Cliquez sur \textbf{Afficher les certificats}. + \item Sélectionnez l'onglet \textbf{Vos certificats}. + \item Cliquez sur \textbf{Importer…} et sélectionnez votre certificat client. +\end{enumerate} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\subsection{Chromium/Google Chrome} +\label{sec:clChrome} + +\subsubsection{Sous Microsoft Windows} + +Le navigateur utilise les paramètres du système ; suivez les instructions +concernant \nameref{sec:clIE}. + +\subsubsection{Sous Mac OS} + +\begin{enumerate} + \item Ouvrez le menu des préférences du navigateur. + \item Cliquez sur \textbf{Afficher les paramètres avancés}. + \item Dans la section \textbf{HTTPS/SSL}, cliquez sur \textbf{Gérer les + certificats}. Le trousseau d'accès se lance. + \item Dans le menu \textbf{Fichier}, sélectionnez \textbf{Importer des + éléments…} et sélectionnez votre certificat client. + \item Choisissez un trousseau. +\end{enumerate} + +\subsubsection{Sous GNU/Linux, FreeBSD ou OpenBSD} + +\begin{enumerate} + \item Ouvrez le menu des préférences du navigateur. + \item Cliquez sur \textbf{Afficher les paramètres avancés}. + \item Dans la section \textbf{HTTPS/SSL}, cliquez sur \textbf{Gérer les + certificats}. + \item Sélectionnez l'onglet \textbf{Vos certificats}. + \item Cliquez sur \textbf{Importer…} et sélectionnez votre certificat client. +\end{enumerate} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\subsection{Internet Explorer} +\label{sec:clIE} + +Sous Windows, un \textbf{double-clic} sur le fichier \certClient{X} devrait +suffire à faire surgir les instruction d'installation pour ce certificat. + +Vous pouvez \textbf{aussi} l'importer \emph{via} la console de gestion des +certificats : +\begin{enumerate} + \item Pressez les touches \WinKey{} + \keystroke{R}. + \item Écrivez \texttt{\textbf{certmgr.msc}} et appuyez sur la touche + \emph{Entrée} \Return{}. + \item Cliquez sur le dossier \textbf{Personnel}. + \item Dans le menu \textbf{Action}, sous-menu \textbf{Toutes les tâches}, + choisissez \textbf{Importer…} + \item Cliquez sur \textbf{Suivant} et suivez les instructions. + \item Lorsqu'on vous le demande, placez le certificat dans le magasin + \textbf{Personnel}. +\end{enumerate} + +\paragraph{Microsoft Internet Explorer :} Aucune version de \emph{Microsoft +Internet Explorer} (nom d'« Internet Explorer » jusqu'à sa version 6 comprise) +n'est supportée par notre serveur. La fin du support officiel étant prévue le +8 avril prochain, vous devriez déjà y être préparé ! + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\section{Installation du certificat \emph{serveur}} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +Pour ne pas rencontrer d'avertissement lors de vos connexions au serveur, +c'est-à-dire être en mesure de vérifier la validité du certificat du serveur, +nous vous recommandons d'ajouter également à votre navigateur le certificat de +notre autorité de certification. + +Sur votre clef USB, ce certificat est nommé \certServeurWin{} (pour les +utilisateurs de Microsoft Windows) ou \certServeurLinux{} (pour les +utilisateurs de Linux). + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\subsection{Mozilla Firefox} +\label{sec:servFFox} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\subsection{Chromium/Google Chrome} +\label{sec:servChrome} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\subsection{Internet Explorer} +\label{sec:servIE} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\end{document} diff --git a/windows_key.pdf b/windows_key.pdf new file mode 100644 index 00000000..7bffc017 Binary files /dev/null and b/windows_key.pdf differ