Esta página contém os detalhes de um projeto de redação técnica aceito para a Season of Docs do Google.
Resumo do projeto
- Organização de código aberto:
- Whonix
- Redator técnico:
- 0brand
- Nome do projeto:
- Documentar a instalação e a configuração da nova distribuição do Linux Debian reforçado com foco em segurança.
- Duração do projeto:
- Padrão (3 meses)
Descrição do projeto
O Debian reforçado é uma nova distribuição do Linux com foco em segurança, em desenvolvimento ativo pelos desenvolvedores do Whonix. Este projeto documenta a instalação e a configuração do Debian reforçado no Windows/VirtualBox do zero, com foco em ensinar aos usuários iniciantes do Linux as habilidades necessárias para se virarem sozinhos ao usar uma distribuição do Linux.
Metas do projeto
Criar documentação principal
A fase inicial deste projeto vai se concentrar na documentação principal do Debian reforçado. Ela será composta por uma visão geral abrangente do projeto, tutoriais para instalar e configurar o Debian reforçado e conselhos e dicas pós-instalação.
Criar áreas de aprendizado para novos usuários do Linux
Ensinar novos usuários do Linux não é escrever algumas páginas de manual e chamar isso de área educacional. Muitos iniciantes não estão acostumados a interagir com prompts de comando e solucionar os próprios problemas. Essas páginas vão se concentrar em habilidades de CLI, solução prática de problemas e práticas recomendadas de solução de problemas.
Separar claramente a documentação do Debian reforçado da documentação do Whonix (SO de anonimato):
Embora o Whonix.org seja a página inicial do Whonix e do Debian reforçado, cada SO tem casos de uso muito diferentes, o que pode levar a consequências graves se um usuário confundir um com o outro. Por exemplo, o Whonix é conhecido pelo anonimato, mas um novo usuário que não está familiarizado com o Whonix pode configurar o Debian reforçado e presumir que está navegando na Web de forma anônima. Para evitar esses tipos de erros, a documentação do Debian reforçado será confinada a uma área separada do Whonix.org usando um novo estilo de formatação semelhante a um livro, que é diferente do estilo de formatação da documentação do SO Whonix. Os avisos também serão incluídos em áreas importantes, como a página de download do Debian reforçado, para evitar que os usuários cometam esses erros.
Documentação fácil de usar
A instalação e a configuração de uma distribuição do Linux podem ser desafiadoras até mesmo para usuários experientes. Embora uma interface intuitiva e fácil de usar possa melhorar a experiência do usuário, é igualmente importante escrever uma documentação clara e fácil de seguir, ou seja, fácil de usar. Como a base de usuários do Debian reforçado varia de iniciantes a usuários avançados do Linux, é preciso ter cuidado para que a documentação não seja escrita com base apenas na experiência técnica e na compreensão do redator técnico. Em vez disso, o Debian reforçado será documentado da perspectiva de um iniciante do Linux que pode ter dificuldade em realizar tarefas que usuários experientes consideram simples e fáceis de concluir.
Incentivar o envolvimento/contribuições da comunidade
O Debian reforçado é um projeto desafiador que só pode ser concluído por completo se a comunidade permanecer engajada durante todo o projeto. Os membros da comunidade só vão continuar envolvidos se o feedback deles for recebido com entusiasmo e se as boas ideias forem usadas para melhorar a documentação. Durante a GSoD, vou permanecer ativo no fórum do Whonix, incentivando o feedback e as contribuições da comunidade para melhorar a documentação.
Renomear o SO Debian reforçado
Embora esse sistema operacional seja baseado no Debian reforçado, um novo nome precisa ser encontrado para evitar violações de infração de marca registrada. Para atingir esse objetivo, a comunidade Whonix será incentivada a enviar nomes cativantes para que os desenvolvedores do Whonix possam escolher. Embora ainda esteja no modo de brainstorming, minhas duas principais opções são "Linux Sentient" e "Linux Sentinel".
Cronograma do projeto
O cronograma deste projeto será dividido em sete minietapas que podem ser usadas para avaliar o progresso e permitir ajustes para garantir que cada seção seja concluída no prazo. Se surgirem dificuldades em qualquer momento durante a Season of Docs, vou notificar meu mentor imediatamente para que um plano de ação possa ser formulado para resolver o problema.
2 de setembro ( início do projeto da Season of Docs)
A página inicial vai fornecer uma visão geral do Debian reforçado, detalhando os principais pontos do SO.
A documentação inicial vai consistir na instalação do Debian reforçado no Windows/VirtualBox. Isso vai limitar o escopo inicial deste capítulo. No entanto, os membros da comunidade serão incentivados a testar o Debian reforçado em hosts Linux e no hipervisor KVM e documentar as descobertas.
Tabela detalhando o sistema operacional host compatível
Tabela detalhando os requisitos de hardware.
- Requisitos mínimos
- Recomendado
- Para melhor desempenho
O conteúdo vai consistir em uma visão geral detalhando as metas de desenvolvimento e os usos do Debian reforçado, seguida por uma tabela que descreve o componente individual.
Metas do Debian reforçado.
- Distribuição do Linux com foco em segurança
- Livre e de código aberto
- Configurável pelo usuário
- Reforçado por padrão
Tabela dos componentes que compõem o Debian reforçado.
- Hipervisor VirtualBox
- Windows
- SO baseado no Debian reforçado
- Terminologia (host, máquina virtual, SO convidado etc.)
O Debian reforçado é configurado com muitos recursos de segurança avançados por padrão. Isso elimina a necessidade de os usuários se atrapalharem com configurações complicadas. Todas as melhorias de segurança serão detalhadas em uma tabela com uma breve explicação dos benefícios.
- Haveged instalado por padrão para melhor entropia.
- A sincronização de tempo de rede distribuída segura (sdwdate) é usada em vez de garantir o NTP.
- Desativa as visualizações no Dolphin, Nautilus.
- Desativa os carimbos de data/hora TCP e o auxiliar de rastreamento de conexão do Netfilter.
- open-link-confirmation.
- Apparmor ativado por padrão com perfis.
- Navegador reforçado de segurança (navegador Tor sem Tor)
Kernel do Linux aprimorado
Ambiente de trabalho: KDE (disponível apenas na CLI).
Outras ...
Etapa 15 de setembro (requisitos de sistema completos, recursos e vantagens, designs e metas)
A página de perguntas frequentes será usada para responder a perguntas comuns feitas por membros da comunidade. O conteúdo será adicionado conforme necessário durante todo o projeto.
O download e a instalação do Debian reforçado consistirão no seguinte.
- Tabela de download que contém a imagem do Debian reforçado, a assinatura OpenGPG, o hash sha512 e a chave de assinatura GPG dos desenvolvedores.
- Verificar a chave de assinatura dos desenvolvedores e a imagem do sistema operacional (tutorial).
- Download e verificação do hipervisor VirtualBox (tutorial).
- Importar o Debian reforçado no VirtualBox (tutorial)
- Iniciar o Debian reforçado
Etapa 29 de setembro (concluir o download e verificar as imagens do Debian, instalação do Debian)
Os usuários podem não estar familiarizados com as etapas necessárias para personalizar o ambiente de trabalho e alocar recursos do sistema. As dicas de "configuração rápida" serão documentadas para cada um dos seguintes.
- Como mudar o layout do teclado
- Como alocar recursos adicionais do sistema (RAM)
- Como mudar a resolução da tela
- Atalhos da área de trabalho
- Gerenciador de estilo de janela
Os bugs e problemas encontrados durante o teste do SO e dos tutoriais serão claramente documentados, juntamente com soluções alternativas e/ou correções. Esta página também vai incluir problemas comuns ao executar sistemas operacionais em hipervisores.
- Problemas de RAM baixa
- Configuração incorreta do BIOS (Intel VT-d, AMD-V)
- Problemas de conectividade
Etapa 6 de outubro (concluir as primeiras etapas, bugs do Debian reforçado)
Novos usuários podem não estar familiarizados com terminais/CLI do Linux. Se as informações necessárias não forem fáceis de encontrar ou acessar, eles vão abrir uma solicitação de suporte sem nem mesmo tentar encontrar uma solução. Esta seção vai documentar comandos usados com frequência e sintaxe de comando prática. Cada man vai fornecer um breve resumo do comando, como usá-lo e exemplos práticos. Leva um tempo para que os usuários se lembrem dos comandos que precisam usar para diferentes tarefas. Com a repetição, os usuários vão se lembrar da sintaxe do comando ao longo do tempo.
- Terminal/CLI
- sudo
- Editores de texto
- Estrutura do diretório
- Navegação no sistema de arquivos
- Permissões de arquivo
- Páginas de manual
- Criar arquivos/diretórios
- Diversos (ls, cat, less)
Etapa 22 de outubro (concluir a área de aprendizado, páginas de manual)
Usuários do Linux capazes/experientes têm boas habilidades de solução de problemas que adquirem ao longo do tempo. Quando um problema surge, eles começam a procurar uma solução automaticamente e continuam pesquisando até encontrar uma resposta ou todos os recursos possíveis terem sido esgotados. Quando um novo usuário do Linux encontra um problema, ele abre uma solicitação de suporte automaticamente. É fundamental que as boas práticas sejam reforçadas desde o início.
Modelo de solução de problemas : os usuários têm mais chances de sucesso ao solucionar problemas se seguirem instruções passo a passo. Isso vai se concentrar em como coletar informações relevantes e como usar essas informações para encontrar uma solução para o problema. Isso será semelhante.
Monitoramento de arquivos de registro: localização dos registros do sistema (para que cada um é usado) e comandos necessários para restringir a saída da CLI. (journalctl, dmesg etc.)
systemd: status, início e interrupção de serviços.
Solução de problemas comuns: problemas de conexão, pacotes de software corrompidos etc.
Diretrizes de relatórios de bugs e/ou problemas.
Etapa 5 de novembro (concluir a área de aprendizado, solução de problemas)
O restante da Summer of Docs vai se concentrar na refatoração da documentação do Whonix para o Debian reforçado e no controle de qualidade.
Refatorar os documentos do Whonix para uso com o Debian reforçado
- Instalar software com segurança.
- Atualizações do sistema operacional