En esta página, se incluyen los detalles de un proyecto de redacción técnica aceptado para el programa Season of Docs de Google.
Resumen del proyecto
- Organización de código abierto:
- Whonix
- Redactor técnico:
- 0brand
- Nombre del proyecto:
- Documentación de la instalación y configuración de la nueva distribución de Linux de Debian reforzada enfocada en la seguridad
- Duración del proyecto:
- Duración estándar (3 meses)
Descripción del proyecto
Debian reforzado es una nueva distribución de Linux enfocada en la seguridad que está en desarrollo activo por parte de los desarrolladores de Whonix. En este proyecto, se documenta la instalación y configuración de Debian reforzado en Windows o VirtualBox desde cero, con un enfoque en educar a los usuarios de Linux por primera vez con las habilidades que necesitan para valerse por sí mismos cuando usan una distribución de Linux.
Objetivos del proyecto
Crear documentación principal
La fase inicial de este proyecto se centrará en la documentación principal de Debian reforzado. Esta incluirá una descripción general completa del proyecto, instructivos para instalar y configurar Debian reforzado, y consejos y sugerencias posteriores a la instalación.
Crear áreas de aprendizaje para usuarios nuevos de Linux
Enseñar a los usuarios nuevos de Linux no se trata de escribir algunas páginas de manual y llamarlo área educativa. Muchos principiantes no están acostumbrados a interactuar con los símbolos del sistema y solucionar sus propios problemas. Estas páginas se centrarán en las habilidades de la CLI, la solución de problemas prácticos y las prácticas recomendadas para la solución de problemas.
Separar claramente la documentación de Debian reforzado de la de Whonix (SO de anonimato):
Si bien Whonix.org será el hogar de Whonix y Debian reforzado, cada SO tiene casos de uso muy diferentes que podrían generar consecuencias graves si un usuario confunde uno con el otro. Por ejemplo, Whonix es conocido por su anonimato, pero un usuario nuevo que no esté familiarizado con Whonix podría configurar Debian reforzado y suponer que está navegando por la Web de forma anónima. Para evitar este tipo de errores, la documentación de Debian reforzado se limitará a un área separada de Whonix.org con un nuevo estilo de formato similar a un libro que es distinto del estilo de formato de la documentación del SO Whonix. También se incluirán advertencias en áreas clave, como la página de descarga de Debian reforzado, para evitar que los usuarios cometan estos errores.
Documentación fácil de usar
La instalación y configuración de una distribución de Linux puede ser un desafío incluso para usuarios experimentados. Si bien una IU intuitiva y fácil de usar puede mejorar la experiencia del usuario, es igual de importante escribir documentación clara y fácil de seguir, es decir, fácil de usar. Dado que la base de usuarios de Debian reforzado abarca desde principiantes hasta usuarios avanzados de Linux, se debe tener cuidado de que la documentación no se escriba únicamente en función de la experiencia técnica y la comprensión del redactor técnico. En cambio, Debian reforzado se documentará desde la perspectiva de un principiante de Linux que puede tener dificultades para realizar tareas que los usuarios experimentados consideran simples y fáciles de completar.
Fomentar la participación y las contribuciones de la comunidad
Debian reforzado es un proyecto desafiante que solo se puede completar en su totalidad si se garantiza que la comunidad permanezca involucrada durante todo el proyecto. Los miembros de la comunidad seguirán involucrados solo si sus comentarios se reciben con entusiasmo y sus buenas ideas se usan para mejorar la documentación. Durante todo el programa GSoD, permaneceré activo en el foro de Whonix para fomentar los comentarios y las contribuciones de la comunidad para mejorar la documentación.
Cambiar el nombre del SO Debian reforzado
Si bien este sistema operativo se basa en Debian reforzado, se debe encontrar un nombre nuevo para evitar infracciones de marcas registradas. Para lograr este objetivo, se alentará a la comunidad de Whonix a enviar nombres atractivos entre los que puedan elegir los desarrolladores de Whonix. Aunque todavía estoy en modo de lluvia de ideas, mis dos opciones principales son "Linux Sentiente" y "Linux Centinela".
Cronograma del proyecto
El cronograma de este proyecto se dividirá en 7 minihitos que se pueden usar para evaluar el progreso y permitir que se realicen ajustes para garantizar que cada sección se complete a tiempo. Si surgen dificultades en cualquier momento durante el programa Season of Docs, notificaré a mi mentor de inmediato para que se pueda formular un plan de acción para resolver el problema.
2 de septiembre ( inicio del proyecto Season of Docs)
La página principal proporcionará una descripción general de Debian reforzado con detalles de los puntos clave del SO.
La documentación inicial consistirá en la instalación de Debian reforzado en Windows o VirtualBox. Esto limitará el alcance inicial de este capítulo. Sin embargo, se alentará a los miembros de la comunidad a probar Debian reforzado en hosts de Linux, así como en el hipervisor KVM, y a documentar sus hallazgos.
Tabla con detalles del sistema operativo host compatible
Tabla con detalles de los requisitos de hardware
- Requisitos mínimos
- Recomendado
- Para obtener el mejor rendimiento
El contenido consistirá en una descripción general que detalla los objetivos de desarrollo y los usos de Debian reforzado, seguida de una tabla que describe el componente individual.
Objetivos de Debian reforzado
- Distribución de Linux enfocada en la seguridad
- Libre y de código abierto
- Configurable por el usuario
- Reforzado de forma predeterminada
Tabla de los componentes que conforman Debian reforzado
- Hipervisor de VirtualBox
- Windows
- SO basado en Debian reforzado
- Terminología (host, máquina virtual, SO invitado, etc.)
Debian reforzado está configurado con muchas funciones de seguridad avanzadas de forma predeterminada. Esto elimina la necesidad de que los usuarios tengan que lidiar con configuraciones a menudo complicadas. Todas las mejoras de seguridad se detallarán en una tabla con una breve explicación de los beneficios.
- Haveged instalado de forma predeterminada para una mejor entropía
- Se usa la sincronización segura de hora de red distribuida (sdwdate) en lugar de asegurar NTP.
- Desactiva las vistas previas en Dolphin y Nautilus.
- Desactiva las marcas de tiempo de TCP y el auxiliar de seguimiento de conexiones de Netfilter.
- open-link-confirmation
- Apparmor habilitado de forma predeterminada con perfiles
- Navegador reforzado de seguridad (navegador Tor sin Tor)
Kernel de Linux mejorado
Entorno de escritorio: KDE (solo disponible en la CLI)
Otras categorías
Hito del 15 de septiembre (requisitos del sistema completos, funciones y ventajas, diseños y objetivos)
La página de preguntas frecuentes se usará para responder preguntas que suelen hacer los miembros de la comunidad. El contenido se agregará según sea necesario durante todo el proyecto.
La descarga e instalación de Debian reforzado consistirán en lo siguiente.
- Tabla de descarga que contiene la imagen de Debian reforzado, la firma OpenGPG, el hash sha512 y la clave de firma GPG de los desarrolladores
- Verifica la clave de firma de los desarrolladores y la imagen del sistema operativo (instructivo).
- Descarga y verificación del hipervisor de VirtualBox (instructivo)
- Importa Debian reforzado en VirtualBox (instructivo)
- Inicia Debian reforzado
Hito del 29 de septiembre (descarga y verificación completas de imágenes de Debian, instalación de Debian)
Es posible que los usuarios no estén familiarizados con los pasos necesarios para personalizar el entorno de escritorio y asignar recursos del sistema. Se documentarán sugerencias de "configuración rápida" para cada uno de los siguientes elementos.
- Cambiar el diseño del teclado
- Asignar recursos adicionales del sistema (RAM)
- Cambiar la resolución de la pantalla
- Accesos directos de escritorio
- Administrador de estilo de ventana
Los errores y problemas que se encuentren durante las pruebas del SO y los instructivos se documentarán claramente junto con las soluciones alternativas o las correcciones. Esta página también incluirá problemas comunes cuando se ejecutan sistemas operativos en hipervisores.
- Problemas de RAM baja
- Configuración incorrecta del BIOS (Intel VT-d, AMD-V)
- Problemas de conectividad
Hito del 6 de octubre (primeros pasos completos, errores de Debian reforzado)
Es posible que los usuarios nuevos no estén familiarizados con las terminales o la CLI de Linux. Si la información que necesitan no es fácil de encontrar o accesible, terminarán abriendo una solicitud de asistencia sin siquiera intentar encontrar una solución. En esta sección, se documentarán los comandos de uso frecuente y la sintaxis de comandos prácticos. Cada man proporcionará un breve resumen del comando, cómo usarlo y ejemplos prácticos. Los usuarios tardan un tiempo en recordar los comandos que deben usar para diferentes tareas. A través de la repetición, los usuarios recordarán la sintaxis de los comandos con el tiempo.
- Terminal o CLI
- sudo
- Editores de texto
- Estructura del directorio
- Navegación del sistema de archivos
- Permisos del archivo
- Páginas de manual
- Crear archivos o directorios
- Varios (ls, cat, less)
Hito del 22 de octubre (área de aprendizaje completa, páginas de manual)
Los usuarios de Linux capaces o experimentados tienen buenas habilidades para resolver problemas que adquieren con el tiempo. Cuando surge un problema, comienzan a buscar una solución automáticamente y siguen buscando hasta que encuentran una respuesta o se agotan todos los recursos posibles. Cuando un usuario nuevo de Linux tiene un problema, abre automáticamente una solicitud de asistencia. Es fundamental reforzar las prácticas recomendadas desde el principio.
Plantilla de solución de problemas : Es más probable que los usuarios tengan éxito cuando solucionan problemas si siguen instrucciones paso a paso. Esto se centrará en cómo recopilar información pertinente y cómo usar esa información para encontrar una solución a su problema. Será similar.
Supervisión de archivos de registro: Ubicación de los registros del sistema (para qué se usa cada uno) y comandos necesarios para limitar el resultado de la CLI (journalctl, dmesg, etc.)
systemd: estado, inicio y detención de servicios
Solución de problemas habituales: Problemas de conexión, paquetes de software dañados, etc.
Lineamientos para informar errores o problemas
Hito del 5 de noviembre (área de aprendizaje completa, solución de problemas)
El resto del programa Summer of Docs se centrará en refactorizar la documentación de Whonix para Debian reforzado y el control de calidad.
Refactorizar la documentación de Whonix para usarla con Debian reforzado
- Instalar software de forma segura
- Actualizaciones del sistema operativo