diff options
author | Christian Perrier <bubulle@debian.org> | 2005-09-23 18:12:46 +0000 |
---|---|---|
committer | Christian Perrier <bubulle@debian.org> | 2005-09-23 18:12:46 +0000 |
commit | 7224c2f669664c224d707f4e4c1a866bfe7371c7 (patch) | |
tree | 2cb7376696b3e5c7b3931fc9860e6f8e47d6e837 /doc | |
parent | 0d2db5387192a18eb8ee601c05003ca90604d31f (diff) | |
parent | bae108264e918e6f256d36bfce2a6c79b4b2a3ed (diff) |
Merge with mvo
Patches applied:
* michael.vogt@ubuntu.com--2005/apt--mvo--0--patch-60
* merged updated french man-page
* michael.vogt@ubuntu.com--2005/apt--mvo--0--patch-61
* merged with bubulle
* philippe.batailler@free.fr--2005/VOGTapt--mvo--0--patch-1
French L10N update
* philippe.batailler@free.fr--2005/VOGTapt--mvo--0--patch-2
Generate correctly french manpages
Diffstat (limited to 'doc')
-rw-r--r-- | doc/fr/apt-config.fr.8.xml | 4 | ||||
-rw-r--r-- | doc/fr/apt-key.fr.8.xml | 44 | ||||
-rw-r--r-- | doc/fr/apt-secure.fr.8.xml | 217 | ||||
-rw-r--r-- | doc/fr/apt.ent.fr | 48 | ||||
-rw-r--r-- | doc/fr/apt_preferences.fr.5.xml | 4 | ||||
-rw-r--r-- | doc/fr/makefile | 12 |
6 files changed, 318 insertions, 11 deletions
diff --git a/doc/fr/apt-config.fr.8.xml b/doc/fr/apt-config.fr.8.xml index ac9143066..043c58686 100644 --- a/doc/fr/apt-config.fr.8.xml +++ b/doc/fr/apt-config.fr.8.xml @@ -57,7 +57,7 @@ des commandes suivantes doit être présente. <listitem><para> Le terme shell est utilisé pour accéder aux informations de configuration depuis un script shell. Deux arguments doivent lui être donnés ; le -premier est une variable de shell et le second une valeur de configuration à +premier est une variable du shell et le second une valeur de configuration à demander. La sortie standard consiste en une liste de commandes d'assignation de shell pour chaque valeur présente. Dans un script shell, cette commande devrait @@ -69,7 +69,7 @@ RES=`apt-config shell OPTS MyApp::Options` eval $RES </programlisting></informalexample> -<para>La variable d'environnement de shell $OPTS sera définie par la valeur de +<para>La variable d'environnement du shell $OPTS sera définie par la valeur de MyApp::Options ou, par défaut, la valeur -f. </para> <para> diff --git a/doc/fr/apt-key.fr.8.xml b/doc/fr/apt-key.fr.8.xml index a31fb7855..29ba237e2 100644 --- a/doc/fr/apt-key.fr.8.xml +++ b/doc/fr/apt-key.fr.8.xml @@ -34,7 +34,7 @@ <para> <command>apt-key</command> gère les clés dont se sert apt pour authentifier les paquets. Les paquets authentifiés par ces clés seront -réputés +réputés fiables. </para> </refsect1> @@ -73,13 +73,47 @@ Afficher la liste des clés fiables. </listitem> </varlistentry> + + <varlistentry><term>update</term> + <listitem> + <para> +Mettre à jour le trousseau de clés local avec le trousseau de clés de l'archive +Debian et supprimer les clés qui sont périmées. +</para> + </listitem> + </varlistentry> + </variablelist> </refsect1> -<!-- <refsect1><title>See Also</title> --> -<!-- <para> --> -<!-- &apt-conf;, &apt-get;, &sources-list; --> -<!-- </refsect1> --> + <refsect1><title>Fichiers</title> + <variablelist> + <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term> +<listitem><para>Trousseau de clés locales fiables, les nouvelles clés sont ajoutées ici.</para> +</listitem> + </varlistentry> + + <varlistentry><term><filename>/etc/apt/trustdb.gpg</filename></term> + <listitem><para>Base de données locale fiable des clés de l'archive.</para></listitem> + </varlistentry> + + <varlistentry><term><filename>/usr/share/keyrings/debian-archive-keyring.gpg</filename></term> + <listitem><para>Trousseau des clés fiables de l'archive Debian.</para></listitem> + </varlistentry> + + <varlistentry><term><filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename> +</term> + <listitem><para>>Trousseau des clés fiables supprimées de l'archive Debian.</para></listitem> + </varlistentry> + + </variablelist> + </refsect1> + +<refsect1><title>Voir aussi</title> +<para> +&apt-get;, &apt-secure; +</para> +</refsect1> &manbugs; &manauthor; diff --git a/doc/fr/apt-secure.fr.8.xml b/doc/fr/apt-secure.fr.8.xml new file mode 100644 index 000000000..5cec9a49d --- /dev/null +++ b/doc/fr/apt-secure.fr.8.xml @@ -0,0 +1,217 @@ +<?xml version="1.0" encoding="iso-8859-15" standalone="no"?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ + +<!ENTITY % aptent SYSTEM "apt.ent.fr"> +%aptent; + +]> + +<refentry lang="fr"> + &apt-docinfo; + + <refmeta> + <refentrytitle>apt-secure</refentrytitle> + <manvolnum>8</manvolnum> + </refmeta> + +<!-- NOTE: This manpage has been written based on the + Securing Debian Manual ("Debian Security + Infrastructure" chapter) and on documentation + available at the following sites: + http://wiki.debian.net/?apt06 + http://www.syntaxpolice.org/apt-secure/ + http://www.enyo.de/fw/software/apt-secure/ +--> +<!-- TODO: write a more verbose example of how it works with + a sample similar to + http://www.debian-administration.org/articles/174 + ? +--> + + + <!-- Man page title --> + <refnamediv> + <refname>apt-secure</refname> + <refpurpose>Certification d'archive avec APT</refpurpose> + </refnamediv> + + <refsect1><title>Description</title> + <para> + Depuis sa version 0.6, <command>apt</command> sait vérifier +la signature du fichier Release de chaque archive. On s'assure ainsi que les +paquets de cette archive ne peuvent pas être modifiés par quelqu'un qui ne +possède pas la clé de la signature du fichier Release. + </para> + + <para> + Quand un paquet provient d'une archive sans signature ou d'une archive avec +une signature dont apt ne possède pas la clé, ce paquet n'est pas considéré +comme fiable et son installation provoquera un avertissement. Pour +l'instant, <command>apt-get</command> ne signale que les archives sans +signature ; les prochaines versions pourraient rendre obligatoire la +vérification des sources avant tout téléchargement de paquet. + </para> + + <para> + Les paquets &apt-get;, &aptitude; et &synaptic; possèdent cette nouvelle +fonction de certification. + + </para> +</refsect1> + + <refsect1><title>Archives fiables</title> + + <para> + D'une archive apt jusqu'à l'utilisateur, la confiance se construit en +plusieurs étapes. <command>Apt-secure</command> est la dernière étape. Faire +confiance à une archive ne signifie pas que les paquets qu'elle contient +sont exempts de code malveillant, mais signifie que vous faites confiance au +responsable de l'archive. C'est ensuite au responsable de l'archive de faire +en sorte que l'archive soit fiable. + + </para> + + <para><command>Apt-secure</command> n'examine pas la signature d'un +paquet. Certains programmes peuvent le faire comme +<command>debsig-verify</command> ou <command>debsign</command>, qu'on peut +trouver dans les paquets debsig-verify et devscripts. +</para> + + <para> + La fiabilisation dans Debian commence quand un responsable de paquet envoie +un nouveau paquet ou une nouvelle version d'un paquet dans l'archive. Cet +envoi, pour être effectif, doit être signé avec la clé d'un responsable qui +se trouve dans le trousseau des responsables Debian (disponible dans le +paquet debian-keyring). Les clés des responsables de paquet sont signées par +d'autres responsables, suivant des procédures préétablies pour s'assurer de +l'identité des propriétaires de la clé. + + </para> + + <para> + Une fois le paquet vérifié et archivé, la signature du responsable est +enlevée, une somme MD5 du paquet est calculée et mise dans le fichier +Packages. Une somme MD5 de tous les paquets est ensuite calculée et mise +dans le fichier Release. Ce fichier est signé par la clé de l'archive. Cette +clé qui est créée chaque année et distribuée par le serveur FTP se trouve +aussi dans le trousseau Debian. + + </para> + + <para> + Un utilisateur peut consulter la signature du fichier Release, extraire la +somme MD5 d'un paquet et la comparer avec la somme du paquet qu'il a +téléchargé. Avant la version 0.6, seule la somme du paquet téléchargé était +vérifiée. Maintenant on peut vérifier aussi la signature du fichier Release. + + </para> + + <para>Cette façon de faire est différente d'une vérification de la signature d'un +paquet. Elle vise à empêcher deux types d'attaque possibles : + + </para> + + <itemizedlist> + <listitem><para> +L'attaque de type <quote>homme au milieu</quote>. Sans vérification de +signature, quelqu'un de malveillant peut s'introduire au milieu du +processus de téléchargement et insérer du code soit en contrôlant un élément +du réseau, routeur, commutateur, etc. soit en détournant le trafic vers un +serveur fourbe (par usurpation d'adresses). +</para></listitem> + + <listitem><para> +L'attaque par compromission d'un miroir sur le réseau. Sans vérification de +signature, quelqu'un de malveillant peut compromettre un miroir et modifier +les fichiers. Ainsi tous ceux qui téléchargent les paquets de ce miroir +propagent du code malveillant. +</para></listitem> + </itemizedlist> + + <para> +Cependant cette méthode ne garantit pas contre une compromission du serveur +Debian lui-même (qui signe les paquets) ni contre la compromission de la clé +qui sert à signer les fichiers Release. Mais elle peut compléter la +signature des paquets. +</para> +</refsect1> + + <refsect1><title>Configuration</title> + <para> + Le programme qui gère la liste des clés utilisées par apt s'appelle +<command>apt-key</command>. Il peut ajouter ou supprimer des clés. Cette +version installe automatiquement les clés qui servent à signer l'archive +Debian et les différents répertoires de paquets. + + </para> + <para> + Pour ajouter une clé, vous devez d'abord la télécharger. Il vaut mieux +utiliser un canal fiable pour ce téléchargement. Ensuite vous l'ajoutez avec +la commande <command>apt-key</command> et vous lancez la commande +<command>apt-get update</command> pour télécharger et vérifier le fichier +<filename>Release.gpg</filename> de l'archive que vous avez configurée. + + </para> +</refsect1> + +<refsect1><title>Configuration d'une archive</title> + <para> + Si vous voulez signer les archives dont vous avez la responsabilité, vous +devez : + + </para> + + <itemizedlist> + <listitem><para>créer un fichier Release à la racine de l'archive, s'il n'existe pas +déjà. Vous pouvez le créer avec la commande <command>apt-ftparchive release</command> +(fournie dans le paquet apt-utils) ; +</para></listitem> + + <listitem><para> +le signer, avec la commande <command>gpg -abs -o Release.gpg Release</command> ; +</para></listitem> + + <listitem><para> +publier l'empreinte de la clé. Ainsi les utilisateurs de votre archive +connaîtront la clé qu'ils doivent importer pour authentifier les fichiers de +l'archive. +</para></listitem> + + </itemizedlist> + + <para>Chaque fois que le contenu de l'archive change, le responsable doit refaire +les deux premières étapes. +</para> + +</refsect1> + +<refsect1><title>Voir aussi</title> +<para> +&apt-conf;, &apt-get;,&sources-list;, &apt-key;, &apt-archive;, &debsign;, +&debsig-verify;, &gpg; + +</para> + +<para>Pour des informations plus substantielles, vous pouvez consulter +<ulink url="http://www.debian.org/doc/manuals/securing-debian-howto/ch7.en.html"> +l'infrastructure debian pour la sécurité</ulink> un chapitre du manuel Debian sur la sécurité +(disponible dans le paquet harden-doc) et le +<ulink url="http://www.cryptnet.net/fdp/crypto/strong_distro.html">Strong Distribution HOWTO</ulink> par V. Alex Brennen. + </para> + +</refsect1> + + &manbugs; + &manauthor; + +<refsect1><title>Auteurs</title> + +<para> +Cette page a été écrite à partir des travaux de Javier Fernández-Sanguino Peña, Isaac +Jones, Colin Walters, Florian Weimer et Michael Vogt. +</para> + </refsect1> +&traducteur; + +</refentry> diff --git a/doc/fr/apt.ent.fr b/doc/fr/apt.ent.fr index 075d85698..81130d9ef 100644 --- a/doc/fr/apt.ent.fr +++ b/doc/fr/apt.ent.fr @@ -42,6 +42,24 @@ <manvolnum>5</manvolnum> </citerefentry>"> +<!ENTITY apt-key "<citerefentry> + <refentrytitle><command>apt-key</command></refentrytitle> + <manvolnum>8</manvolnum> + </citerefentry>" +> + +<!ENTITY apt-secure "<citerefentry> + <refentrytitle>apt-secure</refentrytitle> + <manvolnum>8</manvolnum> + </citerefentry>" +> + +<!ENTITY apt-archive "<citerefentry> + <refentrytitle><filename>apt-archive</filename></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + <!ENTITY sources-list "<citerefentry> <refentrytitle><filename>sources.list</filename></refentrytitle> <manvolnum>5</manvolnum> @@ -89,6 +107,36 @@ <manvolnum>8</manvolnum> </citerefentry>"> +<!ENTITY aptitude "<citerefentry> + <refentrytitle><command>aptitude</command></refentrytitle> + <manvolnum>8</manvolnum> + </citerefentry>" +> + +<!ENTITY synaptic "<citerefentry> + <refentrytitle><command>synaptic</command></refentrytitle> + <manvolnum>8</manvolnum> + </citerefentry>" +> + +<!ENTITY debsign "<citerefentry> + <refentrytitle><command>debsign</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + +<!ENTITY debsig-verify "<citerefentry> + <refentrytitle><command>debsig-verify</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + +<!ENTITY gpg "<citerefentry> + <refentrytitle><command>gpg</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + <!-- Boiler plate docinfo section --> <!ENTITY apt-docinfo " <refentryinfo> diff --git a/doc/fr/apt_preferences.fr.5.xml b/doc/fr/apt_preferences.fr.5.xml index c6b2c8794..6e1d2043e 100644 --- a/doc/fr/apt_preferences.fr.5.xml +++ b/doc/fr/apt_preferences.fr.5.xml @@ -7,7 +7,7 @@ ]> -<refentry> +<refentry lang="fr"> <refentryinfo> &apt-author.team; @@ -208,7 +208,7 @@ d'« Archive » est <literal>unstable</literal>. <programlisting> Package: * Pin: release a=unstable -Pin-Priority: 50 +Pin-Priority: 500 </programlisting> <simpara>L'entrée suivante affecte une priorité haute à toutes les versions diff --git a/doc/fr/makefile b/doc/fr/makefile index c0e7fa7ed..596de7b09 100644 --- a/doc/fr/makefile +++ b/doc/fr/makefile @@ -5,11 +5,16 @@ SUBDIR=doc/fr # Bring in the default rules include ../../buildlib/defaults.mak +# Do not use XMLTO, build the manpages directly with XSLTPROC +XSLTPROC=/usr/bin/xsltproc +STYLESHEET=/usr/share/xml/docbook/stylesheet/nwalsh/manpages/docbook.xsl + + # Man pages SOURCE = apt-cache.fr.8 apt-get.fr.8 apt-cdrom.fr.8 apt.conf.fr.5 \ sources.list.fr.5 apt-config.fr.8 apt-sortpkgs.fr.1 \ apt-ftparchive.fr.1 apt_preferences.fr.5 apt-extracttemplates.fr.1 \ - apt-key.fr.8 + apt-key.fr.8 apt-secure.fr.8 INCLUDES = apt.ent.fr @@ -17,7 +22,7 @@ doc: $(SOURCE) $(SOURCE) :: % : %.xml $(INCLUDES) echo Creating man page $@ - $(XMLTO) man $< + $(XSLTPROC) -o $@ $(STYLESHEET) $< apt-cache.fr.8:: apt-cache.8 cp $< $@ @@ -52,4 +57,7 @@ apt-extracttemplates.fr.1:: apt-extracttemplates.1 apt-key.fr.8:: apt-key.8 cp $< $@ +apt-secure.fr.8:: apt-secure.8 + cp $< $@ + |