Labtainers

Labtainers: Um framework de laboratório cibernético baseado em Docker

Distribuição criada: 01/06/2026 12:28
Revisão: v1.4.4i
Commit: 4f868e24
Branch: master

Conteúdo

Distribution and Use

Guide to directories

Support

Release notes

Distribuição e Uso

Por favor, veja as informações de licenciamento e distribuição no arquivo docs/license.md.

Guia de diretórios

• scripts/labtainers-student -- o diretório de trabalho para executar e testar laboratórios de alunos. Você deve estar nesse diretório para executar laboratórios de alunos.

• scripts/labtainers-instructor -- o diretório de trabalho para executar e testar a avaliação automatizada e visualizar resultados dos alunos.

• labs -- Arquivos específicos de cada laboratório

• setup_scripts -- scripts para instalar o Labtainers e o Docker e atualizar o Labtainers

• docs -- fonte latex para o labdesigner.pdf e outras documentações.

• UI -- Código-fonte do editor de laboratórios do Labtainers (Java).

• headless-lite -- scripts para gerenciar estações de trabalho Docker e instâncias em nuvem do Labtainers (sistemas que não possuem servidores X11 nativos.)

• scripts/designer -- Ferramentas para construir novos laboratórios e gerenciar imagens base Docker.

• config -- configurações de todo o sistema (não são as configurações específicas de laboratório).

• distrib -- scripts de suporte à distribuição, por exemplo, para publicar laboratórios no Docker hub.

• testsets -- Procedimentos de teste e resultados esperados. (Drivers por laboratório para o SimLab não são distribuídos).

• pkg-mirrors -- scripts utilitários para espelhamento interno de pacotes NPS para reduzir a obtenção externa de pacotes durante testes e distribuição.

Suporte

Use os relatórios de problemas do GitHub, ou envie um e-mail para [email protected]

Veja também https://my.nps.edu/web/c3o/support1

Notas de versão

A distribuição padrão do Labtainers não inclui arquivos necessários para o desenvolvimento de novos laboratórios. Para esses, execute ./update-designer.sh a partir do diretório labtainer/trunk/setup_scripts.

O script de instalação e o script update-designer.sh definem variáveis de ambiente, portanto, você pode querer fazer logout/login, ou iniciar um novo shell bash antes de usar o Labtainers pela primeira vez.

6 de janeiro de 2026

• Corrigido bug introduzido no script de instalação devido a indentação.

30 de dezembro de 2025

• Modificado formato do relatório checkwork para vertical; guia em vídeo para headless; caminhos de conveniência

15 de outubro de 2025

• Revisado laboratório packet-introspection para atualizar link do banco de dados de geolocalização maxmind e notar uso de banco de dados legado.

24 de abril de 2025

• Corrigido imodule para criar corretamente diretórios ausentes conforme pull request #96

22 de novembro de 2024

• Substituída máquina virtual google cloud, desta vez devido a falha do systemd dentro de contêineres.

23 de setembro de 2024

• Substituída máquina virtual google cloud, que estava usando a versão errada do Docker

10 de setembro de 2024

• Erro de digitação na criação do caminho do imodule

26 de julho de 2024

• Modificado capinout para não usar a função grantpt da clib, que agora parece falhar quando executada a partir de um contêiner.

22 de julho de 2024

• Adicionado um contêiner base para Ubuntu22 e alterações no framework para suportá-lo.

5 de julho de 2024

• Migrado para Ubuntu 24 como a máquina virtual do appliance
• O pacote docker python usa uma biblioteca http python quebrada, exigindo downgrade do pacote.
• Usado ambiente virtual python para evitar o bloqueio do Ubuntu em pacotes python.
• Adicionado parâmetro de boot para permitir compartilhar systemd entre contêineres e a VM.
• Redirecionadas mensagens de erro do utilitário tar quebrado em atualizações.
• Quebra na atualização do Ubuntu para pacotes msc (veja update-ubuntu.sh) para VMs versão 18
• O comando docker-compose está quebrado, use "docker compose"
• Forçadas permissões de socket no headless labtainers.
• Atualizado headless Labtainers para usar Ubuntu 24

27 de novembro de 2023

• Adicionada opção Google Cloud Platform para ubuntu22 em máquina ec2.

18 de setembro de 2023

• A implementação da correção anterior estava falha.

8 de agosto de 2023

• Tratada mudança no formato json de imagem do DockerHub. Obrigado Kees!

17 de abril de 2023

• Forçado uso da versão mais recente do laboratório, por exemplo, iptables2 em vez de iptables. Corrigido tab completion para exibir apenas a mais recente. (Issue #77)
• A instalação do laboratório CyberCIEGE estava falhando devido a condição de corrida do X11. (Issue #76)
• Nota no readme do CyberCIEGE para direcionar alunos a salvar logs coletados no diretório $HOME. (Issue #75)
• O checkwork do laboratório Radius estava reportando incorretamente "radiusd not running", faltando script prestop. (Issue #74)
• Labedit corrompia o arquivo de configuração inicial quando a opção MACVLAN_EXT era usada. (Issue #73)

1 de fevereiro de 2023

• O histórico do bash para usuários não padrão não estava sendo salvo. 26 de janeiro de 2023
• Modificados scripts powershell para gcloud para usar a zona selecionada para qualificar nomes de VMs. 4 de janeiro de 2023
• Contêineres usando systemd estavam falhando no systemd mais recente presente no Ubuntu 22
• Adicionado parâmetro --zone aos scripts google cloud, com valor derivado do script set_defaults. 21 de dezembro de 2022
• Corrigidos critérios de resultado do xforge para não esperar pathname, e adicionada verificação para ver se POST foi emitido para editar perfil. E corrigido servidor http do atacante para executar a partir do diretório home. 19 de dezembro de 2022
• Adicionado laboratório strace para introduzir rastreamento de chamadas de sistema.
• O valor DISPLAY do X11 estava incorreto se houvesse múltiplos dispositivos no diretório /tmp/.X11-unix.
• Uso de python/bash/sh/etc sem argumentos estava causando falha no capinout. 9 de dezembro de 2022
• Modificado script de criação de VM Azure para usar uma imagem de VM Labtainer pré-construída da Galeria da Comunidade Azure.
• Terminais em VMs na nuvem travam por razões desconhecidas durante a inicialização ou clique direito no terminal. Tentativa de resolver com início/parada de um terminal. 5 de dezembro de 2022
• Ao coletar artefatos, incluir arquivos modificados de diretórios de usuários não padrão, por exemplo, seus históricos bash.
• Alterada avaliação web para exibir os novos arquivos de "outro usuário".
• Incluídos arquivos de .local/bin em cada contêiner nos artefatos. Destinado a tornar esses disponíveis ao instrutor via avaliação web.
• No laboratório ACL, incluído arquivo th /shared_data/bob/fun nos resultados para referência do instrutor.
• Capturado uso de "sh" ou "bash" na linha de comando e ignorado ao analisar comando fornecido, por exemplo, como feito com "time" ou "sudo".
• No laboratório tcpip, não era possível ssh para o servidor durante sessões subsequentes do laboratório, o diretório /run/sshd não estava sendo recriado. 16 de novembro de 2022
• Corrigido caminho para o Manual do Snort no laboratório snort.
• No manual ossec, corrigido caminho para manage_agents 12 de outubro de 2022
• Google cloud: removido operador de background do comando gnome-terminal, ainda trava ao clicar direito, mas parece estável após executar um newterm.sh. 10 de outubro de 2022
• Corrigido newterm.sh do Google cloud; ampliado disco de boot para 30G. 20 de setembro de 2022
• Notado ID de usuário e senha para o laboratório TCP/IP no manual do laboratório. 30 de agosto de 2022
• Usado o nome do socket X11 ao definir DISPLAY a partir do .profile de um contêiner. 9 de agosto de 2022
• Corrigido nome da função processValueMax no grader. Issue #63

4 de agosto de 2022

• O programa labedit foi reconstruído com o JDK errado, impedindo que JREs mais antigos executassem labedit

18 de julho de 2022

• A criação de contêineres baseados em Ubuntu20 estava falhando dentro de IModules. Issue #61.

23 de março de 2022

• Corrigido caminho para o diretório de lock do tap; estava causando falha em laboratórios que usam taps de rede
• Atualizado computador netmon do plc-traffic para ter openjfx necessário para o novo grassmarlin em ambiente java
• Acelerada inicialização de laboratório evitando chown -R, que é muito lento no docker.
• Outra tentativa de evitar a exclusão do link X11 no diretório /tmp do contêiner.
• Corrigida contagem de sites visitados no webtrack e removida meta de live-headers, essa ferramenta não está mais disponível. Esclarecidas algumas etapas do manual do laboratório.

2 de março de 2022

• Adicionado novo laboratório ssh-tunnel (obrigado GWD!)
• Corrigida falha do labedit em refletir valor X11 definido por new_lab_setup
• Adicionada opção para não parametrizar um contêiner

23 de fevereiro de 2022

• labedit estava corrompendo start.config após adição de novos contêineres
• Caminho incorreto para o guia do aluno no arquivo README do aluno; alterado dinamicamente para configurações em nuvem
• Extensão incorreta para update-labtainer.sh
• Aprimoramentos no guia Msc
• Atualizado laboratório ghidra para incluir versão 10.1.2 do Ghidra

15 de fevereiro de 2022

• Revertido suporte à nuvem Azure para provisionar para cada aluno. Azure desencoraja compartilhamento de recursos.

24 de janeiro de 2022

• A nuvem Azure agora usa imagem armazenada em um blob Azure em vez de provisionar para cada aluno.
• Adicionado suporte para Google Cloud.

19 de janeiro de 2022

• Introduzido Labtainers na nuvem Azure. Veja o Guia do Aluno para detalhes de como usar isso.

3 de janeiro de 2022

• Revisado laboratório setuid-env para adicionar melhor avaliação; teste simlab e evitado sighup no filho printenv.
• Corrigida diretiva de contagem de metas de avaliação para excluir valores de tag de resultado falsos.
• Não exigir labname ao usar gradelab -a com um grader iniciado com opção debug.
• Revisado capinout (espelhamento stdin/stdout) para lidar com orfandade de filhos de processo de comando, documentação melhorada e tratamento de erros.
• Adicionada exibição de barras de progresso de imagens Docker sendo baixadas quando um laboratório é executado pela primeira vez.
• Feedback do usuário sobre o progresso da inicialização do contêiner.
• O laboratório pcap-lib estava faltando um arquivo notify necessário para avaliação automatizada; removido passo extra do Manual do Laboratório.

23 de novembro de 2021

• Desabilitados popups de erro do Ubuntu na VM de teste.
• Corrigido tratamento de diferentes formatos de variável DISPLAY.

22 de outubro de 2021

• Revisado guia do laboratório tcpip para notar que um ataque syn-flood bem-sucedido não é possível. Corrigida sua avaliação automatizada e adicionados scripts SimLab.
• Alterada extensão de arquivo de artefato de zip para lab, e adicionado preâmbulo para confundir gerenciadores de arquivo GUI. Alunos estavam abrindo o zip e enviando seu conteúdo.
• Tornada a opção -r do gradelab como padrão, adicionada opção -c para uso cumulativo do grader.
• Modificado refresh_mirror para se referir à data de lançamento local para evitar consultas frequentes ao DockerHub. Cada consulta conta como um pull de imagem, e agora eles estão tentando monetizar essas.

30 de setembro de 2021

• Alterado guia do laboratório bufoverflow e avaliação para não esperar sucesso com ASLR ligado, avaliar se foi executado.
• Tratamento de erro no grader web para casos em que o aluno não possui resultados.
• Exibido aviso quando um laboratório obsoleto é executado.
• Alterada avaliação formatstring para remover descrição não utilizada "_leaked_secret" e esclarecer valor de leaked_no_scanf.
• Também alterada avaliação formatstring para permitir qualquer nome para o executável vulnerável.

29 de setembro de 2021

• Tratamento de erro no gradelab, reduzidas instâncias de falhas devido a arquivos zip ruins.
• Limitados arquivos de artefato stdout a 1MB

17 de setembro de 2021

• Guia do laboratório Ghidra tinha endereço IP errado, não foi refeito a partir da fonte.

14 de setembro de 2021

• Laboratórios de exemplo para LDAP e Mariadb usando SSL. Destinados como modelos para novos laboratórios.
• Tratado formato de log do Mariadb
• Adicionados parâmetros por contêiner para limitar uso de CPU ou fixar contêiner a um conjunto de CPUs.
• Criação de Labpack agora disponível via GUI (makepackui).
• Tab completion para os comandos labtainer, labpack e gradelab.
• Novo laboratório de computação paralela ``parallel'' usando MPI.

3 de agosto de 2021

• Adicionada opção de configuração "WAIT_FOR" para fazer um contêiner atrasar a parametrização até que outro contêiner complete sua parametrização.
• Suporte para formatos de log do Mariadb na análise de resultados
• Removido suporte para uso de Mac e Windows com Docker Desktop. Esse produto é muito instável para nós suportarmos.
• Suprimidas mensagens de stderr quando o usuário usa comandos bash embutidos como "which".
• Correções de bugs nos programas makepack/labpack.

19 de julho de 2021

• Adicionado laboratório DNS para introduzir o protocolo DNS e configuração.
• Revisada imagem do appliance VirtualBox para iniciar com o script de atualização correto.
• Separado parâmetro nameserver do resolv.conf do campo de configuração lab_gw em seu próprio valor.
• Comando IModule falhava se executado antes de qualquer laboratório ter sido iniciado.

5 de julho de 2021

• Erros no gerenciamento da variável de ambiente DISPLAY quebraram aplicações GUI no Docker Desktop.

1º de julho de 2021

• Suporte à instalação de pacotes Mac do headless Labtainers.
• A avaliação automatizada do laboratório routing-basics falhou devido à falta de arquivos treataslocal
• Corrigidos erros de digitação e endereços incorretos no laboratório routing-basics, e corrigida avaliação automatizada.
• Avaliação do pcapanalysis estava falhando.

10 de junho de 2021

• Todos os PDFs de manual de laboratório agora estão no repositório github
• Convertidas instruções dos laboratórios vpnlab e vpnlab2 para manuais em PDF.

25 de maio de 2021

• Adicionadas palavras-chave pesquisáveis a cada laboratório. Veja "labtainer -h" para uso.
• Expandido laboratório routing-basics e manual do laboratório
• Removido laboratório routing-basics2, agora redundante.
• sudo em alguns contêineres falhava porque nomes de host removem underscores, levando a incompatibilidade com o arquivo hosts. Corrigido com entrada extra no arquivo hosts com nome do contêiner sem underscore.
• Novo recurso Labpack para empacotar uma coleção de laboratórios, e ferramenta makepack para criar Labpacks.
• Verificação de erro para diretório /sbin ao usar ubuntu20 -- seria silenciosamente fatal.
• Novo laboratório network-basics

5 de maio de 2021

• Introduzido novo laboratório de usuários para introduzir gerenciamento de usuários/grupos
• Suprimidas mensagens de host Apparmor em syslogs de contêineres centos

28 de abril de 2021

• Novas imagens base2 não tinham páginas de manual. Usado unminimize para restaurá-las na imagem base.
• Introduzido laboratório OSSEC IDS baseado em host.

13 de abril de 2021

• Laboratório CyberCIEGE falhou porque o socket X11 não foi realocado antes de iniciar Wine via fixlocal.

9 de abril de 2021

• Novo laboratório tutorial gdb-cpp para usar GDB em um programa C++ simples.
• Exceções de ponto flutuante estavam revelando uso de exec_wrap.sh para espelhamento stdin/stdout.

7 de abril de 2021

• Laboratório ldap falhou quando movido para Ubuntu 20. Problema rastreado até problema com cache nscd de pwd. Movido ldap para Ubuntu 20

23 de março de 2021

• Parametrização com RANDOM não incluía o limite superior.
• Adicionado parâmetro opcional de passo para RANDOM, por exemplo, para garantir limites de palavras.
• Laboratório db-access: adicionado mysql-workbench ao computador do banco de dados.
• Novo laboratório overrun para ilustrar referências de memória além dos limites de estruturas de dados em C.
• Novo laboratório printf para introduzir referências de memória feitas pela função printf.

19 de março de 2021

• gradelab ignora erro makdirs, problema com rmtree do Windows em pastas compartilhadas.
• gradelab lida com espaços em nomes de arquivos zip de alunos.
• gradelab lida com nomes de arquivos zip do Moodle, incluindo downloads de build.

12 de março de 2021

• UI do labedit: Removida imagem antiga do wireshark da lista de imagens base.
• UI do labedit: Aumentados alguns tamanhos de fonte.
• Interface web do grader falhou ao exibir manuais de laboratório se o nome do manual não segue convenções de nomenclatura.

11 de março de 2021

• UI do labedit adiciona configuração de registro no novo painel de configuração global do laboratório.

10 de março de 2021

• Correções na UI do labedit para não construir se erro de sintaxe no laboratório
• Correção no indicador "Lab running" da UI do labedit para refletir o laboratório atual.

8 de março de 2021

• Depreciado uso de HOST_HOME_XFER, todos os laboratórios usam diretório conforme arquivo labtainer.config.
• Adicionado comentário de documentação ao start.config para REGISTRY e BASE_REGISTRY

5 de março de 2021

• Tratamento de erro na interface web do gradelab quando faltam resultados.
• Adição de precheck no labedit, correções de bugs no msc.

26 de fevereiro de 2021

• O laboratório dmz-example tinha erros de roteamento e configuração de dnsmasq em alguns componentes.

18 de fevereiro de 2021

• A UI estava reconstruindo imagens porque atualizava timestamps de arquivos sem necessidade
• Limpeza do código da UI para remover algumas cópias redundantes de dados.

14 de fevereiro de 2021

• Adicionada opção de build local à UI
• Criado faux_init vazio para bases centos6.

11 de fevereiro de 2021

• Corrigido tratamento da UI na edição de arquivos. Revisado layout e eliminados campos não utilizados.
• Adicionadas configurações base2 ubuntu20 junto com ssh2, network2 e wireshark2
• O novo wireshark resolve o problema de janelas pretas/sem ruído.
• Mapeado /tmp/.X11-unix para /var/tmp e criado link. Necessário para ubuntu20 (estava deletando /tmp?) e pode corrigir outros.

4 de fevereiro de 2021

• Adicionada opção SIZE aos artefatos de resultado
• Simplificada avaliação e parametrização do wireshark-intro e adicionado manual do laboratório em PDF.
• Fornecidos valores de lista de parâmetros ao script pregrade.sh como variáveis de ambiente
• Habilitado X11 no grader
• colocado update-designer.sh no path dos usuários.

19 de janeiro de 2021

• Alterado gerenciamento da data/rev do README para atualizar arquivo no repositório fonte.
• Introduzida GUI para criar/editar laboratórios -- veja comando labedit.

21 de dezembro de 2020

• A função gradelab falhava quando arquivos zip eram copiados de uma pasta compartilhada do VirtualBox.
• Atualizado Guia do Instrutor para descrever gerenciamento de arquivos zip de alunos em computadores host.

4 de dezembro de 2020

• Transição da distribuição de tar para artefatos de lançamento do GitHub
• Eliminado arquivo tar separado do designer, usado tarball do repositório git.
• Teste de funções web do grader para análise de artefatos de laboratório de alunos
• Limpeza de logs do smoketest completo e exclusão de contêiner grader no comando removelab.

1º de dezembro de 2020

• A avaliação do laboratório iptables2 dependia de portas aleatórias serem "desconhecidas" pelo nmap.
• Usado um diretório sync para atrasar smoketests de iniciar antes da inicialização do laboratório.
• Iniciada integração de elementos da UI do designer de laboratório.

13 de outubro de 2020

• Configurações headless para execução no Docker Desktop em Macs e Windows
• Suporte a servidor headless, arquivo cloud-config para implantações em nuvem
• Suporte a teste para configurações headless
• Forçado mynotify a aguardar até que rc.local seja executado na inicialização
• Melhorada capacidade do serviço mynotify de mesclar saída em um único timestamp
• Python3 para script stopgrade
• SimLab agora usa docker top em vez de system ps

26 de setembro de 2020

• Limpeza dos scripts stoplab para ignorar contêineres não relacionados ao laboratório
• Adicionado laboratório de controle de acesso a banco de dados db-access para compartilhamento controlado de um mysql db.

17 de setembro de 2020

• O laboratório macs-hash não conseguia executar Leafpad devido à configuração X11.
• O logging do grader estava sendo redirecionado para o arquivo de log errado, agora captura erros do instructor.py
• Copiado instructor.log do grader para o diretório de logs do host se houver um erro.

28 de agosto de 2020

• Corrigido script de instalação para usar python3-pip e corrigidos scripts quebrados: getinfo.py e pull-all.py
• Lógica de registro estava quebrada, sistemas de teste não estavam usando o registro de teste, adicionada documentação de desenvolvimento.
• Adicionados juiceshop e owasp como arquivos base para laboratórios de segurança web baseados em OWASP
• Removidos sudos desnecessários de check_nets
• Adicionada diretiva de documentação CHECK_OK para avaliação automatizada
• Alterado check_nets para corrigir problemas de iptables e roteamento se assim orientado.

12 de agosto de 2020

• Adicionado timeout a scripts prestop
• Adicionados quiz e checkwork ao dmz-lab
• Reiniciar o dmz-lab sem a opção -r quebrava o roteamento saindo do ISP.
• Permitir múltiplos arquivos para resultados time_delim.6 de agosto de 2020
• Erro no tratamento de erros quando o socket X11 está faltando
• Vírgulas em questões do quiz causaram erros de análise
• Adicionar quiz e checkwork ao laboratório iptables2

28 de julho de 2020

• Adicionar suporte a quiz -- estes são quizzes de orientação, não quizzes de avaliação. Veja o guia do designer.
• Adicionar avaliação de estado atual para uso com o comando checkwork.

21 de julho de 2020

• Adicionar testsets/bin ao caminho do designer
• Correções e explicações no guia do designer para etapas do IModule.
• Adicionar tipo de resultado RANGE_REGEX para definir intervalos de tempo usando expressões regulares em entradas de log.
• Verificar se o socket X11 existe se for necessário ao iniciar um laboratório.
• Adicionar imagem base para mysql
• Tratar formatos de timestamp de log do mysql na análise de resultados.

15 de junho de 2020

• Nova imagem base contendo o roteador open source Bird
• Adicionar laboratório bird-bgp Border Gateway Protocol.
• Adicionar protocolo de roteamento bird-ospf Open Shortest Path First.
• Melhorar o tratamento de mudanças de DNS, o acesso externo de alguns contêineres estava bloqueado em alguns sites.
• Adicionar seção ao Guia do Instrutor sobre o uso de Labtainers em ambientes sem acesso à Internet.

21 de maio de 2020

• Mover todos os repositórios para o registro labtainers do Docker Hub
• Suportar montagens definidas no start.config para permitir instalações persistentes de software
• Alterar o laboratório ida para usar instalação persistente do IDA -- novo nome é ida2
• Adicionar laboratório cgc para exploração de mais de 200 serviços vulneráveis do DARPA Cyber Grand Challenge
• Adicionar comando type_string ao SimLab
• Adicionar laboratório netflow para uso de análise de tráfego de rede NetFlow
• Adicionar versões de 64 bits dos laboratórios bufoverflow e formatstring

9 de abril de 2020

• O avaliador falhou na avaliação das condições CONTAINS e FILE_REGX quando curingas foram usados para seleção de arquivos.
• Incluir dicas para usar hexedit no laboratório symlab.
• Adicionar operador hash_equal e hash-goals.py à avaliação automatizada para evitar publicar respostas esperadas em arquivos de configuração.
• Avaliação automatizada para o laboratório pcap-lib.

7 de abril de 2020

• Os logs foram movidos para $LABTAINER_DIR/logs
• Outras limpezas para permitir reconstruções e testes usando Jenkins, incluindo uso de diretórios temporários únicos para builds
• Mover funções de suporte de build de labutils para build.py
• Adicionar laboratório pcap-lib para desenvolvimento baseado em biblioteca PCAP de programas de análise de tráfego

13 de março de 2020

• Adicionar laboratório plc-traffic para uso do GrassMarlin com tráfego gerado durante o laboratório.
• Introduzir capacidade de adicionar contêineres 'tap' para coletar PCAPs de redes selecionadas.
• Atualizar documentação do GNS3 para acesso externo a contêineres e uso de dummy_hcd para simular unidades USB.
• Alterar modelo kali para usar faux_init em vez de tentar usar systemd.
• Movendo distribuições (arquivos tar) para box.com
• Alterar uso de netstat pelo SimLab para não fazer consulta DNS.

26 de fevereiro de 2020

• Se o comando labtainer não encontrar o laboratório, sugerir que o usuário execute update-labtainer.sh
• Adicionar suporte preliminar para um componente de tap de rede para visualizar todo o tráfego de rede.
• Script para buscar imagens de laboratório para preparar VMs que serão usadas sem internet.
• Fornecer nome de usuário e senha para o laboratório nmap-discovery.

18 de fevereiro de 2020

• Herdar a variável de ambiente DISPLAY do host (ex.: VM) em vez de assumir :0

14 de fevereiro de 2020

• Adicionar exercício introdutório de engenharia reversa de software Ghidra.

11 de fevereiro de 2020

• Atualizar guias para descrever acesso remoto a contêineres em ambientes GNS3
• Ocultar componentes e links selecionados dentro do GNS3.
• Figuras no guia do laboratório webtrack não estavam visíveis; erros de digitação neste e no nmap-ssh

6 de fevereiro de 2020

• Introduzir função para gerenciar contêineres remotamente, ex.: enviar arquivos.
• Adicionar função de ambiente GNS3 para simular inserção de uma unidade USB.
• Melhorar o tratamento de erros de build do Docker.

3 de fevereiro de 2020

• No laboratório metasploit, o serviço postgresql não estava sendo executado na vítima.
• Mesclar o conteúdo do manual do IModule no guia do Lab Designer.
• Mais suporte a IModule.

27 de janeiro de 2020

• Introduzir suporte inicial para IModules (laboratórios desenvolvidos pelo instrutor). Veja docs/imodules.pdf.
• Corrigir variável de ambiente LABTAINER_DIR quebrada no update-labtainer
• Corrigir modo de acesso no arquivo accounting.txt no laboratório ACL (tornou-se rw-r-r). Usar chmod explícito no fixlocal.sh.

14 de janeiro de 2020

• Portar framework e gradelab para Python3 (laboratórios Python2 existentes não serão alterados)
  • Usar opções random.seed compatíveis com versões anteriores
  • Adaptar randint não compatível para retornar valores antigos
  • Continuar a suportar python2 para plataformas que não possuem python3 (ou aquelas como o appliance de VM mais antigo que inclui python 3.5.2, o que quebra a compatibilidade random.seed).
  • Adicionar alias rebuild para rebuild.py que selecionará python2 se necessário.
• Páginas de manual de laboratórios baseados em Centos estavam falhando; usar mandb dentro do arquivo docker base
• Netmask do dmz-lab para rede DMZ estava errada (pega pelo python3); assim como o endereço IP do gateway interno no manual do laboratório
• ghex removido dos laboratórios centos -- não é mais facilmente suportado pelo centos 7
• laboratório file-deletion deve ser concluído sem reiniciar a VM, observe isso no Manual do Laboratório.
• Adicionar opção NO_GW ao start.config para desabilitar gateways padrão nos contêineres.
• Laboratório Metasploit, trava a VM host se executar como privilegiado; longos atrasos no su se systemd habilitado; então executar sem systemd. Remover uso de banco de dados do manual do laboratório, configurar para usar nova opção no_gw
• Atualizar cabeçalhos de arquivos para licenciamento/termos; adicionar arquivo de licença consolidado.
• Modificar publish.py para usar por padrão o registro de teste, usar -d para forçar uso de default_registry
• Revisar procedimentos de controle de fonte para usar registro de teste diferente para cada branch, e usar um branch premaster para teste final de um lançamento.

9 de outubro de 2019

• Remover dnsmasq do componente dns no dmz-lab. Estava causando falha do bind em algumas instalações.

8 de outubro de 2019

• Erro de sintaxe na configuração do registro de teste; informações do designer do laboratório sobre arquivos grandes; buscar arquivos bigexternal.txt

30 de setembro de 2019

• Recuperação do registro DockerHub falhando novamente para alguns usuários. Ignorar prefixo html para json.

20 de setembro de 2019

• Avaliação de onewayhash deve permitir operações hmac em arquivo de escolha do aluno.

5 de setembro de 2019

• Reconstruir laboratório metasploit, metasploit-framework exibiu um bug. E o arquivo 'treataslocal' dos laboratórios foi deixado de fora da migração do svn. Corrigir tipo no manual do laboratório metasploit.

30 de agosto de 2019

• Reverter teste de existência de diretórios de contêineres, eles nem sempre existem.

29 de agosto de 2019

• Puxadas de imagem de laboratório do docker hub falharam devido a mudança no github ou curl? Capturar redirecionamento para cloudflare.
• Adição de suporte GNS3. Correção do dnssec do dmz-lab.

11 de julho de 2019

• Avaliação automatizada para contêineres CentOS6, correção para problema de memória do firefox, suporte a argumentos arbitrários de docker create no arquivo start.config.

6 de junho de 2019

• Introduzir uma base Centos6, mas ainda sem suporte para avaliação automatizada

23 de maio de 2019

• Avaliação automatizada de setuid-env falhou devido a erros de digitação nos separadores de campo.

8 de maio de 2019

• Correções ao manual do laboratório Capabilities

2 de maio de 2019

• Correção no laboratório Acl para permissões de bobstuff.txt. Usar chmod explícito no fixlocal.sh
• Revisar guia do aluno para esclarecer uso de stop e opção -r no corpo do manual.

9 de março de 2019

• A função checkwork estava reutilizando contêineres, impedindo assim que os alunos eliminassem artefatos de trabalhos anteriores do laboratório.
• Adicionar apêndice ao laboratório symkey para descrever o formato de imagem BMP.

22 de fevereiro de 2019

• O servidor http falhou ao iniciar nos laboratórios vpn e vpn2. Avaliação automatizada removida desses laboratórios até que sejam reformulados.

7 de janeiro de 2019

• Corrigir avaliação automatizada do gdblesson para pelo menos ser operacional.

27 de janeiro de 2019

• Corrigir manual do laboratório para routing-basics2 e corrigir roteamento para permitir acesso externo ao servidor web interno.

29 de dezembro de 2018

• Corrigir routing-basics2, mesmos problemas do routing-basics, além de um endereço IP incorreto no resolv.conf do gateway

5 de dezembro de 2018

• Corrigir laboratório routing-basics, a resolução DNS nos componentes isp e gateway estava quebrada.

14 de novembro de 2018

• Remover /run/nologin da máquina de arquivo no backups2 -- precisa de solução geral para este problema nologin

5 de novembro de 2018

• Alterar aid.conf padrão do laboratório file-integrity para rastrear mudanças de metadados em vez de horários de modificação de arquivos

22 de outubro de 2018

• Resolução verydodgy.com do laboratório macs-hash falhou ao reiniciar o laboratório
• Função Notify falhou se notify_cb.sh estiver faltando

12 de outubro de 2018

• Definir ulimit no tamanho do arquivo, limitar a 1G

10 de outubro de 2018

• Forçar coleta de arquivos parametrizados
• Incluir explicitamente leafpad e ghex na linha de base centos-xtra e reconstruir imagens dependentes.

28 de setembro de 2018

• Corrigir modos de acesso de arquivo compartilhado no laboratório ACL
• Esclarecer pergunta no pass-crack
• Modificar coleta de artefatos para ignorar arquivos mais antigos que o início do laboratório.
• Adicionar laboratório de algoritmos de computação quântica

12 de setembro de 2018

• Corrigir erros de sintaxe na avaliação do setuid-env
• Corrigir erro de sintaxe nas regras de firewall de exemplo do iptables2
• Reconstruir laboratórios centos, mover derivados lamp para usar lamp.xtr para waitparam e forçar httpd a esperar que isso termine.

7 de setembro de 2018

• Adicionar CyberCIEGE como um laboratório
• Exibição de informações read_pre.txt antes da puxada de imagens, e chance de desistir.

5 de setembro de 2018

• Restaurar processamento de download em massa sakai para a função gradelab.
• Remover scripts de instrutor não utilizados.

4 de setembro de 2018

• Permitir múltiplos endereços IP por interface de rede
• Adicionar imagem base para Wine
• Adicionar simulação virtual ICS GRFICS

23 de agosto de 2018

• Adicionar laboratório GrassMarlin (descoberta de rede ICS)

23 de agosto de 2018

• Adicionar laboratório GrassMarlin (descoberta de rede ICS)

21 de agosto de 2018

• Outra correção em torno de problemas de autenticação AWS (DockerHub usa AWS).
• Corrigir new_lab_setup.py para usar git em vez de svn.
• Dividir laboratório plc-forensics em um laboratório básico e um laboratório avançado (plc-forensics-adv)

17 de agosto de 2018

• Transição para git e GitHub como repositório autoritativo.

15 de agosto de 2018

• Modificar avaliação do laboratório plc-forensics para ser mais geral; revisar manual do laboratório para refletir wireshark no Labtainer.

15 de agosto de 2018

• Adicionar comando 'checkwork' permitindo que alunos visualizem resultados de avaliação automatizada para seu trabalho no laboratório.
• Incluir registro de descartes de pacotes iptables nos laboratórios iptables2 e iptables-ics.
• Remover instâncias obsoletas de is_true e is_false do goal.config
• Corrigir avaliação booleana para lidar com 'NOT foo', esperava mais operandos.

9 de agosto de 2018

• Suportar substituição de parâmetros em arquivos results.config
• Adicionar tipo de resultado TIME_DELIM para results.config
• Reformular o laboratório iptables, remover comandos nmap ocultos, introduzir serviço personalizado

7 de agosto de 2018

• Adicionar link ao guia do aluno no diretório labtainer-student
• Adicionar link ao guia do aluno em desktops VM
• Correções no iptables-ics para evitar longo atraso no desligamento; e correções em testes de regressão
• Adicionar nota aos guias sugerindo que o aluno use o navegador da VM para transferir arquivo zip de artefato ao instrutor.

1 de agosto de 2018

• Usar uma imagem Docker genérica para avaliação automatizada; parar de criar imagens 'instructor' por laboratório.

30 de julho de 2018

• Documentar necessidade de desbloquear o waitparam.service (criando diretório flag) se um script fixlocal.sh iniciar um serviço para o qual waitparam é um pré-requisito.
• Adicionar laboratório plc-app para exercício de firewall de aplicação PLC e lista de permissões.

25 de julho de 2018

• Adicionar operador string_contains ao processamento de objetivos
• Modificar avaliação do laboratório formatstring para considerar que o segredo vazado nem sempre está no final da string exibida.

24 de julho de 2018

• Adicionar laboratório SSH Agent (ssh-agent)

20 de julho de 2018

• Suportar build offline, opcionalmente pular todas as puxadas de imagem
• Restaurar restauração de repositórios apt/yum nos templates Dockerfile.
• Lidar com redirecionamentos de URL da recuperação de blob do registro Docker para evitar erros de autenticação (Não confiar em curl --location).

12 de julho de 2018

• Adicionar recurso prestop para permitir execução de scripts especificados pelo designer em componentes selecionados antes do desligamento do laboratório.
• Corrigir nomeação de host no laboratório ssl, estava quebrando a avaliação automatizada.
• Corrigir estado inicial do dmz-lab para permitir resoluções DNS da rede interna.
• O processamento FILE\REGEX não estava lidando corretamente com buscas de várias linhas.
• Versão do framework derivada de imagens recém-reconstruídas tinha valor padrão incorreto.

10 de julho de 2018

• Adicionar um laboratório LDAP
• Completar transição para imagens Ubuntu baseadas em systemd, remover arquivos não utilizados
• Mover arquivo tar lab_sys para diretório tmp por contêiner para concorrência.

6 de julho de 2018

• Todas as imagens base Ubuntu substituídas por versões baseadas em systemd
• Imagens de contêiner Labtainer no registro agora são marcadas com ID da imagem base e têm rótulos refletindo a imagem base.
• Uma determinada instalação puxará e usará imagens que são consistentes com as imagens base que possui.
• Se você está usando uma imagem VM, talvez queira substituí-la por uma imagem VM mais recente do nosso site.
• Novos laboratórios não serão executados sem baixar imagens base mais recentes; o que pode levar sua VM a armazenar múltiplas versões de imagens base grandes (> 500 MB cada).
• Estava perdendo artefatos de processos que estavam em execução quando o laboratório foi parado -- não estava matando corretamente processos capinout.

27 de junho de 2018

• Adicionar suporte para imagens Ubuntu systemd
• Remover cópia antiga de SimLab.py de labtainer-student/bin
• Mover fontes apt e yum para /var/tmp
• Esclarecer diferenças entre uso de 'boolean' e 'count_greater' em avaliações
• Estender Add-HOST no start.config para incluir todos os componentes em uma rede.
• Adicionar opção ao new_lab_setup.py para adicionar um contêiner baseado em uma cópia de um contêiner existente.

21 de junho de 2018

• Definir env DISPLAY para root
• Correção no tratamento de dependência de build da saída de status svn
• Adicionar laboratório radius
• Bug em append do SimLab corrigido
• Usar svn, quando apropriado, para alterar nomes de arquivos com new_lab_setup.py

19 de junho de 2018

• Manter ordem dos contêineres definida em start.conf ao criar terminal com múltiplas abas
• Esclarecer manual do designer para identificar caminho para arquivos de configuração de avaliação.
• Remover solicitação para instrutor fornecer email
• Verificação de erro mal feita ao testar número de versão
• Incluir timestamps de inícios e refações de laboratório no json de avaliação
• Adicionar um laboratório SSL que inclui autenticação bidirecional e criação de certificados.

14 de junho de 2018

• Adicionar diagnósticos à parametrização, rastrear por que algumas instalações parecem falhar nisso.
• Se um contêiner já está criado, garantir que esteja parametrizado, caso contrário sair para evitar contêineres corrompidos ou mal feitos.
• Corrigir número de versão do programa para usar svn HEAD

15 de junho de 2018

• Converter instruções de texto simples que apareciam em xterms em arquivo pdf.
• Corrigir bug no tratamento de versão de imagens que ainda não foram puxadas.
• Detectar ocorrência de um contêiner que foi criado, mas não parametrizado, e solicitar ao usuário que reinicie o laboratório com a opção '-r'.
• Adicionar utilitário do designer: rm_svn.py para que arquivos removidos acionem uma reconstrução de imagem.

13 de junho de 2018

• Instalar xterm em sistemas Ubuntu 18
• Contornar quebras em novas versões do tratamento de abas do gnome-terminal

11 de junho de 2018

• Adicionar verificação de versão para comparar imagens com o framework.
• Esclarecer vários manuais de laboratório

2 de junho de 2018

• Ao instalar no Ubuntu 18, usar docker.io em vez de docker-ce
• O capinout causou uma falha quando um comando monitorado 'sudo su' é seguido por um comando de usuário não elevado.
• Mover configurações de roteamento e resolv.conf para /etc/rc.local em vez de fixlocal.sh para que persistam entre início/parada dos contêineres.

31 de maio de 2018

• Contornar bug do Docker que causou quebra de texto em um terminal sem alimentação de linha.
• Estender COMMAND_COUNT para considerar pipes
• Criar nova versão do laboratório backups que inclui backups para um servidor remoto e faz backup de uma partição inteira.
• Alterar instruções do sshlab para usar o utilitário ssh-copy-id
• Excluir arquivo /run/nologin do parameterize.sh para permitir login ssh no CentOS

30 de maio de 2018

• Estendido new_lab_setup.py para permitir identificação da imagem base a ser usada
• Criar nova versão de centos-log que inclui registro centralizado.
• Validação de avaliação não estava aceitando opção 'time_not_during'.
• Começar a integrar Labtainer Master para gerenciar Labtainers a partir de um contêiner Docker.

25 de maio de 2018

• Remover sleeps de 10 segundos de vários serviços. Estava atrasando respostas xinetd, quebrando testes automatizados.
• Corrigir avaliação do laboratório snort para exigir apenas 'CONFIDENTIAL' no alarme. Remover arquivos não utilizados do laboratório.
• Horários de término de programa não eram registrados se o programa estava em execução quando o laboratório foi parado.

21 de maio de 2018

• Corrigir avaliação retlibc para remover objetivo duplicado, estava falhando avaliação automatizada
• Remover cópias de mynotify.py de laboratórios individuais e template de laboratório, já faz parte de lab_sys/sbin, mas não havia sido atualizado para refletir correções feitas para o laboratório acl.

18 de maio de 2018

• Mascarar mensagem de sinal de exec_wrap para que a mensagem de erro segv pareça correta.
• O capinout às vezes perdia stdout, verificar stdout do comando na morte do cmd.
• Corrigir avaliação de formatstring para capturar mensagem de falha de segmentação.
• Adicionar recurso type_function ao SimLab para digitar stdout de um script (veja formatstring simlab).
• Remover limitação do SimLab em combinar aspas simples/duplas.
• Adicionar diretiva window_wait ao SimLab para pausar até que janela com determinado título possa ser encontrada.
• Modificar laboratório plc para alterar títulos no terminal do mundo físico para refletir status, isso também torna o teste mais fácil.
• Corrigir link do manual do laboratório bufoverflow.

15 de maio de 2018

• Adicionar apêndice sobre uso da ferramenta SimLab para simular desempenho do usuário em laboratórios para teste de regressão e desenvolvimento de laboratórios.
• Adicionar função wait_net ao SimLab para pausar até que conexões de rede selecionadas terminem.
• Alterar avaliação automatizada do acl para usar FILE_REGEX para correspondência de várias linhas.
• Teste SimLab para laboratório xsite.

11 de maio de 2018

• Adicionar arquivo 'noskip' para forçar coleta de arquivos encontrados em home.tar, necessário para recuperar Firefox places.sqlite.
• Mesclar banco de dados sqlite com buffer write ahead antes de extrair.
• Correções ao manual do laboratório para symkeylab
• Adições de avaliação para symkeylab e pubkey
• Melhorias na ferramenta simlab: suporte include, corrigir nomeação de janela.

9 de maio de 2018

• Corrigir parametrização do laboratório file-deletion. Corrigir erro em seu manual do laboratório.
• Substituir uso de shell=True em scripts python para reduzir processos e permitir rastreamento de PIDs
• Limpar manuais para backups, pass-crack e macs-hash.

8 de maio de 2018

• Lidar com condição de corrida para evitar que gnome-terminal execute seu comando docker antes que um terminal de instrução xterm execute seu comando.
• Não exibir erros quando instrutor parar um laboratório iniciado com '-d'.
• Alterar avaliação de nmap-ssh para refletir melhor a intenção do laboratório.
• Várias correções de documentos e scripts sugeridas por olberger no github.

7 de maio de 2018

• Usar programa capinout baseado em C em vez do antigo capinout.sh para capturar stdin e stdout. Veja trunk/src-tool/capinout. Remove limitações associadas ao uso de ctrl-C para interromper programas monitorados e a exibição de senhas em telnet e ssh.
• Incluir suporte para processamento de zip bulk_download do sakai para extrair relatórios submetidos separadamente e resumir submissões faltantes.
• Adicionar verificações ao email fornecido pelo usuário para garantir que sejam caracteres imprimíveis.
• Ao avaliar, se o email fornecido pelo usuário não corresponder ao nome do arquivo zip, proceder com a avaliação dos resultados, mas incluir nota na tabela refletindo trapaça. Exigir recuperação de casos onde o aluno insere lixo para um endereço de email.
• Alterar avaliação do telnetlab para não olhar a saída tcpdump para senhas -- correção capinout leva à transmissão correta caractere por caractere ao servidor.
• Corrigir erro de digitação em install-docker.sh e usar sudo para alterar configuração dns do docker nesse script.

26 de abril de 2018

• Transição para uso de 'labtainer' para iniciar laboratório e 'stoplab' para pará-lo.
• Adicionar opção --version ao comando labtainer.
• Adicionar tipos de resultado log_ts e log_range, e operadores de objetivo time_not_during. Reformular a avaliação de centos-log e sys-log para usar esses recursos.
• Colocar labsys.tar em /var/tmp em vez de /tmp, às vezes era deletado antes de ser expandido
• Executar aplicações X como root falha após reinicialização da VM.
• Adicionar páginas de manual 'User Command' a laboratórios baseados em CentOS
• Corrigir bug recente que impedia coleta de arquivos docs de alunos
• Modificar smoke-tests para comparar apenas linha de resultado específica do aluno, sem espaços em branco20 de abril de 2018
• O serviço denyhosts falha ao iniciar na primeira vez, movido o início para student_startup.sh.
• Mover todos os serviços faux_init para depois da parametrização -- o rsyslog estava falhando ao iniciar na segunda inicialização do contêiner. 19 de abril de 2018
• O laboratório acl falhou ao avaliar corretamente o desempenho da etapa do cavalo de troia.
• Coletar documentos do aluno por padrão.
• O laboratório denyhost foi alterado para refletir que o denyhosts (ou tcp wrappers?) agora modifica o iptables. Além disso, o serviço denyhosts estava falhando ao iniciar em algumas ocasiões.
• Ao atualizar o Labtainers, não sobrescrever arquivos que são mais recentes do que os do arquivo -- preservar os relatórios de laboratório dos alunos.

12 de abril de 2018

• Adicionar documentação para o propósito dos objetivos do laboratório e exibir isso para o instrutor quando o instrutor iniciar um laboratório.
• Corrigir o uso da função precheck quando o programa está em treataslocal, passar o caminho completo do programa para o capintout.sh.
• Copiar arquivos instr_config em tempo de execução em vez de durante a construção da imagem.
• Adicionar seção do Guia do Designer sobre depuração de avaliação automatizada.
• Maiúsculas/minúsculas incorretas nos nomes dos arquivos de relatório de laboratório.
• A função chown desnecessária fazia com que o instructor.py às vezes travasse.
• Suporte para teste automatizado de laboratórios (veja SimLab e smoketest).
• Mover testsets e distrib para dentro de trunk

5 de abril de 2018

• Revisar o perfil do Firefox para remover a mensagem "você não usa o Firefox há algum tempo...".
• Remover pulls desnecessários do registro -- obter datas das imagens via API do Docker Hub.

28 de março de 2018

• Usar tar explícito em vez de "docker cp" para arquivos do sistema (o Docker não segue links.)
• Corrigir o laboratório de backups para usar sistema de arquivos separado e atualizar o manual.

26 de março de 2018

• Suporte para modos multiusuário (veja o Guia do Usuário do Lab Designer).
• Removida dependência de construção dos arquivos lab_bin e lab_sys. Eles agora são copiados durante a parametrização do laboratório.
• Mover capinout.sh para /sbin para que possa ser encontrado ao executar como root.

21 de março de 2018

• Adicionar CLONE para permitir múltiplas instâncias do mesmo contêiner, por exemplo, para laboratórios compartilhados por vários alunos simultâneos.
• Adaptar o laboratório kali-test para fornecer exemplo de macvlan e CLONE
• Copiar o script capinout.sh para /sbin para que o root possa encontrá-lo após um sudo su.

15 de março de 2018

• Suportar redes macvlan para comunicações com hosts externos
• Adicionar uma base Kali Linux e uma imagem Metasploitable 2 (veja kali-test)

8 de março de 2018

• Não exigir labname ao usar stop.py
• Capturar erros causados por redes perdidas e aconselhar o usuário sobre uma correção
• Adicionar suporte para uso de repositórios apt e yum locais na NPS

21 de fevereiro de 2018

• Adicionar dmz-lab
• Alterar "checklocal" para "precheck", refletindo que ele é executado antes do comando.
• Desacoplar o relatório de eventos inotify do uso de precheck.sh, permitir que as listas de eventos inotify incluam nome de arquivo de saída opcional.
• Estender o hook bash para operações de root, limpar o bash_history.
• Permitir parametrização de campos start.config, por exemplo, para endereços IP aleatórios
• Suportar monitoramento de serviços iniciados via systemctl ou /etc/init.d
• Introduzir qualificadores de delimitadores de tempo para organizar um arquivo de log com timestamp em intervalos delimitados por alguma mudança de configuração de interesse (veja dmz-lab)

5 de fevereiro de 2018

• Valores booleanos de arquivos results.config agora são tratados como valores de objetivo
• Adicionar suporte a expressões regulares para identificar resultados de artefatos.
• Suporte para registros Docker alternativos, incluindo um registro de teste local para testes
• Correções diversas em laboratórios e manuais de laboratório
• O hook de monitoramento capinout não estava matando processos filhos na saída.
• Matar processos monitorados antes de coletar artefatos
• Adicionar labtainer.wireshark como contêiner base, limpar dockerfiles

30 de janeiro de 2018

• Adicionar laboratório snort
• Integrar timestamps de arquivos de log, por exemplo, de syslogs, em resultados com timestamp.
• Remover valores de resultado indefinidos de arquivos de resultado json intermediários com timestamp.
• Alterar a operação de avaliação de objetivo time_during para associar timestamps ao valor de objetivo resultante.

24 de janeiro de 2018

• O uso de janelas com abas fez com que o lado do instrutor falhasse, uso de aspas duplas.
• Ignorar arquivos em diretórios _tar (que não sejam .tar) ao determinar dependências de construção.