APIドキュメントの移動
API ドキュメントはdocs.recordedfuture.comでご覧いただけます。最新のドキュメントにアクセスするには、新しいサイトをブックマークしてください。
プロファイルを使用すると、送信されたサンプルに合わせて分析タスクをカスタマイズできます。
プロフィールは、企業によって管理されているユーザーのみが利用できます。
プロファイルオブジェクト
{// The unique ID of this profile."id":"237d939c-2f66-4021-af7c-62a70e796f24",// A human readable name. The name should be unique."name":"myprofile",// The set of tags that is used to match this profile to samples."tags":["windows7","office"],// Below are the options that are used in sample submissions.// The type of networking that should be used when running the sample.// Currently supported values are:// * "": The system default// * "drop": Disable networking.// * "internet": Allow connections to the internet.// * "tor": Route internet through the Tor network.// * "sim200": InetSim-like functionality with HTTP 200 responses.// * "sim404": InetSim-like functionality with HTTP 404 responses.// * "simnx": InetSim-like functionality with DNS NXDOMAIN responses."network":"internet",// The duraton of the analysis in seconds."timeout":120}GET /profiles
会社が保有するすべてのプロファイルを一覧表示します。
例
curl -H '認証: Bearer<YOUR_ACCESS_KEY> ' \
https://sandbox.recordedfuture.com/api/v0/profiles/<PROFILE_ID>
POST /profiles
新しいプロファイルを作成します。
リクエスト本体は、ID を省略したプロファイル オブジェクトである必要があります。
例
curl -H '認証: Bearer <YOUR_ACCESS_KEY>' \
-X ポスト \
-d ' {"name":"foo","tags":["foo","bar"],"timeout":120,"network":"internet"} ' \
https://sandbox.recordedfuture.com/api/v0/profiles
エラー
-
409, "PROFILE_ALREADY_EXISTS"、指定された名前のプロファイルがすでに存在する場合。
/profiles/ {profileID}を取得する
ID または名前で単一のプロファイルを取得します。
エラー
-
指定された ID または名前のプロファイルが存在しない場合は
404, "NOT_FOUND"。
/profiles/ {profileID}を配置する
指定された ID または名前でプロファイルを更新します。保存されたプロファイルは上書きされるため、送信されたプロファイルには ID を除くすべてのフィールドが含まれていることが重要です。
他のプロファイルに新しい名前が付いていない限り、プロファイルの名前を変更することは許可されます。これにより、古い名前を使用した今後のプロフィールのリクエストも無効になります。このようなリクエストが中断されるのを防ぐには、代わりに ID を使用します。
例
curl -H '認証: Bearer<YOUR_ACCESS_KEY> ' \
-X PUT \
-d ' '{"name":"foo","tags":["bar"],"timeout":120} \
https://sandbox.recordedfuture.com/api/v0/profiles/<PROFILE_ID>
エラー
-
指定された ID または名前のプロファイルが存在しない場合は
404, "NOT_FOUND"。 -
409, "PROFILE_ALREADY_EXISTS"、すでに使用されている名前を更新しようとした場合。
/profiles/ {profileID}を削除
ID または名前でプロファイルを削除します。
例
curl -H '認証: Bearer <YOUR_ACCESS_KEY>' \
-X 削除 https://sandbox.recordedfuture.com/api/v0/profiles/<PROFILE_ID>
エラー
-
指定された ID または名前のプロファイルが存在しない場合は
404, "NOT_FOUND"。