
Analisa extrações forenses de iOS e iPadOS em relatórios HTML, TSV, timeline, KML e LAVA com descoberta modular de artefatos e suporte a backups criptografados do iTunes.

O iLEAPP analisa extrações forenses de iOS e iPadOS e produz saída em HTML, TSV, timeline, KML e LAVA. Ele suporta iOS/iPadOS 11 até as versões atuais.
Navegue pela lista completa e pesquisável de artefatos em leapps.org/artifacts (filtre por ferramenta LEAPP).
Baixe uma versão pré-compilada — não é necessária instalação do Python.
| Plataforma | Download |
|---|---|
| Windows (Intel/AMD) | iLEAPP-*-windows-x64-portable.zip |
| Windows (ARM) | iLEAPP-*-windows-arm64-portable.zip |
| macOS (Apple Silicon) | iLEAPP-*-macos-arm64.dmg |
| macOS (Intel) | iLEAPP-*-macos-x64.dmg |
| Linux (Intel/AMD) | iLEAPP-*-linux-x64.AppImage |
| Linux (ARM) | iLEAPP-*-linux-arm64.AppImage |
Cada download contém um único programa, ileapp. O arquivo SHA256SUMS.txt em cada versão permite verificar um download.
Compatibilidade com Linux: Os AppImages oficiais são compilados no Ubuntu 22.04 e exigem glibc 2.35 ou mais recente.
GUI — abra o iLEAPP da forma habitual: clicando duas vezes em ileapp.exe a partir do zip no
Windows, em iLEAPP na pasta Applications no macOS, ou no AppImage no Linux. Iniciado sem argumentos, ele abre a janela; selecione o tipo de entrada,
o caminho de origem, a pasta de saída e os módulos a processar.
CLI — passe argumentos para ileapp em um terminal e ele será executado como linha de comando. A
pasta de saída já deve existir. No Windows, use ileapp.exe a partir do zip.
ileapp.exe -t zip -i C:\path\to\extraction.zip -o C:\path\to\output\
No Linux, execute o AppImage com os mesmos argumentos. No macOS, ele fica dentro do app; para
digitar apenas ileapp em um terminal, crie um link para ele no seu PATH uma vez:
sudo ln -s /Applications/iLEAPP.app/Contents/MacOS/ileapp /usr/local/bin/ileapp
| Tipo | Descrição |
|---|---|
fs | Pasta de arquivos extraídos com caminhos e nomes normais |
zip | Arquivo ZIP contendo arquivos com nomes normais |
tar | Arquivo TAR, simples ou comprimido com xz (.tar.xz) |
gz | Arquivo comprimido com GZIP |
itunes | Pasta de backup do iTunes/Finder com caminhos e nomes com hash |
file | Entrada de arquivo único |
Backups criptografados do iTunes/Finder (-t itunes) são suportados. A GUI solicitará uma senha antes do processamento quando a criptografia for detectada. Na CLI, passe a senha com --itunes_password (consulte Opções opcionais de análise abaixo).
Estas opções aplicam-se apenas à CLI (ileapp / ileapp.exe com argumentos, ou python ileapp.py). A GUI (ileapp iniciado sem argumentos, ou python ileappGUI.py) expõe as mesmas configurações através da sua interface em vez de flags de linha de comando.
Execute ileapp --help (ou python ileapp.py --help a partir do código-fonte) para consultar a referência integrada.
Estes três argumentos são obrigatórios para uma execução de análise normal:
| Argumento | Forma longa | Descrição |
|---|---|---|
-t | Tipo de entrada: fs, tar, zip, gz, itunes ou file | |
-i | --input_path | Caminho para o arquivo ou pasta de entrada |
-o | --output_path | Caminho para a pasta de saída (deve já existir) |
Exemplo:
ileapp -t zip -i /path/to/extraction.zip -o /path/to/output/
| Argumento | Forma longa | Descrição |
|---|---|---|
-w | --wrap_text | Passe esta flag para desativar a quebra de texto nos arquivos de saída |
-m | --load_profile | Caminho para um arquivo de perfil do iLEAPP (.ilprofile) para limitar quais módulos são executados |
-d | --load_case_data | Caminho para um arquivo de dados de caso do LEAPP (.lcasedata) |
--custom_output_folder | Nome personalizado para a subpasta de saída do relatório | |
--custom_artifacts_path | Pasta extra de onde carregar módulos de artefatos (por exemplo, scripts/alternate_artifacts) | |
--html_row_limit | Número de linhas acima do qual a tabela de um artefato é omitida de sua página HTML, que então aponta para o banco de dados LAVA e para a exportação TSV. Padrão 50000; 0 grava todas as tabelas. A GUI usa o padrão | |
--itunes_password |
Estes modos não analisam um caso. Use-os sozinhos — sem -t, -i ou -o:
| Argumento | Forma longa | Descrição |
|---|---|---|
-p | --artifact_paths | Grava todos os caminhos de busca de artefatos em path_list.txt no diretório atual |
-c | --create_profile_casedata | Assistente interativo para criar um arquivo .ilprofile ou .lcasedata na pasta informada |
Exemplos:
ileapp -p
ileapp -c /path/to/output/folder/
Os módulos de artefatos ficam em scripts/artifacts/ e são carregados dinamicamente em tempo de execução.
Novos módulos: comece com o guia passo a passo em How to Write an iLEAPP Module.
Referências adicionais:
Um PR que adiciona ou altera um artefato é mais fácil de revisar e mesclar quando chega com
duas coisas: um pequeno fixture de teste extraído de uma extração real, e valores de sample_data que
registram o que o módulo produziu. Scripts geram ambos. Aqui está todo o fluxo.
Uma regra antes de qualquer coisa: tudo o que você commitar aqui se torna público. Use apenas dados que você tem permissão para compartilhar, como um dispositivo de teste que você mesmo populou, uma imagem de pesquisa pública, ou um arquivo que você sanitizou manualmente. Nunca use dados de casos reais.
1. Extraia um fixture da sua extração
python admin/test/scripts/make_test_data.py <module> --case 1 --input <extraction.zip>
Isso extrai os arquivos correspondidos pelos padrões de paths do seu módulo a partir da extração e grava
o arquivo de caso admin/test/cases/testdata.<module>.json mais um pequeno zip por artefato
em admin/test/cases/data/<module>/.
Regras de tamanho: menos de 10 MB por zip, faça o commit junto com o PR. Entre 10 e 25 MB, faça o commit do arquivo de caso e anexe o zip a um comentário do PR. Maior que isso, informe no PR e um mantenedor organizará uma transferência.
2. Registre a saída esperada
TZ=UTC python admin/test/scripts/test_module.py <module> -a all -c all
Isso executa o módulo contra o fixture e grava um snapshot da saída em
admin/test/results/<module>/. Faça commit do snapshot também. Ele se torna a linha de base que
protege o módulo após o merge. Mantenha a parte TZ=UTC: os snapshots commitados estão em UTC
e a CI é executada em UTC.