diario-commandline-client

• O que é isto?
• Premissas
• Instalação
• Configuração do projeto
• Uso

O que é isto?

Um repositório de utilitários criado para facilitar o consumo da API diario em massa. Atualmente, estas funções estão totalmente implementadas:

• Carregar um arquivo (PDF ou documento do Microsoft Office)
• Carregar um diretório completo de arquivos
• Consultar um único hash
• Consultar uma lista de hashes (a partir de um único arquivo)

Como obtenho uma conta DIARIO

Envie um email para [email protected]

Aviso e Isenção de Responsabilidade

Embora o DIARIO seja suposto carregar apenas uma parte do documento para os nossos servidores—para que você possa ter a certeza de que a sua privacidade é preservada (mais informações: https://diario.elevenpaths.com) — este script carrega o documento inteiro porque se assume que será usado para análises de malware. Se desejar carregar um lote de documentos e manter a sua privacidade ao carregar apenas uma parte, use o nosso cliente Windows/Linux/Mac com interface gráfica. Está disponível em https://diario.elevenpaths.com

Premissas

• Você está usando Python 3.x
• Você tem virtualenv e virtualenvwrapper instalados e funcionando.

Instalação

cd diario-commandline-client
mkvirtualenv -p `which python3` diario-commandline-client
pip install -r requirements.txt

Configuração do Projeto

Certifique-se de que o virtualenv está ativado; se não estiver, execute workon diario-bulk.

Primeiro, você precisará criar um cliente de API no portal de administração do diario; ao fazê-lo, será gerado um app_id e um secret. Aconselhamos que use variáveis de ambiente para armazenar essas informações, API_CLIENT_APP_ID e API_CLIENT_SECRET, respectivamente.

Pode fazê-lo usando os hooks do virtualenv postactivate e predeactivate, localizados em 'bin' dentro da sua pasta virtualenv. Se tiver o virtualenv ativado, pode mover-se para a sua pasta virtualenv usando cdvirtualenv.

	# This hook is sourced after this virtualenv is activated.
	export API_CLIENT_APP_ID=XXXXXXXX
	export API_CLIENT_SECRET=XXXXXXXX

	# This hook is sourced before this virtualenv is deactivated.
	unset API_CLIENT_APP_ID
	unset API_CLIENT_SECRET

Se preferir não usar as variáveis de ambiente recomendadas, pode passar tanto o app_id como o secret como argumentos ao script. Os argumentos do script terão precedência sobre quaisquer variáveis de ambiente encontradas.

Uso

• Obtenha ajuda sobre o uso dos scripts:

Lembre-se: onde for indicado, o manipulador de protocolo é obrigatório (https://)

upload.py -h

gethash.py -h

• Carregar um único documento (não é necessário indicar o tipo de arquivo):

./upload.py -f <path_to_file>

• Carregar um diretório (novamente, não é necessário indicar o tipo de arquivo):

./upload.py -d <path_to_directory>

• Consultar um único hash:

./gethash.py --hash <hash>

• Consultar vários hashes a partir de um arquivo de índice (novamente, não é necessário indicar o tipo de arquivo):

./gethash.py -f <file_with_hashes>

• Consultar vários hashes e salvar os resultados em um arquivo em vez do stdout

./gethash.py -f <file_with_hashes> -l <logfile>

• Fornecendo o app_id e o secret do diario como argumentos (funciona em qualquer script). Vejamos um exemplo de upload

./upload.py -s <diario_secret> -a <diario_client_id> -d <path_to_directory>

Os argumentos para arquivos e pastas podem ser caminhos relativos ou absolutos