About pushing data to a vulnerability integration using a REST API

You can use a REST endpoint to push data to a vulnerability integration.

The REST resource at /api/sn_vul/vulnerability_integration_svc has been exposed to accept input data from an external system to be passed to a vulnerability integration. This requires the same authentication mechanism for other inbound REST messages. Only users with the sn_vul.vulnerability_admin role can issue requests to /api/sn_vul/vulnerability_integration_svc. The query parameters accepted by this resource are integrationName and attachmentFileName. The integrationName parameter should be set to the name of the vulnerability integration. The attachmentFileName parameter should be set to a string to be used as the file.

An attachment will be generated with the request body being used as the attachment contents. The Content-type header that is sent with the request is used to determine the content type of the request body. The attachmentFileName parameter will name the attachment internally. When the attachment is generated, a new vulnerability integration run will be created based on the integrationName provided.

The details of the REST call to make to the vulnerability integration endpoint are:
  • HTTP Method: POST
  • HTTP Query Params:
    • attachmentFileName={name of file to be created as attachment}
    • integrationName={name of the integration to use}
  • Supported Content Types: application/json,application/xml,text/xml,text/plain