Cette page contient les détails d'un projet de rédaction technique accepté pour Google Season of Docs.
Résumé du projet
- Organisation Open Source :
- Whonix
- Rédacteur technique :
- 0brand
- Nom du projet :
- Documenter l'installation et la configuration de la nouvelle distribution Linux Debian renforcée axée sur la sécurité
- Durée du projet :
- Durée standard (3 mois)
Description du projet
Hardened Debian est une nouvelle distribution Linux axée sur la sécurité, en cours de développement actif par les développeurs Whonix. Ce projet documente l'installation et la configuration de Hardened Debian dans Windows/VirtualBox à partir de zéro, en mettant l'accent sur la formation des utilisateurs Linux débutants avec les compétences dont ils ont besoin pour être autonomes lorsqu'ils utilisent une distribution Linux.
Objectifs du projet
Créer une documentation de base
La phase initiale de ce projet sera axée sur la documentation de base de Hardened Debian. Elle comprendra une présentation complète du projet, des tutoriels pour installer et configurer Hardened Debian, ainsi que des conseils et astuces après l'installation.
Créer des zones d'apprentissage pour les nouveaux utilisateurs Linux
Pour former les nouveaux utilisateurs Linux, il ne suffit pas d'écrire quelques pages de manuel et de les appeler une zone d'apprentissage. De nombreux débutants ne sont pas habitués à interagir avec les invites de commande et à résoudre leurs propres problèmes. Ces pages seront axées sur les compétences en matière d'interface de ligne de commande, la résolution pratique des problèmes et les bonnes pratiques de dépannage.
Séparer clairement la documentation de Hardened Debian de celle de Whonix (OS d'anonymat) :
Bien que Whonix.org héberge Whonix et Hardened Debian, chaque OS a des cas d'utilisation très différents, ce qui pourrait avoir de graves conséquences si un utilisateur confondait l'un avec l'autre. Par exemple, Whonix est bien connu pour son anonymat, mais un nouvel utilisateur qui ne connaît pas Whonix peut configurer Hardened Debian et supposer qu'il navigue sur le Web de manière anonyme. Pour éviter ce type d'erreur, la documentation de Hardened Debian sera limitée à une zone distincte de Whonix.org, en utilisant un nouveau style de mise en forme de type livre, différent du style de mise en forme de la documentation de l'OS Whonix. Des avertissements seront également inclus dans des zones clés telles que la page de téléchargement de Hardened Debian pour éviter que les utilisateurs ne commettent ces erreurs.
Documentation conviviale
L'installation et la configuration d'une distribution Linux peuvent être difficiles, même pour les utilisateurs expérimentés. Bien qu'une interface utilisateur intuitive et facile à utiliser puisse améliorer l'expérience utilisateur, il est tout aussi important de rédiger une documentation claire et facile à suivre, c'est-à-dire conviviale. Étant donné que la base d'utilisateurs de Hardened Debian va des débutants aux utilisateurs Linux avancés, il convient de veiller à ce que la documentation ne soit pas rédigée uniquement en fonction de l'expertise technique et de la compréhension du rédacteur technique. Au lieu de cela, Hardened Debian sera documenté du point de vue d'un débutant Linux qui peut avoir des difficultés à effectuer des tâches que les utilisateurs expérimentés trouvent simples et faciles à réaliser.
Encourager l'implication et les contributions de la communauté
Hardened Debian est un projet difficile qui ne peut être mené à bien que si la communauté reste engagée tout au long de sa durée. Les membres de la communauté ne resteront impliqués que si leurs commentaires sont accueillis avec enthousiasme et que leurs bonnes idées sont utilisées pour améliorer la documentation. Tout au long de GSoD, je resterai actif sur le forum Whonix, en encourageant les commentaires et les contributions de la communauté pour améliorer la documentation.
Renommer l'OS Hardened Debian
Bien que ce système d'exploitation soit basé sur Hardened Debian, un nouveau nom doit être trouvé pour éviter les atteintes à une marque. Pour atteindre cet objectif, la communauté Whonix sera encouragée à proposer des noms accrocheurs parmi lesquels les développeurs Whonix pourront choisir. Bien que je sois encore en mode brainstorming, mes deux premiers choix sont "Sentient Linux" et "Sentinel Linux".
Calendrier du projet
Le calendrier de ce projet sera divisé en sept mini-étapes qui pourront être utilisées pour évaluer les progrès et permettre des ajustements afin de s'assurer que chaque section est terminée à temps. Si des difficultés surviennent à un moment donné pendant Season of Docs, j'en informerai immédiatement mon mentor afin qu'un plan d'action puisse être formulé pour résoudre le problème.
2 septembre ( début du projet Season of Docs)
La page d'accueil fournira une présentation de Hardened Debian, en détaillant les points clés de l'OS.
La documentation initiale portera sur l'installation de Hardened Debian dans Windows/VirtualBox. Cela limitera la portée initiale de ce chapitre. Toutefois, les membres de la communauté seront encouragés à tester Hardened Debian sur des hôtes Linux ainsi que sur l'hyperviseur KVM et à documenter leurs résultats.
Tableau détaillant les systèmes d'exploitation hôtes compatibles
Tableau détaillant la configuration matérielle requise
- Conditions minimales requises
- Recommandé
- Pour des performances optimales
Le contenu comprendra une présentation détaillant les objectifs de développement et les utilisations de Hardened Debian, suivie d'un tableau décrivant chaque composant.
Objectifs de Hardened Debian
- Distribution Linux axée sur la sécurité
- Libre et Open Source
- Configurable par l'utilisateur
- Renforcé par défaut
Tableau des composants qui constituent Hardened Debian
- Hyperviseur VirtualBox
- Windows
- OS basé sur Hardened Debian
- Terminologie (hôte, machine virtuelle, OS invité, etc.)
Hardened Debian est configuré par défaut avec de nombreuses fonctionnalités de sécurité avancées. Les utilisateurs n'ont donc pas besoin de se débattre avec des configurations souvent compliquées. Toutes les améliorations de sécurité seront détaillées dans un tableau avec une brève explication des avantages.
- Haveged installé par défaut pour une meilleure entropie
- La synchronisation temporelle réseau distribuée sécurisée (sdwdate) est utilisée plutôt que d'assurer le protocole NTP.
- Désactive les aperçus dans Dolphin et Nautilus.
- Désactive les horodatages TCP et l'assistant de suivi des connexions de Netfilter.
- open-link-confirmation
- Apparmor activé par défaut avec des profils
- Navigateur renforcé en matière de sécurité (navigateur Tor sans Tor)
Noyau Linux amélioré
Environnement de bureau : KDE (disponible uniquement dans l'interface de ligne de commande)
Autre ...
Étape du 15 septembre (exigences système complètes, fonctionnalités et avantages, conceptions et objectifs)
La page FAQ sera utilisée pour répondre aux questions fréquemment posées par les membres de la communauté. Du contenu sera ajouté au besoin tout au long du projet.
Le téléchargement et l'installation de Hardened Debian se feront comme suit.
- Tableau de téléchargement contenant l'image Hardened Debian, la signature OpenGPG, le hachage sha512 et la clé de signature GPG des développeurs
- Vérifier la clé de signature des développeurs et l'image du système d'exploitation (tutoriel)
- Télécharger et vérifier l'hyperviseur VirtualBox (tutoriel)
- Importer Hardened Debian dans VirtualBox (tutoriel)
- Démarrer Hardened Debian
Étape du 29 septembre (téléchargement et vérification des images Debian, installation de Debian)
Les utilisateurs ne connaissent peut-être pas les étapes nécessaires pour personnaliser l'environnement de bureau et allouer des ressources système. Des conseils de configuration rapide seront documentés pour chacun des éléments suivants.
- Modifier la disposition du clavier
- Allouer des ressources système supplémentaires (RAM)
- Modifier la résolution de l'écran
- Raccourcis de bureau
- Gestionnaire de style de fenêtre
Les bugs et problèmes détectés lors des tests de l'OS et des tutoriels seront clairement documentés, ainsi que les solutions de contournement et/ou les correctifs. Cette page inclura également les problèmes courants lors de l'exécution de systèmes d'exploitation dans des hyperviseurs.
- Problèmes de mémoire RAM insuffisante
- Erreur de configuration du BIOS (Intel VT-d, AMD-V)
- Problèmes de connectivité
Étape du 6 octobre (premiers pas, bugs de Hardened Debian)
Les nouveaux utilisateurs ne connaissent peut-être pas les terminaux/interfaces de ligne de commande Linux. Si les informations dont ils ont besoin ne sont pas faciles à trouver ou à consulter, ils finiront par ouvrir une demande d'assistance sans même essayer de trouver une solution. Cette section documentera les commandes couramment utilisées et la syntaxe pratique des commandes. Chaque man donnera un bref aperçu de la commande, de son utilisation et des exemples pratiques. Les utilisateurs mettent un certain temps à mémoriser les commandes qu'ils doivent utiliser pour différentes tâches. Avec la répétition, ils finiront par mémoriser la syntaxe des commandes.
- Terminal/Interface de ligne de commande
- sudo
- Éditeurs de texte
- Structure des répertoires
- Navigation dans le système de fichiers
- Autorisations de fichier
- Pages de manuel
- Créer des fichiers/répertoires
- Divers (ls, cat, less)
Étape du 22 octobre (zone d'apprentissage complète, pages de manuel)
Les utilisateurs Linux compétents/expérimentés possèdent de bonnes compétences en résolution de problèmes qu'ils acquièrent au fil du temps. Lorsqu'un problème survient, ils commencent automatiquement à chercher une solution et continuent jusqu'à ce qu'ils trouvent une réponse ou que toutes les ressources possibles aient été épuisées. Lorsqu'un nouvel utilisateur Linux rencontre un problème, il ouvre automatiquement une demande d'assistance. Il est essentiel de renforcer les bonnes pratiques dès le début.
Modèle de résolution de problèmes : les utilisateurs sont plus susceptibles de réussir à résoudre les problèmes s'ils suivent des instructions détaillées. L'accent sera mis sur la manière de recueillir des informations pertinentes et de les utiliser pour trouver une solution à leur problème. Ce sera similaire.
Surveillance des fichiers journaux : emplacement des journaux système (à quoi sert chacun d'eux) et commandes nécessaires pour affiner la sortie de l'interface de ligne de commande. (journalctl, dmesg, etc.)
systemd : état, démarrage et arrêt des services
Résolution des problèmes courants : problèmes de connexion, packages logiciels endommagés, etc.
Consignes de signalement des bugs et/ou des problèmes
Étape du 5 novembre (zone d'apprentissage complète, résolution de problèmes)
Le reste de Summer of Docs sera axé sur la refactorisation de la documentation Whonix pour Hardened Debian et sur le contrôle qualité.
Refactoriser la documentation Whonix pour l'utiliser avec Hardened Debian
- Installer des logiciels en toute sécurité
- Mises à jour du système d'exploitation