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 resource requires the same authentication mechanism as for other inbound REST messagesREST 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 is set to the name of the vulnerability integration. The attachmentFileName parameter is set to a string to be used as the file.

An attachment is 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 names the attachment internally. When the attachment is generated, a new vulnerability integration run is 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