diario-commandline-client

• Cos'è questo?
• Prerequisiti
• Installazione
• Configurazione del progetto
• Utilizzo

Cos'è questo?

Un repository di utility creato per semplificare il consumo dell'API diario in batch. Attualmente queste funzioni sono completamente implementate:

• Caricare un file (PDF o documento Microsoft Office)
• Caricare una directory completa di file
• Interrogare un singolo hash
• Interrogare un elenco di hash (da un singolo file)

Come ottengo un account DIARIO

Scrivi un'email a [email protected]

Avvertenza e Dichiarazione di non responsabilità

Sebbene DIARIO sia pensato per caricare solo una parte del documento sui nostri server—così puoi essere certo che la tua privacy sia preservata (maggiori informazioni: https://diario.elevenpaths.com) — questo script carica l'intero documento perché si presuppone che venga utilizzato per analisi malware. Se desideri caricare un lotto di documenti e mantenere la tua privacy caricando solo una parte di esso, utilizza il nostro client Windows/Linux/Mac con interfaccia utente. È disponibile su https://diario.elevenpaths.com

Prerequisiti

• Stai usando Python 3.x
• Hai virtualenv e virtualenvwrapper installati e funzionanti.

Installazione

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

Configurazione del progetto

Assicurati che il virtualenv sia attivato; se non lo è, esegui workon diario-bulk.

Per prima cosa dovrai creare un client API dal portale di amministrazione di diario; in questo modo verranno generati un app_id e un secret. Ti consigliamo di utilizzare variabili d'ambiente per memorizzare queste informazioni, rispettivamente API_CLIENT_APP_ID e API_CLIENT_SECRET.

Puoi farlo utilizzando gli hook di virtualenv postactivate e predeactivate situati in 'bin' all'interno della tua cartella virtualenv. Se hai il virtualenv attivato, puoi spostarti nella tua cartella 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 preferisci non utilizzare le variabili d'ambiente consigliate, puoi passare sia app_id che secret come argomenti allo script. Gli argomenti passati allo script avranno precedenza su qualsiasi variabile d'ambiente trovata.

Utilizzo

• Ottieni aiuto sull'utilizzo degli script:

Ricorda: dove è indicato , il protocollo è obbligatorio (https://)

upload.py -h

gethash.py -h

• Carica un singolo documento (non è necessario indicare il tipo di file):

./upload.py -f <path_to_file>

• Carica una directory (anche qui, non è necessario indicare il tipo di file):

./upload.py -d <path_to_directory>

• Interroga un singolo hash:

./gethash.py --hash <hash>

• Interroga più hash da un file indice (anche qui, non è necessario indicare il tipo di file):

./gethash.py -f <file_with_hashes>

• Interroga più hash e salva i risultati in un file invece che su stdout

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

• Fornisci app_id e secret di diario come argomenti (funziona su qualsiasi script). Vediamo un esempio di upload

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

Gli argomenti per file e cartelle possono essere percorsi relativi o assoluti