Projeto Tyr

Projeto Tyr

Apresentação

Tyr é uma coleção de ferramentas para exploração de ameaças de vulnerabilidades.

Por que o nome Tyr?

Tyr é um deus viking que supervisiona a segurança de outros deuses vikings. A ideia desse supervisor para os outros me deu a ideia de chamar este projeto de: Tyr.

O que é o Tyr?

Tyr é uma coleção de soluções para ajudar o usuário final a explorar dados de vulnerabilidades e ameaças associadas. Para alcançar esses objetivos, o Tyr oferece várias listas de palavras-chave com uso especializado para explorar os seguintes dados:

Dados do NVD, como CVE enriquecidos pelo NVD, comentários de fornecedores de CVE, CPE e CpeMatch,
Dados do Mitre como CWE, CAPEC, Att&ck,
Cisa kev.

O que o Tyr faz?

O Tyr oferece a possibilidade de explorar e comparar esses dados. Eles podem ser usados em seus próprios scripts shell. As seguintes plataformas são suportadas:

macOS,
Windows,
Debian like,
Rocky like.

Para sistemas operacionais Debian e Rocky like, é possível explorar a lista de CVEs corrigidos para cada pacote instalado.

Essas ferramentas são acessíveis pela linha de comando com sua ajuda integrada para plataformas Windows, ou man para plataformas Linux e macOS.

Todos os dados são coletados no diretório .tyr armazenado em seu diretório home. Todos os arquivos de origem coletados do NVD, Mitre e Cisa são salvos em seu diretório .tyr/downloads.

Todos os bancos de dados locais são armazenados no diretório .tyr/db. Após o download e a importação dos dados, você pode trabalhar com todos esses dados no modo offline.

NOTA: todos os dados coletados são armazenados em alguns bancos de dados sqlite.

O que é necessário para usar o Tyr

Para todos

Para todo tipo de usuário, não é necessário instalar outros recursos além do próprio toolchain do rust.

Para a instalação, você tem as opções abaixo dependendo do seu sistema operacional:

OS	Comando	Comentário
not windows	`curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs sh`	Não válido na plataforma windows
debian like	`sudo apt install rustup`	-
rocky like	`sudo dnf install rustup`	-
macOS/Linux	`brew install rustup`	Gerenciador de pacotes Homebrew
windows	`scoop install rustup`	Para usuários Windows, você deverá instalar o MSVC Runtime que encontrará no site da Microsoft, caso ainda não esteja instalado.

Após a instalação, execute:

rustup default stable

rust update

Para desenvolvedor

Você precisará instalar o comando git primeiro.

Depois disso, crie um diretório de trabalho para o projeto Tyr e clone-o:

git clone https://gitlab.com/cyberactivity/tyr.git

Vá para o diretório tyr e execute os seguintes comandos:

cargo build --release

Copie o executável baldur para o seu $HOME/.cargo/bin:

Para usuários não Windows: cp target/release/baldur $HOME/.cargo/bin
Para usuários Windows: copy target\release\baldur.exe %USERPROFILE%\.cargo\bin

Execute o comando de implantação com o seu cargo: cargo run --release

NOTA: este comando é um comando de implantação próprio do projeto tyr que é executado por padrão.

Recomenda-se encerrar o seu ambiente de shell e abrir um novo, já que algumas configurações de PATH foram atualizadas pelo comando de implantação.

Todos os comandos disponíveis são armazenados no seu diretório .tyr/bin dentro do seu diretório home local.

Se você quiser ajuda sobre um comando, tente:

<command> help para usuários Windows ou man <command> para outros usuários.

Para administrador de sistemas

Instale o toolchain do rust e clone o repositório do projeto Tyr conforme explicado para os usuários desenvolvedores.

Vá para o diretório tyr e execute os seguintes comandos para gerar o pacote de instalação debian.

cargo clean

cargo deb --profile release

O pacote de instalação foi gerado, por exemplo, como: target/debian/baldur_0.0.1-1_arm64.deb.

Os seguintes comandos geram um pacote de instalação rpm:

cargo clean

cargo build --release

cargo generate-rpm -p src/baldur --profile release

O pacote de instalação foi gerado, por exemplo, como: target/generate-rpm/baldur-0.0.1-1.aarch64.rpm

Para instalação em windows/macOS, siga o mesmo procedimento de um desenvolvedor. Não há processos de instalação específicos para esses sistemas operacionais no momento.

NOTA: após a instalação do pacote, o usuário final que deseja os recursos de palavras-chave do tyr fará:

um git clone para clonar o projeto tyr,
a partir do diretório tyr executará o comando: deploy.

Para usuário final

Sem pacote Linux instalado

Após um processo de instalação explicado acima, abra uma interface de linha de comando e execute os seguintes comandos:

git clone https://gitlab.com/cyberactivity/tyr.git

Vá para o diretório tyr e execute: deploy.

O diretório .tyr é criado no seu $HOME.

Com pacote Linux instalado

A partir da sua sessão de usuário, abra um console de linha de comando e execute: deploy.

O diretório .tyr é criado no seu $HOME.

Processo comum após a instalação

Abra uma nova interface de linha de comando e execute os seguintes comandos:

Para baixar todas as fontes de dados: download
Para importar todos os arquivos baixados: data.import

Você está pronto. Para mostrar todos os contextos existentes, execute: contexts Para mostrar a lista de palavras-chave de um contexto, execute: keywords para o contexto padrão, ou keyword <context> para um contexto específico.

O futuro do Tyr

Muitos recursos estão aguardando implementação ou estão em andamento, como:

Tyr

Mais Populares