思科ThreatGrid提交示例API ...如何发送示例文件?

时间:2019-04-03 19:04:36

标签: java rest cisco

我无法使用Java成功调用ThreatGrid提交示例API。过去,我曾经使用Java来调用API,所以我有设置这些调用的经验。

我应该发布到https://panacea.threatgrid.com/api/v2/samples,并在请求的正文中提供参数。

我还需要将示例文件(正在评估的文件)写入请求的正文中。

我知道我需要将“ Content-Type”设置为“ multipart / form-data;”并提供一个边界字符串来分隔请求的各个部分。

调用提交API时,我收到一个HTTP 400错误请求,并返回以下错误:

{"api_version":2,"id":7162013,"error":{"message":"The parameter sample is required. ","code":400,"errors":[{"code":400,"message":"The parameter sample is required. ","help":"/doc/main/index.html","report":"support@threatgrid.com"}]}}

这是说我没有提供“样本”参数。样本是要提交进行威胁评估的文件。请注意,我在请求正文中发送的第二部分(数据部分)被命名为“样本”。

这是我在连接中设置请求标头的方式:

    connection.addRequestProperty("Content-Type", "multipart/form-data; boundary=BOUNDARY");
    connection.addRequestProperty("cache-control", "no-cache");
    connection.addRequestProperty("accept", "*/*");
    connection.addRequestProperty("Content-Length", "164784" );
    connection.addRequestProperty("Host", "panacea.threatgrid.com");

这是我认为我正在写的连接输出流示例:

--BOUNDARY

Content-Disposition: form-data; name="application/json"
{"private":"true","vm":"win7-x64","email_notification":false}

--BOUNDARY

Content-Disposition: form-data; name="sample"; filename="GracePeriod.pdf"
Content-Type: application/pdf

[Bytes of the Sample File being submitted to ThreatGrid api]

--BOUNDARY--

构建我的请求正文的代码:

        String boundaryString = "BOUNDARY";
        String LINE_FEED = "\r\n";
        File sampleFileToUpload = new File(fileUrl);

        outputStream.writeBytes(LINE_FEED);
        outputStream.writeBytes(LINE_FEED);
        outputStream.writeBytes("--" + boundaryString); 
        outputStream.writeBytes(LINE_FEED);
        outputStream.writeBytes(LINE_FEED);

        outputStream.writeBytes("Content-Disposition: form-data; name=\"application/json\""); 
        outputStream.writeBytes(LINE_FEED);

        //  Build the parameters that get placed into the Header
        Map<String, Object> headers = new HashMap<String, Object>();
        headers.put("private", "true");
        headers.put("vm", "win7-x64");
        headers.put("email_notification", false);   
        Gson gson = new Gson();
        String body = gson.toJson(headers);

        outputStream.writeBytes( body );
        outputStream.writeBytes(LINE_FEED);
        outputStream.writeBytes(LINE_FEED);

        outputStream.writeBytes("--" + boundaryString);
        outputStream.writeBytes(LINE_FEED);
        outputStream.writeBytes(LINE_FEED);
        outputStream.writeBytes("Content-Disposition: form-data; name='sample'; filename='"+sampleFileToUpload.getName()+"'");
        outputStream.writeBytes(LINE_FEED);        
        outputStream.writeBytes("Content-Type: application/pdf");
        outputStream.writeBytes(LINE_FEED);
        outputStream.writeBytes(LINE_FEED);


        //  Write the contents of the file being submitted...
        FileInputStream inputStream  = new FileInputStream(sampleFileToUpload);
        ByteArrayOutputStream buffer = new ByteArrayOutputStream();     
        int nRead;
        byte[] dataArray = new byte[16384];         
        while ((nRead = inputStream.read(dataArray, 0, dataArray.length)) != -1) {
            buffer.write(dataArray, 0, nRead);
        }       
        buffer.flush();
        byte[] bytes  = buffer.toByteArray();           
        inputStream.close();

        outputStream.write(bytes);

        outputStream.writeBytes(LINE_FEED);
        outputStream.writeBytes(LINE_FEED);

        outputStream.writeBytes("--" + boundaryString + "--");
        outputStream.writeBytes(LINE_FEED);
        outputStream.writeBytes(LINE_FEED);

        outputStream.flush();
        outputStream.close();

我应该收到HTTP 200消息和包含有关提交详细信息的响应消息。

希望有人曾经这样做过,可以用我的方式向我显示错误。

谢谢!

编辑:我忘了提及我可以使用Postman应用程序来设置并成功调用此API。我将请求主体中的“私有”,“ vm”,“ email_notification”和“样本”项设置为表单数据。 Postman允许您将这些项目设置为文本或文件(有一个下拉列表)。对于“样本”,我将其设置为文件,邮递员允许我“附加”文件。我使用Postman控制台查看请求中发送的内容,并尝试在Java代码中尽可能地模拟它。我还需要其他细节,使Postman不在控制台中显示我。

1 个答案:

答案 0 :(得分:0)

我终于能够(稍微流血)使API成功响应(HTTP 200消息)。如果将来可以帮助任何人,我将提供使其工作的详细信息。

在查看API的定义时,它指出“请求参数将被编码为'multipart / form-data'”。我将某些参数作为JSON数据发送。我决定我需要将每个参数作为一个单独的表单变量发送,每个参数都由一个边界标记分隔(我曾经尝试过,但是回到了相同的想法)。

这样做之后,我开始关注Request正文中每个项目之后的空格(CRLF)的细节。该API对主体中数据的格式非常敏感。我发现在发送表单数据的实际值之前,它需要一个CRLF。

以下是我发送请求正文的示例:

--BOUNDARY
Content-Disposition: form-data; name="private"
[CRLF (a space)]
true
--BOUNDARY
Content-Disposition: form-data; name="vm"
[CRLF (a space)]
win7-x64
--BOUNDARY
Content-Disposition: form-data; name="email_notification"
[CRLF (a space)]
false
--BOUNDARY
Content-Disposition: form-data; name="sample"; 
filename="CourseCompletionCertificate.pdf"
Content-Type: application/pdf
[CRLF (a space)]
[data stream of the Sample file in a byte array...]
--BOUNDARY--

我找到了multipart / form-data的示例,并且注意到数据中使用了CRLF,我尽力复制了数据的发送方式。正是在细节之后,API才成功响应。