Labtainers

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

Distribution created: 09/11/2026 11:33
Revision: v1.4.4n
Commit: 9f1012dc
Branch: master

Content

Distribution and Use

Guide to directories

Support

Release notes

Distribution and Use

Consulte as informações de licenciamento e distribuição no docs/license.md file.

Guide to directories

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

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

• labs -- Ficheiros específicos de cada um dos laboratórios

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

• docs -- código-fonte latex para o labdesigner.pdf, e outra documentação.

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

• headless-lite -- scripts para gerir o Docker Workstation e instâncias na cloud dos Labtainers (sistemas que não têm servidores X11 nativos.)

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

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

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

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

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

Support

Utilize os relatórios de problemas do GitHub, ou envie-me um email para [email protected]

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

Release notes

A distribuição padrão dos Labtainers não inclui os ficheiros 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, por isso pode querer terminar sessão/iniciar sessão, ou iniciar uma nova shell bash antes de utilizar os Labtainers pela primeira vez.

Jauary 6, 2026

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

December 30, 2025

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

October 15, 2025

• Laboratório packet-introspection revisto para atualizar a ligação para a base de dados de geolocalização maxmind e notar a utilização da base de dados legacy.

April 24, 2025

• Corrigido o imodule para criar corretamente os diretórios em falta, conforme o pull request #96

November 22, 2024

• Substituída a VM do google cloud, desta vez devido a uma falha do systemd dentro dos contentores.

September 23, 2024

• Substituída a VM do google cloud, que estava a usar a versão errada do Docker

September 10, 2024

• Gralha na criação do caminho do imodule

July 26, 2024

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

July 22, 2024

• Adicionado um contentor base para Ubuntu22 e alterações à estrutura para o suportar.

July 5, 2024

• Migração para Ubuntu 24 como VM appliance
• O pacote docker pyhton usa uma biblioteca http python avariada, requer downgrade do pacote.
• Utilizar ambiente python virtual para evitar o bloqueio de pacotes python do Ubuntu.
• Adicionar parâmetro de arranque para permitir a partilha de systemd entre contentores e a VM.
• Redirecionar mensagens de erro da ferramenta tar avariada nas atualizações.
• Quebra da atualização do Ubuntu para pacotes msc (ver update-ubuntu.sh) para VMs versão 18
• O comando docker-compose está avariado, use "docker compose"
• Forçar permissões de socket em labtainers headless.
• Atualizar os Labtainers headless para usar Ubuntu 24

November 27, 2023

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

September 18, 2023

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

August 8, 2023

• Lidar com a alteração ao formato json da imagem DockerHub. Obrigado Kees!

April 17, 2023

• Forçar a utilização da versão mais recente do laboratório, por exemplo, iptables2 em vez de iptables. Corrigir a conclusão com tab para mostrar apenas a mais recente. (Issue #77)
• A instalação do laboratório CyberCIEGE estava a falhar devido a uma condição de corrida do X11. (Issue #76)
• Nota no readme do CyberCIEGE para orientar os alunos a guardar os logs recolhidos no diretório $HOME. (Issue #75)
• O checkwork do laboratório Radius estava a reportar incorretamente "radiusd not running", faltava o script prestop. (Issue #74)
• O Labedit corrompia o ficheiro de configuração de arranque quando a opção MACVLAN_EXT era usada. (Issue #73)

February 1, 2023

• O histórico do Bash para utilizadores não predefinidos não estava a ser guardado. January 26, 2023
• Scripts powershell modificados para o gcloud usarem a zona selecionada para qualificar os nomes das VMs. January 4, 2023
• Os contentores que usavam systemd estavam a falhar no systemd mais recente presente no Ubuntu 22
• Adicionar parâmetro --zone aos scripts do google cloud, com valor derivado do script set_defaults. December 21, 2022
• Corrigir os critérios de resultados do xforge para não esperarem um pathname, e adicionar verificação para ver se foi emitido um POST para editar o perfil. E corrigir o servidor http do atacante para ser executado a partir do diretório home. December 19, 2022
• Adicionar laboratório strace para introduzir o rastreamento de chamadas de sistema.
• O valor de X11 DISPLAY estava incorreto se existissem múltiplos dispositivos no diretório /tmp/.X11-unix.
• A utilização de python/bash/sh/etc sem argumentos estava a fazer o capinout falhar. December 9, 2022
• Modificar o script de criação de VM Azure para usar uma imagem de VM Labtainer pré-construída da Azure Community Gallery.
• Os terminais em VMs na cloud falham por razões desconhecidas durante o arranque ou ao clicar com o botão direito no terminal. Tentar resolver através de start/stop de um terminal. December 5, 2022
• Ao recolher artefactos, incluir ficheiros modificados de diretórios de utilizadores não predefinidos, por exemplo, os seus históricos bash.
• Alterar a avaliação web para mostrar os novos ficheiros "other user".
• Incluir ficheiros de .local/bin em cada contentor nos artefactos. Destinado a torná-los disponíveis ao instrutor através da avaliação web.
• No laboratório ACL, incluir o ficheiro th /shared_data/bob/fun nos resultados para referência do instrutor.
• Apanhar a utilização de "sh" ou "bash" a partir da linha de comandos e ignorar ao analisar o comando dado, por exemplo, como feito com "time" ou "sudo".
• No laboratório tcpip, não era possível fazer ssh para o servidor durante sessões de laboratório subsequentes, o diretório /run/sshd não estava a ser recriado. November 16, 2022
• Corrigir o caminho para o Snort Manual no laboratório snort.
• No manual do ossec, corrigir o caminho para manage_agents October 12, 2022
• Google cloud remover o operador de background do comando gnome-terminal, ainda falha ao clicar com o botão direito mas parece estável após executar um newterm.sh. October 10, 2022
• Corrigir o newterm.sh do Google cloud; expandir esse disco de arranque para 30G. September 20, 2022
• Nota do id de utilizador e palavra-passe para o laboratório TCP/IP no manual do laboratório. August 30, 2022
• Usar o nome do socket X11 ao definir DISPLAY a partir do .profile de um contentor August 9, 2022
• Corrigir o nome da função processValueMax no grader. Issue #63

August 4, 2022

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

July 18, 2022

• A criação de contentores baseados em Ubuntu20 estava a falhar dentro de IModules. Issue #61.

March 23, 2022

• Corrigir o caminho para o diretório de lock do tap; estava a causar a falha de laboratórios que usam network taps
• Atualizar o computador netmon do plc-traffic para ter openjfx necessário para o novo grassmarlin no ambiente java
• Acelerar o arranque do laboratório evitando chown -R, que é muito lento no docker.
• Outra tentativa de evitar a eliminação da ligação X11 no diretório /tmp do contentor.
• Corrigir a contagem de sites visitados do webtrack e remover o objetivo live-headers, essa ferramenta já não está disponível. Clarificados alguns passos do manual do laboratório.

March 2, 2022

• Adicionar novo laboratório ssh-tunnel (obrigado GWD!)
• Corrigir a falha do labedit em refletir o valor X11 definido por new_lab_setup
• Adicionar opção para não parametrizar um contentor

February 23, 2022

• O labedit estava a corromper o start.config após a adição de novos contentores
• Caminho incorreto para o guia do aluno no ficheiro README do aluno; alterar dinamicamente para configurações de cloud
• Extensão incorreta para update-labtainer.sh
• Melhorias no guia Msc
• Atualizar o laboratório ghidra para incluir a versão 10.1.2 do Ghidra

February 15, 2022

• Reverter o suporte da cloud Azure para provisionar por cada aluno. A Azure desencoraja a partilha de recursos.

January 24, 2022

• A cloud Azure agora usa uma imagem armazenada num blob do Azure em vez de provisionar por cada aluno.
• Adicionado suporte para Google Cloud.

January 19, 2022

• Introduzir os Labtainers na cloud Azure. Consulte o Student Guide para detalhes sobre como usar isto.

January 3, 2022

• Rever o laboratório setuid-env para adicionar melhor avaliação; testes simlab e evitar sighup no filho printenv.
• Corrigir a diretiva de contagem de objetivos de avaliação para excluir valores de etiquetas de resultado falsos.
• Não exigir labname ao usar gradelab -a com um grader iniciado com a opção debug.
• Rever o capinout (espelhamento stdin/stdout) para lidar com o orfanamento de processos filhos do comando, documentação melhorada e tratamento de erros.
• Adicionada a apresentação de barras de progresso das imagens docker a serem obtidas quando um laboratório é executado pela primeira vez.
• Feedback ao utilizador sobre o progresso da inicialização do contentor.
• O laboratório pcap-lib não tinha um ficheiro notify necessário para a avaliação automatizada; Remover passo supérfluo do Lab Manual.

November 23, 2021

• Desativar erros popup do ubuntu na VM de teste.
• Corrigir o tratamento de diferentes formatos da variável DISPLAY.

October 22, 2021

• Rever o guia do laboratório tcpip para notar que um ataque syn-flood bem-sucedido não é possível. Corrigir a sua avaliação automatizada e adicionar scripts SimLab.
• Alterar a extensão do ficheiro de artefacto de zip para lab, e adicionar um preâmbulo para confundir os gestores de ficheiros GUI. Os alunos estavam a abrir o zip e a submeter o seu conteúdo.
• Tornar a opção -r do gradelab a predefinição, adicionar uma opção -c para uso cumulativo do grader.
• Modificar o refresh_mirror para se referir à data de lançamento local para evitar consultas frequentes ao DockerHub. Cada uma dessas consultas conta como uma obtenção de imagem, e agora estão a tentar monetizar isso.

September 30, 2021

• Alterar o guia do laboratório bufoverflow e a classificação para não esperar sucesso com ASLR ativado, avaliar se foi executado.
• Tratamento de erros para o web grader nos casos em que o aluno não tem resultados.
• Imprimir aviso quando um laboratório obsoleto é executado.
• Alterar a classificação do formatstring para remover a descrição não utilizada "_leaked_secret" e clarificar o valor de leaked_no_scanf.
• Alterar também a classificação do formatstring para permitir qualquer nome para o executável vulnerável.

September 29, 2021

• Tratamento de erros do Gradelab, reduzir as instâncias de falhas devido a ficheiros zip inválidos.
• Limitar os ficheiros de artefacto stdout a 1MB

September 17, 2021

• O guia do laboratório Ghidra tinha um endereço IP errado, não foi refeito a partir do código-fonte.

September 14, 2021

• Laboratórios de exemplo para LDAP e Mariadb usando SSL. Destinados como modelos para novos laboratórios.
• Lidar com o formato de log do Mariadb
• Adicionar parâmetros por contentor para limitar o uso de CPU ou fixar o contentor a um conjunto de CPUs.
• Criação de Labpack agora disponível através de uma GUI (makepackui).
• Conclusão com tab para os comandos labtainer, labpack e gradelab.
• Novo laboratório de computação paralela ``parallel'' usando MPI.

August 3, 2021

• Adicionar uma opção de configuração "WAIT_FOR" para fazer com que um contentor atrase a parametrização até que outro contentor complete a sua parametrização.
• Suporte para formatos de log do Mariadb na análise de resultados
• Remover o suporte para utilização de Mac e Windows do Docker Desktop. Esse produto é demasiado instável para o suportarmos.
• Suprimir mensagens stderr quando o utilizador usa comandos bash incorporados como "which".
• Correções de bugs nos programas makepack/labpack.

July 19, 2021

• Adicionar um laboratório de DNS para introduzir o protocolo e a configuração de DNS.
• Imagem da appliance VirtualBox revista para iniciar com o script de atualização correto.
• Separar o parâmetro nameserver do resolv.conf do campo de configuração lab_gw para o seu próprio valor.
• O comando IModule falhava se fosse executado antes de qualquer laboratório ter sido iniciado.

July 5, 2021

• Erros na gestão da variável de ambiente DISPLAY quebravam as aplicações GUI no Docker Desktop.

July 1, 2021

• Suporte à instalação do pacote Mac dos Labtainers headless.
• A avaliação automatizada do laboratório routing-basics falhava devido à falta de ficheiros treataslocal
• Corrigir gralhas e endereços incorretos no laboratório routing-basics, e corrigir a avaliação automatizada.
• A avaliação do pcapanalysis estava a falhar.

June 10, 2021

• Todos os manuais de laboratório em PDF estão agora no repositório github
• Converter as instruções do vpnlab e vpnlab2 em manuais de laboratório em PDF.

May 25, 2021

• Adicionar palavras-chave pesquisáveis a cada laboratório. Consulte "labtainer -h" para a utilização.
• Expandir o laboratório routing-basics e o manual do laboratório
• Remover o laboratório routing-basics2, agora é redundante.
• O sudo em alguns contentores falhava porque os hostnames removem underscores, levando a uma incompatibilidade com o ficheiro hosts. Corrigir com uma entrada extra no ficheiro hosts com o nome do contentor sem underscore.
• Nova funcionalidade Labpack para empacotar uma coleção de laboratórios, e ferramenta makepack para criar Labpacks.
• Verificação de erros para o diretório /sbin ao usar ubuntu20 -- seria silenciosamente fatal.
• Novo laboratório network-basics

May 5, 2021

• Introduzir um novo laboratório users para introduzir a gestão de utilizadores/grupos
• Suprimir mensagens do Apparmor do host nos syslogs do contentor centos

April 28, 2021

• As novas imagens base2 não tinham man pages. Usado unminimize para as restaurar na imagem base.
• Introduzir um laboratório de IDS baseado em host OSSEC.

April 13, 2021

• O laboratório CyberCIEGE falhava porque o socket X11 não era relocalizado antes de iniciar o Wine via fixlocal.

April 9, 2021

• Novo laboratório tutorial gdb-cpp para usar o GDB num programa C++ simples.
• As exceções de vírgula flutuante estavam a revelar a utilização de exec_wrap.sh para espelhamento de stdin/stdout.

April 7, 2021

• O laboratório ldap falhava quando movido para Ubuntu 20. Problema rastreado até um problema com a cache nscd de pwd. Mover o ldap para Ubuntu 20

March 23, 2021

• A parametrização com RANDOM não incluía o limite superior.
• Adicionar parâmetro de passo opcional ao RANDOM, por exemplo, para garantir limites de palavras.
• Laboratório db-access: adicionar mysql-workbench ao computador de base de dados.
• Novo laboratório overrun para ilustrar referências de memória além dos limites das estruturas de dados c.
• Novo laboratório printf para introduzir as referências de memória feitas pela função printf.

March 19, 2021

• gradelab ignorar erro de makdirs, problema com rmtree do Windows em pastas partilhadas.
• gradelab lidar com espaços em nomes de ficheiros zip de alunos.
• gradelab lidar com nomes de ficheiros zip do Moodle, incluindo downloads de build.

March 12, 2021

• UI do labedit: Remover a imagem wireshark antiga da lista de imagens base.
• UI do labedit: Aumentar alguns tamanhos de letra.
• A interface web do grader falhava ao mostrar os manuais de laboratório se o nome do manual não seguir as convenções de nomenclatura.

March 11, 2021

• UI do labedit adicionar definição de registry no novo painel de configuração global do laboratório.

March 10, 2021

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

March 8, 2021

• Descontinuar a utilização de HOST_HOME_XFER, todos os laboratórios usam o diretório conforme o ficheiro labtainer.config.
• Adicionar comentário de documentação ao start.config para REGISTRY e BASE_REGISTRY

March 5, 2021

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

February 26, 2021

• O laboratório dmz-example tinha erros no encaminhamento e na configuração do dnsmasq em alguns componentes.

February 18, 2021

• A UI estava a reconstruir imagens porque estava a atualizar os tempos dos ficheiros sem motivo
• Limpar o código da UI para remover algumas cópias de dados redundantes.

February 14, 2021

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

February 11, 2021

• Corrigir o tratamento da UI para edição de ficheiros. Rever o layout e eliminar campos não utilizados.
• Adicionar configuração base ubuntu20 base2 juntamente com ssh2, network2 e wireshark2
• O novo wireshark resolve o problema das janelas pretas/com ruído.
• Mapear /tmp/.X11-unix para /var/tmp e criar uma ligação. Necessário para ubuntu20 (estava a eliminar /tmp?) e pode corrigir outros.

February 4, 2021

• Adicionar opção SIZE aos artefactos de resultados
• Simplificar a avaliação e parametrização do wireshark-intro e adicionar manual de laboratório em PDF.
• Fornecer valores da lista de parâmetros ao script pregrade.sh como variáveis de ambiente
• ativar X11 no grader
• colocar update-designer.sh no path dos utilizadores.

January 19, 2021

• Alterar a gestão da data/rev do README para atualizar o ficheiro no repositório de origem.
• Introduzir GUI para criar/editar laboratórios -- ver o comando labedit.

December 21, 2020

• A função gradelab falhava quando os ficheiros zip eram copiados de uma pasta partilhada do VirtualBox.
• Atualizar o Instructor Guide para descrever a gestão de ficheiros zip de alunos em computadores host.

December 4, 2020

• Transição da distribuição de tar para artefactos de release do GitHub
• Eliminar o ficheiro tar separado do designer, usar o tarball do repositório git.
• Testar as funções web do grader para análise de artefactos de laboratório dos alunos
• Limpar logs do smoketest completo e eliminar o contentor do grader no comando removelab.

December 1, 2020

• A avaliação do laboratório iptables2 dependia de portas aleatórias serem "unknown" para o nmap.
• Usar um diretório de sincronização para atrasar o início dos smoketests antes do arranque do laboratório.
• Começar a integrar elementos da UI do Lab designer.

October 13, 2020

• Configurações headless para executar no Docker Desktop em Macs & Windows
• Suporte a servidor headless, ficheiro cloud-config para implementações na cloud
• Suporte de testes para configurações headless
• Forçar o mynotify a esperar até o rc.local ser executado no arranque
• Melhorar a capacidade do serviço mynotify de fundir a saída num único timestamp
• Python3 para o script stopgrade
• O SimLab agora usa docker top em vez de system ps

September 26, 2020

• Limpar os scripts stoplab para ignorar contentores que não são de laboratório
• Adicionar laboratório de controlo de acesso a base de dados db-access para partilha controlada de uma base de dados mysql.

September 17, 2020

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

August 28, 2020

• Corrigir o script de instalação para usar python3-pip e corrigir scripts avariados: getinfo.py e pull-all.py
• A lógica do Registry estava avariada, os sistemas de teste não estavam a usar o registry de teste, adicionar documentação de desenvolvimento.
• Adicionar ficheiros base juiceshop e owasp para laboratórios de segurança web baseados em OWASP
• Remover sudos desnecessários do check_nets
• Adicionar diretiva de documentação CHECK_OK para avaliação automatizada
• Alterar o check_nets para corrigir problemas de iptables e encaminhamento se assim for indicado.

August 12, 2020

• Adicionar timeout aos scripts prestop
• Adicionar quiz e checkwork ao dmz-lab
• Reiniciar o dmz-lab sem a opção -r quebrava o encaminhamento para fora do ISP.
• Permitir múltiplos ficheiros para resultados time_delim.6 de agosto de 2020
• Bug no tratamento de erros quando o socket X11 está ausente
• Vírgulas nas perguntas do quiz causavam 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. Consulte 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 path do designer
• Correções e explicações no guia do designer para os passos 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 quando 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 bird-ospf Open Shortest Path First routing protocol.
• Melhorar o tratamento de alterações de DNS, o acesso externo de alguns contêineres estava bloqueado em alguns sites.
• Adicionar seção ao Instructor Guide sobre o uso do Labtainers em ambientes sem acesso à Internet.

21 de maio de 2020

• Mover todos os repositórios para o registro labtainers do Docker Hub
• Suportar mounts definidos no start.config para permitir instalações persistentes de software
• Alterar o laboratório ida para usar instalação persistente do IDA -- o 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 falhava na avaliação das condições CONTAINS e FILE_REGX quando wildcards eram usados para seleção de arquivos.
• Incluir dicas para usar o 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
• Outra limpeza para permitir reconstruções e testes usando Jenkins, incluindo o uso de diretórios temporários exclusivos para builds
• Mover funções de suporte de build de labutils para build.py
• Adicionar laboratório pcap-lib para desenvolvimento baseado na 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 a capacidade de adicionar contêineres "tap" para coletar PCAPs de redes selecionadas.
• Atualizar a documentação do GNS3 para acesso externo a contêineres e uso de dummy_hcd para simular unidades USB.
• Alterar o template kali para usar faux_init em vez de tentar usar systemd.
• Mover distribuições (arquivos tar) para box.com
• Alterar o uso de netstat no SimLab para não fazer lookup de 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 (por exemplo, VM) em vez de assumir :0

14 de fevereiro de 2020

• Adicionar exercício de introdução à engenharia reversa de software com Ghidra.

11 de fevereiro de 2020

• Atualizar os guias para descrever o acesso remoto a contêineres em ambientes GNS3
• Ocultar componentes e links selecionados dentro do GNS3.
• As 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, por exemplo, enviar arquivos.
• Adicionar função de ambiente GNS3 para simular a 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 em execução 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 por instrutores). Consulte docs/imodules.pdf.
• Corrigir a variável de ambiente LABTAINER_DIR quebrada dentro do update-labtainer
• Corrigir o modo de acesso do arquivo accounting.txt no laboratório ACL (havia se tornado rw-r-r). Usar chmod explícito no fixlocal.sh.

14 de janeiro de 2020

• Portar o framework e o gradelab para Python3 (laboratórios Python2 existentes não mudarão)
  • Usar opções de random.seed compatíveis com versões anteriores
  • Hackear 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 VM mais antigo que inclui python 3.5.2, que quebra a compatibilidade do random.seed).
  • Adicionar alias rebuild para rebuild.py que selecionará python2 se necessário.
• As manpages dos laboratórios baseados em Centos estavam falhando; usar mandb dentro do arquivo docker base
• A máscara de rede do dmz-lab para a rede DMZ estava errada (detectada 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
• O laboratório file-deletion deve ser concluído sem reiniciar a VM, observe isso no Lab Manual.
• Adicionar switch NO_GW ao start.config para desabilitar gateways padrão nos contêineres.
• Laboratório Metasploit, trava a VM host se executado como privilegiado; longos atrasos no su se systemd estiver habilitado; então executar sem systemd. Remover o uso de banco de dados do manual do laboratório, configurar para usar o novo switch 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 o uso de default_registry
• Revisar os procedimentos de controle de código-fonte para usar um registro de teste diferente para cada branch, e usar um branch premaster para testes finais de uma versão.

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 de laboratório sobre arquivos grandes; buscar arquivos bigexternal.txt

30 de setembro de 2019

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

20 de setembro de 2019

• A avaliação de onewayhash deve permitir operações hmac em arquivo escolhido pelo aluno.

5 de setembro de 2019

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

30 de agosto de 2019

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

29 de agosto de 2019

• Os pulls de imagens de laboratório do docker hub falharam devido a mudança no github ou curl? Capturar redirecionamento para cloudflare. Adição de suporte a GNS3. Correção no 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

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

8 de maio de 2019

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

2 de maio de 2019

• Correção do laboratório Acl para permissões de bobstuff.txt. Usar chmod explícito no fixlocal.sh
• Revisar o guia do aluno para esclarecer o uso de stop e da 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 de laboratório anteriores.
• 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é serem retrabalhados.

7 de janeiro de 2019

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

27 de janeiro de 2019

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

29 de dezembro de 2018

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

5 de dezembro de 2018

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

14 de novembro de 2018

• Remover /run/nologin da máquina de arquivo em backups2 -- é necessária uma solução geral para este problema de nologin

5 de novembro de 2018

• Alterar o aid.conf padrão do laboratório file-integrity para rastrear alterações de metadados em vez de tempos de modificação de arquivos

22 de outubro de 2018

• A resolução de verydodgy.com no laboratório macs-hash falhou na reinicialização do laboratório
• A função de notificação falhou se notify_cb.sh estiver ausente

12 de outubro de 2018

• Definir ulimit no tamanho do arquivo, limite para 1G

10 de outubro de 2018

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

7 de setembro de 2018

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

5 de setembro de 2018

• Restaurar o processamento de download em massa do 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 da AWS (o DockerHub usa AWS).
• Corrigir new_lab_setup.py para usar git em vez de svn.
• Dividir o 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 & GitHub como repositório autoritativo.

15 de agosto de 2018

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

15 de agosto de 2018

• Adicionar comando "checkwork" permitindo que os alunos visualizem os resultados da avaliação automatizada de seu trabalho de 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 a avaliação booleana para lidar com "NOT foo", ela 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
• Retrabalhar o laboratório iptables, remover comandos nmap ocultos, introduzir serviço personalizado

7 de agosto de 2018

• Adicionar link para o guia do aluno no diretório labtainer-student
• Adicionar link para o guia do aluno nas áreas de trabalho da VM
• Correções no iptables-ics para evitar longa demora no desligamento; e correções nos testes de regressão
• Adicionar nota aos guias sugerindo que o aluno use o navegador da VM para transferir o arquivo zip de artefatos para o 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 a necessidade de desbloquear o waitparam.service (criando o diretório flag) se um script fixlocal.sh for 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 whitelisting.

25 de julho de 2018

• Adicionar operador string_contains ao processamento de goals
• Modificar a 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 todo o pull de imagens
• Restaurar a restauração de repositório apt/yum nos templates Dockerfile.
• Tratar URLs de redirecionamento da recuperação de blob do registro Docker para evitar erros de autenticação (Não depender de curl --location).

12 de julho de 2018

• Adicionar recurso prestop para permitir a execução de scripts especificados pelo designer em componentes selecionados antes do desligamento do laboratório.
• Corrigir a nomenclatura do host no laboratório ssl, estava quebrando a avaliação automatizada.
• Corrigir o estado inicial do dmz-lab para permitir resoluções DNS da rede interna.
• O processamento de FILE\REGEX não estava tratando adequadamente buscas multilinha.
• A 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 a transição para imagens Ubuntu baseadas em systemd, remover arquivos não utilizados
• Mover o arquivo tar lab_sys para o 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
• As imagens de contêiner do Labtainer no registro agora são marcadas com o ID da imagem base e têm labels refletindo a imagem base.
• Uma determinada instalação fará pull e usará imagens consistentes com as imagens base que possui.
• Se você estiver usando uma imagem de VM, talvez queira substituí-la por uma imagem de 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 grandes imagens base (> 500 MB cada).
• Estava perdendo artefatos de processos que estavam em execução quando o laboratório foi interrompido -- não estava matando adequadamente os processos capinout.

27 de junho de 2018

• Adicionar suporte para imagens Ubuntu systemd
• Remover cópia antiga do SimLab.py de labtainer-student/bin
• Mover fontes apt e yum para /var/tmp
• Esclarecer diferenças entre o uso de "boolean" e "count_greater" nas 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 do svn status
• Adicionar laboratório radius
• Bug no append do SimLab corrigido
• Usar svn, quando apropriado, para alterar nomes de arquivos com new_lab_setup.py

19 de junho de 2018

• Manter a ordem dos contêineres definidos em start.conf ao criar terminal com múltiplas abas
• Esclarecer o manual do designer para identificar o caminho para os arquivos de configuração de avaliação.
• Remover prompt para o instrutor fornecer email
• Verificação de erros falha ao testar o número da versão
• Incluir timestamps de inícios de laboratório e refações 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á foi criado, certifique-se de que esteja parametrizado, caso contrário, aborte para evitar contêineres corrompidos ou incompletos.
• Corrigir o número da versão do programa para usar svn HEAD

15 de junho de 2018

• Converter instruções em texto simples que apareciam em xterms em arquivo pdf.
• Corrigir bug no tratamento de versão de imagens que ainda não foram baixadas.
• Detectar a 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 de designer: rm_svn.py para que arquivos removidos disparem uma reconstrução da imagem.

13 de junho de 2018

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

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 causava um crash quando um comando monitorado "sudo su" é seguido por um comando de usuário não elevado.
• Mover configurações de routing e resolv.conf para /etc/rc.local em vez de fixlocal.sh para que persistam entre start/stop dos contêineres.

31 de maio de 2018

• Contornar bug do Docker que causava quebra de texto em um terminal sem line feed.
• 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

• Estender new_lab_setup.py para permitir a identificação da imagem base a usar
• Criar nova versão do centos-log que inclui logging centralizado.
• A validação de avaliação não estava aceitando a opção "time_not_during".
• Começar a integrar o 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 do xinetd, quebrando testes automatizados.
• Corrigir a avaliação do laboratório snort para exigir apenas "CONFIDENTIAL" no alarme. Remover arquivos não utilizados do laboratório.
• Os horários de término do programa não eram registrados se o programa estivesse em execução quando o laboratório foi interrompido.

21 de maio de 2018

• Corrigir a avaliação do retlibc para remover goal duplicado, estava falhando na avaliação automatizada
• Remover cópias de mynotify.py de laboratórios individuais e do template de laboratório, ele 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 do exec_wrap para que a mensagem de erro segv pareça correta.
• O capinout às vezes estava perdendo stdout, verificar stdout do comando na morte do cmd.
• Corrigir a avaliação do formatstring para capturar mensagem de segmentation fault.
• Adicionar recurso type_function ao SimLab para digitar stdout de um script (veja formatstring simlab).
• Remover limitação do SimLab na combinação de aspas simples/duplas.
• Adicionar diretiva window_wait ao SimLab para pausar até que a janela com o título fornecido possa ser encontrada.
• Modificar o laboratório plc para alterar títulos no terminal do mundo físico para refletir o status, isso também facilita os testes.
• Corrigir link do manual do laboratório bufoverflow.

15 de maio de 2018

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

11 de maio de 2018

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

9 de maio de 2018

• Corrigir a parametrização do laboratório file-deletion. Corrigir erro em seu manual de laboratório.
• Substituir o 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

• Tratar condição de corrida para evitar que o gnome-terminal execute seu comando docker antes que um terminal de instrução xterm execute seu comando.
• Não exibir erros quando o instrutor interrompe um laboratório iniciado com "-d".
• Alterar a avaliação do nmap-ssh para refletir melhor a intenção do laboratório.
• Várias correções de documentação 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 saki para extrair relatórios enviados separadamente e resume envios ausentes.
• Adicionar verificações ao email fornecido pelo usuário para garantir que sejam caracteres imprimíveis.
• Durante a avaliação, se o email fornecido pelo usuário não corresponder ao nome do arquivo zip, prossiga para avaliar os resultados, mas inclua nota na tabela refletindo trapaça. Necessário para recuperar de casos em que o aluno insere lixo como endereço de email.
• Alterar a avaliação do telnetlab para não olhar a saída do tcpdump em busca de senhas -- a correção do capinout leva à transmissão correta caractere a caractere para o servidor.
• Corrigir erro de digitação em install-docker.sh e usar sudo para alterar a configuração de dns do docker nesse script.

26 de abril de 2018

• Transição para o uso de "labtainer" para iniciar o laboratório e "stoplab" para interrompê-lo.
• Adicionar opção --version ao comando labtainer.
• Adicionar tipos de resultado log_ts e log_range, e operadores de goal time_not_during. Reformular a avaliação do centos-log e sys-log para usar esses recursos.
• Colocar labsys.tar em /var/tmp em vez de /tmp, às vezes era excluído antes de ser expandido
• Executar aplicações X como root falha após reinicialização da VM.
• Adicionar man pages de "User Command" aos laboratórios baseados em CentOS
• Corrigir bug recente que impedia a coleta de arquivos de docs dos alunos
• Modificar smoke-tests para comparar apenas a 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, início movido para student_startup.sh.
• Mover todos os serviços faux_init para depois da parametrização -- o rsyslog estava falhando ao iniciar no segundo boot 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 dos alunos por padrão.
• O laboratório denyhost mudou para refletir que denyhosts (ou tcp wrappers?) agora modifica iptables. Além disso, o serviço denyhosts estava falhando ao iniciar em algumas ocasiões.
• Ao atualizar Labtainers, não sobrescrever arquivos 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 inicia um laboratório.
• Corrigir o uso da função precheck quando o programa está em treataslocal, passar capintout.sh o caminho completo do programa.
• Copiar arquivos instr_config em tempo de execução em vez de durante a construção da imagem.
• Adicionar seção do Designer Guide sobre depuração de avaliação automatizada.
• Caso incorreto nos nomes dos arquivos de relatório de laboratório.
• Função chown desnecessária fazia o instructor.py às vezes travar.
• Suporte para testes automatizados de laboratórios (ver SimLab e smoketest).
• Mover testsets e distrib para trunk

5 de abril de 2018

• Revisar o perfil do Firefox para remover a mensagem "you've not use firefox in a while...".
• Remover pulls desnecessários do registry -- obter datas das imagens via API do docker hub em vez disso.

28 de março de 2018

• Usar tar explícito em vez de "docker cp" para arquivos de sistema (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 (ver Lab Designer User Guide).
• Removida a dependência de build 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 múltiplos 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

• Suporte a redes macvlan para comunicações com hosts externos
• Adicionar uma base Kali linux, e uma imagem Metasploitable 2 (ver 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 no 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 listas de eventos inotify incluam nome de arquivo de saída opcional.
• Estender o hook bash para operações de root, limpar esse bash_history.
• Permitir parametrização de campos de start.config, por exemplo, para endereços IP aleatórios
• Suporte ao monitoramento de serviços iniciados via systemctl ou /etc/init.d
• Introduzir qualificadores de delimitador de tempo para organizar um arquivo de log com timestamp em intervalos delimitados por alguma mudança de configuração de interesse (ver 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 registries Docker alternativos, incluindo um registry 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 ao sair.
• Matar processos monitorados antes de coletar artefatos
• Adicionar labtainer.wireshark como um 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 json de resultado com timestamp intermediários.
• Alterar a operação de avaliação de objetivo time_during para associar timestamps com o valor de objetivo resultante.

24 de janeiro de 2018

• O uso de janelas com abas fazia o lado do instrutor falhar, uso de aspas duplas.
• Ignorar arquivos em diretórios _tar (exceto .tar) ao determinar dependências de build.