Translation(s): English - Español - Français - Русский

7 étapes pour publier un DLA (Debian Security Advisory - Bulletin d'alerte Debian)

Comment préparer des mises à jour de sécurité pour LTS :

Contribuer au projet Debian Long Term Support

L'équipe Debian LTS est toujours à la recherche de plus de volontaires afin de faire un meilleur travail. Avec plus de ressources, nous pourrions par exemple :

Si vous voulez vous impliquer dans l'équipe LTS et ainsi aider à garder sécurisés les paquets Debian pour 5 ans, jetez un coup d’œil à cette page. Nous partons du principe que vous êtes familier avec la structure du dépôt décrite dans la page fr/LTS/Using et que vous êtes inscrit à la liste de diffusion : http://lists.debian.org/debian-lts/.

Vous pouvez aider de plusieurs manières :

Tester les paquets mis à jour et rapporter des bogues de régressions

En tant que simple utilisateur, vous pouvez tester les paquets qui ont été mis à jour (ou qui sont en train d'être mis à jour). Si vous trouvez une régression (c'est à dire quelque chose qui marchait et qui ne fonctionne désormais plus), alors rapportez-la à la liste de diffusion debian-lts@lists.debian.org et mettez en copie la personne qui a préparée la mise à jour (au cas où cette personne ne serait pas à abonnée à cette liste).

De nombreux contributeurs de LTS sont à la recherche de testeurs pour leurs paquets mis à jour. Ils envoient des appels sur la liste de diffusion, alors veuillez vous inscrire à celle-ci et testez quand vous le pouvez les paquets qu'ils fournissent, et faites un rapport si cela fonctionne de votre coté.

Gestionnaire de sécurité de Debian (Debian Security Tracker)

L'équipe Debian LTS utilise intensif du Gestionnaire de sécurité de Debian. Il s'agit d'une base de données de tous les problèmes de sécurité connus dans Debian.

Les développeurs vérifient la source Git (voir les instructions), les changements des commits, et le site web se met automatiquement à jour pour refléter les changements.

Les développeurs LTS sont fortement encouragés à garder à jour les données dans le gestionnaire de sécurité. Cela inclus la mise à jour des fichiers suivants :

Assurez-vous de consulter sa documentation sur le site web de l'équipe en charge de la sécurité de Debian.

Préparer les mises à jour de sécurité pour LTS

Déclarer la prise en charge d'un problème de vulnérabilité dans le gestionnaire de sécurité (dans dla-needed.txt)

Dans le but d'éviter les doublons dans les travaux fournis, assurez-vous que le problème de vulnérabilité est listé dans le fichier data/dla-needed.txt du gestionnaire de sécurité et votre nom à celui-ci. En principe, les problèmes sont d'abord triés par le « guichet » dans dla-needed.txt. Sinon, vous devez ajouter le problème de sécurité vous-même dans dla-needed.txt. Regardez comment cela est fait plus bas avant d'ajouter un problème ou votre nom à un problème.

Nous donnons un délai de 24 à 72 heures aux mainteneurs de paquets avant de prendre en charge nous-mêmes les mises à jour, en fonction de la gravité du problème de sécurité.

Comme mentionné dans la section précédente, assurez-vous d'examiner et mettre à jour les informations pertinentes dans data/CVE/list lors de la déclaration d'un paquet pour le travail de la LTS.

Vous devez ne déclarer cela que pour la durée active de votre travail. Vous êtes censés gérer activement le problème dans les 2 à 3 jours et vous êtes également censés annoncer votre intention de transmettre (uploader) pour que d'autres puissent tester cela durant quelques jours (3 ou 4) supplémentaires. Si vous ne pouvez pas résoudre le problème dans les 2 ou 3 jours, veuillez alors mentionner la raison pour laquelle cela prend plus de temps, jusqu'où vous êtes allés, les résultats préliminaires et/ou laisser cela à quelqu'un d'autre pour y travailler dessus. Vous ne voulons pas que des gens travaillent sur un paquet quelques heures, attendent quelques jours, travaillent à nouveau dessus, attendent encore, et ainsi de suite.

Vérifiez le dépôt git du gestionnaire de sécurité : (Utilisation d'un clone peu profond car sinon l'opération durera une demi-heure. Il faudra toujours quelques minutes au clone.)

{{{
$ git clone --depth 1 https://salsa.debian.org/security-tracker-team/security-tracker
$ cd security-tracker
$ sudo apt install python-apt
$ bin/setup-repo

*setup/repo* installe un hook de pré-commit pour vérifier la syntaxe du fichier de données.

Puis éditez le fichier data/dla-needed.txt :

$ editor data/dla-needed.txt
$ git commit -m "Claim foo in dla-needed.txt" data/dla-needed.txt
$ git push

Droits d'écriture pour le dépôt security-tracker

Les développeurs Debian disposent automatiquement d'un accès commit vers le dépôt security-tracker. Autrement, vous devez être membre du projet security-tracker sur salsa.debian.org. Dans ce cas, veuillez demander une adhésion via le projet gitlab de l'équipe en charge de la sécurité, la liste de diffusion du gestionnaire de sécurité ou bien la liste de diffusion debian-lts.

Construction de la mise à jour

Rétroportez (backport) les correctifs vers les versions dans LTS (dans la cas où il y aurait déjà eu une mise à jour). S'il n'y a rien à corriger, il serait bon de travailler à un autre niveau : contribuer au patch de retour de l'amont et s'assurer que le mainteneur et que les équipes habituelles en charge de la sécurité sont au courant en ajoutant cela à un rapport de bogue pour le paquet et en ajoutant le lien de ce rapport de bogue dans le gestionnaire de sécurité (Si le problème traité nécessite AddressSanitizer afin de reproduire la vulnérabilité et de confirmer le correctif, dans ce cas cette page (en anglais) pourrait vous être utile).

Dans le journal des modifications (changelog), vous devez définir « jessie-security » comme distribution cible dans debian/changelog. Le versionnage suit les conventions déjà en cours dans security.debian.org. Historiquement, les noms de code ont été utilisés comme numéros de version, mais ceci a été changé depuis quelques temps, les numéros de version étant plus déterministes.

Notez que pour les paquets non natifs, les mises à jour vers security-master nécessitent de fournir l'archive source (même si elle est déjà présente dans la distribution pour laquelle vous faites la mise à jour) en utilisant 'dpkg-buildpackage -sa'.

Pour construire le paquet binaire, vous pouvez utiliser une « porter box » surtout si vous avez besoin de corriger une régression qui concerne une architecture spécifique à laquelle vous n'avez pas accès. Voir PorterBoxHowToUse pour les instructions d'utilisation des « porterboxes ».

Tester la mise à jour

Maintenant, construisez le paquet et lancez vos tests. Vous pouvez le faire en vous assurant du lancement d'une suite des tests intégrés de constructions dans l'environnement LTS. Il acceptable d'activer ou même de rétroporter des suites de test à partir de versions ultérieures si elles sont disponibles.

S'il n'y a pas de suites de test disponibles, vous aurez besoin de lancer le paquet directement. Sa complexité varie avec la taille du paquet : les petits paquets peuvent juste être lancés dans un chroot, les autres nécessiteront un environement virtualisé complet, des procédures d'installation et bien d'autres choses. Il pourrait être difficile pour vous de tester le paquet entier, spécialement si vous n'est pas familiarisés avec la conception de paquets.

Selon l'urgence du correctif de sécurité, et de votre confiance sur votre propre travail vous pourriez vouloir chercher des retours de la part de parties prenantes (telles que les auteurs de l'amont, les responsables de paquet Debian, l'équipe en charge de la sécurité, l'équipe LTS, etc.). Si vous demandez des revues sur votre travail, vous devez indiquer quand vous prévoyez d'envoyer le paquet mis à jour et vous devez fournir les informations suivantes :

  1. un debdiff généré sur la version précédente dans LTS ;
  2. un lien vers un paquet de test qui peut être téléchargé et testé.

Il est courant pour les gens travaillant sur la LTS d'envoyer leurs paquets vers un dépôt personnel dans people.debian.org, mais n'importe quel dépôt publique ou même un simple serveur web peut convenir. Quelques lignes directrices pour ces ajouts temporaires :

Envoyer la mise à jour

Assurez-vous que vous avez utilisé un chroot propre pour construire les paquets binaires car ceux que vous envoyez finissent dans le dépôt (ils ne sont pas écartés ou reconstruits). L'usage de sbuild/pbuilder est recommandé.

Les uploads vers Debian LTS sont do not wait pour un DLA ou toute autre intervention manuelle avant d'être installés dans l'archive Debian. À cet égard, ils diffèrent des téléchargements de sécurité stables.

Si vous en êtes satisfait, faites un upload vers security-master en utilisant dput ou dput-ng :

dput security-master hello_1.0-1+deb8u1_amd64.changes

Une fois uploadé, le paquet sera automatiquement compilé pour les architectures non couvertes par votre envoi (si c'est un paquet arch:any). Les architectures actuellement prises en charge sont amd64, i386, armel et armhf.

Si vous utilisez dput-ng, vous devez appliquer le patch de 745806. Après ceci, « dput CHANGES file » est suffisant.

Déclarer un ID DLA dans DLA/list

Lancez bin/gen-DLA dans le dans le répertoire principal du dépôt Git. Ceci génère automatiquement une entrée dans data/DLA/list et vous demande de faire un commit des changements apportés pour faire en sorte qu'aucun ID n'est utilisé deux fois. La commande suivante devrait ajouter une entrée pour src:hello corrigeant le CVE-2014-0666 et créer pour vous une annonce « type » dans le répertoire racine secure-testing.

$ bin/gen-DLA --save hello CVE-2014-0666

Cette liste de CVE vous assurera que le suivi de la sécurité sera au courant du correctif et marquera les problèmes comme résolus pour ce paquet spécifique.

Annoncer la mise à jour

Maintenant que l'envoi est réalisé, un courriel sera envoyé à la liste de diffusion debian-lts-changes, confirmant que la mise à jour a été publiée dans l'archive de Debian. Le robot du système de suivi des bogues (BTS) l'annoncera également dans le canal #debian-devel-changes.

Envoyez un courriel à la liste de diffusion debian-lts-announce. Le courriel doit être signé par une clé GPG dans le trousseau de clés debian.org ou debian-maintainers. Les signature en ligne (inline) fonctionnent toujours (PGP/MIME fonctionne avec mutt mais échoue avec Enigmail).

Une annonce « type » a été créée par bin/gen-DLA (voir plus haut) et ressemble généralement à :

Subject: [DLA $DLA-1] $SOURCEPACKAGENAME security update

Package        : $SOURCEPACKAGENAME
Version        : $LTS_VERSION
CVE ID         : CVE-2014-0001 CVE-2014-0002
Debian Bug     : 12345

DLA text goes here
[...]

Si vous utilisez mutt, une façon simple pour l'envoyer est d'utiliser mutt -H DLA-123.

Vous devez envoyer le DLA à la liste de diffusion seulement après que vous ayez obtenu confirmation que le paquet a été traité après l'envoi (une fois que vous avez reçu le courriel d'acceptation).

Quand tout cela est fait, vous devez supprimer le paquet dans la section de test des autres emplacements où il a été envoyé, le cas échant.

Préparer une mise à jours sur le site web

Après avoir envoyé le courriel, vous devez également mettre à jour le site Web principal debian.org avec la nouvelle annonce. Pour cela, vous avez besoin d’une copie de la source du site Web. Avantages :

Pour cela, vous avez besoin d'une copie de la source du site. Ceci est une configuration unique :

/!\ Il est recommandé de demander d'être membre du groupe de webmasters sur Salsa. Autrement vous devez faire une demande de fusion. Ce flux de travail est en cours.

git clone https://salsa.debian.org/webmaster-team/webwml
# or: salsa fork webmaster-team/webwml
cd webwml/

Ensuite, en supposant que le numéro est DLA-1234-1 et que le modèle de courriel est dans ~-./DLA-1234-1, procédez comme suit :

git checkout -b DLA-1234-1
cd english/lts/security
./parse-dla.pl ~/DLA-1234-1
$EDITOR 2019/dla-1234* # make sure everything looks good
                       # Other option is, instead of looking at the html code, doing
                       # $ make -C 2019 dla-123.en.html
# and open the resulting html file with a web browser.
git add 2019/dla-1234.{data,wml}
git commit -m 'DLA-1234-1 advisory'
git push -u origin
# if you are a member of the debian-www project on salsa:
# if you are not a member you need to provide a merge request.
# Do this either one the command-line with 'salsa mr'
# /usr/bin/salsa is part of devscripts in sid and stretch-bpo
# or you need to be logged into the web ui and then go to
# https://salsa.debian.org/webmaster-team/webwml/merge_requests and press the green button labeled "new merge request"

Préparer les mises à jour de régressions pour LTS

Si un upload introduit une régression, celle-ci doit être corrigée aussi vite que possible.

Étapes pour une mise à jour corrigeant une régression

  1. Corrigez le paquet.
  2. Faites un test de construction et un test d'installation. Vérifiez que le problème de régression ainsi que le problème de vulnérabilité original soient tous deux maintenant corrigés.
  3. Assurez-vous que vous avez utilisé un chroot propre pour construire les paquets binaires car ceux qui vous envoyez finissent dans le dépôt (ils ne sont pas écartés ou reconstruits). L'usage de sbuild/pbuilder est recommandé.

  4. Faites un upload du paquet corrigé vers jessie-security.
  5. Utilisez le script gen-DLA pour ajouter une entrée DLA à data/DLA/list et pour vous donner un modèle d'annonce de courriel. Deux possibilités :
    1. La régression corrige l'upload précédent du paquet :

      $ bin/gen-DLA  --save $SOURCEPACKAGENAME regression
    2. La régression corrige une version antérieure à l'upload précédent du paquet :

      $ bin/gen-DLA  --save $PREVIOUS_DLA_ID $SOURCEPACKAGENAME regression

/!\ $PREVIOUS_DLA_ID nécessite d'être incrémenté...

  1. Faites un commit de data/DLA/list mis à jour vers le dépôt Git security-tracker.

  2. Attendez que le paquet uploadé arrive dans le dépôt jessie-security.
  3. Dans le dossier de base du dépôt Git security-tracker, vous pouvez trouver un fichier généré automatiquement de modèle d'annonce LTS ayant comme nom DLA-$DLA-{2,3,4...}. Utilisez ce fichier comme modèle pour votre annonce de correction de régression. Ne faites pas un commit de ce fichier sur Git(!). Copiez/collez le modèle d'annonce dans votre application de courriel, complétez/éditez le manuellement et envoyez finalement le courriel de correction de régression DLA à debian-lts-announce@lists.debian.org.

Triage de nouveaux problèmes de sécurité

L'équipe en charge de la sécurité et l'équipe LTS coopèrent pour traiter le flux de nouveaux problèmes de sécurité qui sont signalés. Depuis qu'est assigné un numéro CVE à chaque problème de sécurité, nous appelons souvent cela « triage CVE ».

Si vous voulez nous aider avec ceci, vous devez d'abord vous familiariser avec le tracker de sécurité. C'est l'infrastructure que vous utilisons pour suivre la façon dont les problèmes de sécurité affectent les paquets Debian. Veuillez lire avec attention cette page : http://security-team.debian.org/security_tracker.html.

Vous aurez besoin de droits d'écriture pour le dépôt git security-tracker.

Le triage CVE dans la version LTS

Abordons maintenant en détail le travail concernant LTS en particulier. Nous commençons à partir de la liste des problèmes ouvert dans la version LTS.

Vous pouvez démarrer avec la liste suivante : https://security-tracker.debian.org/tracker/status/release/oldstable (cochez « include issues to be checked ») ou bien, vous pouvez lancer le script bin/lts-cve-triage.py (script disponible dans le dépôt security-tracker) afin d'obtenir une liste pré-filtrée (les paquets dans dla-needed.txt sont exclus et les problèmes sont regroupés par « statut »).

Pour chaque CVE/paquet listé sur cette page, il y a seulement 2 résultats souhaitables :

Finalement, une partie du travail de triage comprend le classement des bogues non documentés pour les problèmes de sécurité dans le système de suivi de bogues, en utilisant le script bin/report-vuln. Les bogues doivent être classés sauf si le problème est déjà résolu dans unstable, en évitant bien sûr les doublons.

Bonnes pratiques pour le triage CVE

Voici maintenant la partie délicate. Comment décider si un problème doit être ajouté au fichier dla-needed.txt ou bien s'il doit être étiqueté d'une autre manière ? Il n'y a pas de réponse parfaite. Vous devrez user de votre meilleur jugement après avoir analysé le problème *avec soin*, les risques encourus, les problèmes causés par les administrateurs pour appliquer la mise à jour, etc. En cas de doute, vérifiez auprès des autres mainteneurs, du responsable du paquet ou de l'équipe en charge de la sécurité.

Ceci étant, l'équipe en charge de la sécurité prend ce genre de décisions tout le temps, et nous les suivons. Si l'équipe en charge de la sécurité a ajouté un paquet vulnérable à « data/dsa-needed.txt », vous pouvez généralement l'ajouter sans risque à « data/dla-needed.txt » (si le bug est également présent dans la version LTS du paquet). Si l'équipe en charge de la sécurité a étiqueté le problème « postponed » avec une description « Minor issue », vous pouvez faire de même en toute sureté. Une exception est que lorsque la raison choisie par l'équipe de sécurité est « Maintainer will update via stable-proposed-updates », dans ce cas, nous devons préparer une mise à jour pour la version LTS puisqu'il n'y a pas (encore) de lts-proposed-updates. En outre, vous pouvez toujours résoudre les problèmes non-dsa, si vous le souhaitez.

Si vous traitez un problème qui n'a pas encore été étudié par l'équipe de sécurité et s'il n'est pas évident que le problème justifie un DLA / DSA (« no-dsa »), il est bon de documenter cela dans une note jointe à l'entrée que vous pouvez ajouter à dla-needed.txt. Il est généralement inutile de corriger les bogues dans LTS qui ne seront pas corrigés dans stable ou même instable. Certes, des cas exceptionnels existent, par exemple lorsque le problème a un impact plus important sur la version LTS.

S'il n'est pas clair que le problème affecte la version Sid, vous devez également le trier et ouvrir un bogue correspondant dans l'outil de suivi des bogues (BTS) pour informer le responsable (sauf pour les problèmes d'embargo). Les mainteneurs savent souvent à quel point un problème est grave et si une mise à jour immédiate est réellement nécessaire.

Notez que certains paquets ont des instructions spéciales. Vérifiez packages/*.txt dans le dépôt security-tracker. Ceci pourrait influencer votre décision et possiblement vous inciter à vous comporter différemment (par exemple, en ne contactant pas le mainteneur puisque certains accords prédéterminés sont déjà mis en place).

Contacter le mainteneur

Chaque fois que vous prenez une décision pour un nouveau problème (qui est réel et affecte la version LTS), vous devez en informer les mainteneurs du paquet correspondant pour leur offrir l'opportunité de nous aider (ou pas ?). Pour cela, nous utilisons le script bin/contact-maintainers dans le dépôt security-tracker. Ne le faites que si le bug est déjà enregistré dans l'outil de gestion de bogues (BTS). Si ce n'est pas encore le cas, vous pouvez utiliser *bin/report-vuln* pour l'ouvrir. Les discussions sur la sévérité et l'urgence sont les mieux faites dans le rapport de bogue puisque toutes les parties concernées (équipe LTS, équipe en charge de la sécurité et responsables de paquets) peuvent s'impliquer.

Lorsque nous ajoutons un paquet à dla-needed.txt, vous pouvez par exemple utiliser ce script de la façon suivante :

$ bin/contact-maintainers --lts sudo CVE-2014-9680 CVE-2014-0106

Lorsque nous étiquetons « no-dsa » et que nous ne prévoyons pas de nous occuper nous-mêmes des mises à jour, nous ne communiquons généralement pas avec les responsables. Si c'est cependant nécessaire, un autre modèle est disponible :

$ bin/contact-maintainers --lts --no-dsa sudo CVE-2014-9680 CVE-2014-0106

Notez que la liste de CVE est optionnelle et que ce script suppose que vous utilisez mutt pour envoyer des courriels. Si ce n'est pas le cas, vous pouvez envisager l'utilisation de l'option --mailer afin de l'utiliser avec quelque chose d'autre (voir bin/contact-maintainer --help pour plus de détails). Vous devez personnaliser le courriel envoyé (au moins laisser la liste des uploaders et éventuellement ajuster la liste des destinataires).

Afin d'éviter au mainteneur de se sentir pressé, il y a quelques exceptions à prendre en compte :

Fonctionnalités « de guichet »

Comme décrit dans ce courriel, il y a une personne attitrée pour tenir un « guichet » pour le projet LTS. Les répartitions des personnes au guichet sont gérées dans le fichier lts-frontdesk.2019.txt.

Le travail du « guichet » concerne actuellement le triage CVE et le fait de s'assurer que les questions sur la liste de diffusion obtiennent une réponse. Il s'assure en particulier du suivi des questions et requêtes de parrainage sur l'envoi des paquets auprès des nouveaux contributeurs pour faire en sorte que tout ceci se réalise de manière fluide. Le suivi des problèmes anciens ou au point mort est également une bonne idée. Le guichet est à l'écoute de toute question des contributeurs concernant la LTS.

Le « guichet » est également en charge de s'assurer que les paquets déclarés dans data/dla-needed.txt sont pris en charge. Lorsqu'un paquet sans activité a été déclaré depuis trop longtemps, il doit en notifier le déclarant et, s'il n'y a pas de réponse sous 24 heures, supprimer le verrou. Note : actuellement (avril 2019), Holger le fait dans le cadre de la coordination LTS. L'historique des déclaration peut être consulté avec :

bin/review-update-needed --lts

Enfin, il devrait toujours y avoir une personne disponible dans une semaine donnée sur le service de guichet. Lorsque vous démarrez le guichet, assurez-vous que les 4 prochaines semaines sont déclarées par quelqu'un dans la liste de réception. Sinon, envoyez un courriel à la liste de diffusion pour demander des volontaires.

Liste de vérification

Voici une liste rapide de vérification récapitulative des tâches ci-dessus :

Garder une trace des bogues en relation avec la LTS

L'utilisation de deux « usertags » dans le système de suivi des bogues de Debian permet de garder une trace des bogues en relation avec la LTS :

Pour ajouter un « usertag » spécifique à un bogue, vous pouvez utiliser la commande bts :

bts user debian-lts@lists.debian.org , usertags <bugnumber> ease-lts

Passer à la version LTS suivante

Travaux d'entretien

Il y a plusieurs tâches où le travail de l'équipe LTS se base sur celui de l'équipe en charge de la sécurité et où l'équipe LTS peut aider cette dernière - spécialement lorsque il n'y a pas de problèmes ouverts dans dla-needed.txt. Ceci conduira à plus de paquets à corriger :

Outils et Astuces


CategoryLts