diario-commandline-client

• これは何ですか？
• 前提条件
• インストール
• プロジェクトのセットアップ
• 使用方法

これは何ですか？

一括 diario API 消費を容易にするために作成されたユーティリティリポジトリです。現在、以下の機能が完全に実装されています。

• ファイル（PDF または Microsoft Office ドキュメント）のアップロード
• ファイルの完全なディレクトリのアップロード
• 単一ハッシュのクエリ
• ハッシュのリストのクエリ（単一ファイルから）

DIARIO アカウントを取得するには

[email protected] にメールを送信してください

警告と免責事項

DIARIO はドキュメントの一部だけを当社のサーバーにアップロードすることになっているため、プライバシーが保護されることを確信できますが（詳細情報: https://diario.elevenpaths.com）、このスクリプトはマルウェア解析に使用されることを想定しているため、ドキュメント全体をアップロードします。 ドキュメントのバッチをアップロードし、その一部だけをアップロードしてプライバシーを保護したい場合は、ユーザーインターフェースを備えた Windows/Linux/Mac クライアントを使用してください。 https://diario.elevenpaths.com から入手できます。

前提条件

• Python 3.x を使用していること
• virtualenv と virtualenvwrapper がインストールされ、動作していること。

インストール

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

プロジェクトのセットアップ

virtualenv がアクティベートされていることを確認してください。されていない場合は、workon diario-bulk を実行してください。

まず、diario 管理ポータルから API クライアントを作成する必要があります。これにより、app_id と secret が生成されます。その情報を環境変数 API_CLIENT_APP_ID と API_CLIENT_SECRET にそれぞれ保存することをお勧めします。

virtualenv フォルダ内の 'bin' にある virtualenv フック postactivate と predeactivate を使用してこれを行うことができます。virtualenv がアクティベートされている場合は、cdvirtualenv を使用して virtualenv フォルダに移動できます。

	# 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

推奨される環境変数を使用したくない場合は、app_id と secret の両方をスクリプトの引数として渡すこともできます。スクリプトへの引数は、見つかった環境変数よりも優先されます。

使用方法

• スクリプトの使用法に関するヘルプを表示:

注意: が示されている場合は、プロトコルハンドラが必須です（https://）

upload.py -h

gethash.py -h

• 単一のドキュメントをアップロード（ファイルタイプを指定する必要はありません）:

./upload.py -f <path_to_file>

• ディレクトリをアップロード（これもファイルタイプを指定する必要はありません）:

./upload.py -d <path_to_directory>

• 単一のハッシュをクエリ:

./gethash.py --hash <hash>

• インデックスファイルから複数のハッシュをクエリ（これもファイルタイプを指定する必要はありません）:

./gethash.py -f <file_with_hashes>

• 複数のハッシュをクエリし、stdout の代わりにファイルに結果を保存:

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

• diario の app_id と secret を引数として指定（任意のスクリプトで動作）。アップロードの例を見てみましょう。

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

ファイルとフォルダへの引数は、相対パスでも絶対パスでも指定できます。