diario-commandline-client

• Qu'est-ce que c'est ?
• Hypothèses
• Installation
• Configuration du projet
• Utilisation

Qu'est-ce que c'est ?

Un dépôt utilitaire créé pour faciliter la consommation en masse de l'API diario. Actuellement, ces fonctions sont entièrement implémentées :

• Téléverser un fichier (PDF ou document Microsoft Office)
• Téléverser un répertoire complet de fichiers
• Interroger un hash unique
• Interroger une liste de hashs (à partir d'un seul fichier)

Comment obtenir un compte DIARIO

Écrivez un e-mail à [email protected]

Avertissement et clause de non-responsabilité

Bien que DIARIO soit censé téléverser uniquement une partie du document sur nos serveurs—afin que vous puissiez être certain que votre vie privée est préservée (plus d'informations : https://diario.elevenpaths.com) — ce script téléverse le document entier car il est supposé qu'il sera utilisé pour des analyses de logiciels malveillants. Si vous souhaitez téléverser un lot de documents et préserver votre vie privée en ne téléversant qu'une partie, veuillez utiliser notre client Windows/Linux/Mac avec une interface utilisateur. Il est disponible à l'adresse https://diario.elevenpaths.com

Hypothèses

• Vous utilisez Python 3.x
• Vous avez virtualenv et virtualenvwrapper installés et fonctionnels.

Installation

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

Configuration du projet

Assurez-vous que l'environnement virtuel est activé ; si ce n'est pas le cas, exécutez workon diario-bulk.

Vous devrez d'abord créer un client API à partir du portail d'administration diario, ce qui générera un app_id et un secret. Nous vous conseillons d'utiliser des variables d'environnement pour stocker ces informations, API_CLIENT_APP_ID et API_CLIENT_SECRET respectivement.

Vous pouvez le faire en utilisant les hooks virtualenv postactivate et predeactivate situés dans 'bin' à l'intérieur de votre dossier virtualenv. Si votre virtualenv est activé, vous pouvez vous déplacer vers votre dossier virtualenv en utilisant 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

Si vous préférez ne pas utiliser les variables d'environnement recommandées, vous pouvez passer à la fois app_id et secret comme arguments au script. Les arguments du script auront priorité sur toutes les variables d'environnement trouvées.

Utilisation

• Obtenez de l'aide sur l'utilisation des scripts :

Rappel : lorsque est indiqué, le gestionnaire de protocole est obligatoire (https://)

upload.py -h

gethash.py -h

• Téléverser un document unique (pas besoin d'indiquer le type de fichier) :

./upload.py -f <path_to_file>

• Téléverser un répertoire (encore une fois, pas besoin d'indiquer le type de fichier) :

./upload.py -d <path_to_directory>

• Interroger un hash unique :

./gethash.py --hash <hash>

• Interroger plusieurs hashs à partir d'un fichier index (encore une fois, pas besoin d'indiquer le type de fichier) :

./gethash.py -f <file_with_hashes>

• Interroger plusieurs hashs et stocker les résultats dans un fichier au lieu de stdout

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

• Fournir app_id et secret diario comme arguments (fonctionne sur n'importe quel script). Voyons un exemple de téléversement

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

Les arguments pour les fichiers et dossiers peuvent être des chemins relatifs ou des chemins absolus