Skip to main content
Skyhigh Security

Create a Report with the REST API

You can use the REST API that is provided to create a report that includes data on processing web requests.

1.  Log on to the REST API.

      To log on, you must provide a URL that differs depending on the product you are using to process web requests and on the country or region where
      you log on.

  •      Under Security Service Edge, use a URL that includes msg.mcafee-cloud as the domain name with a country or region code prefixed.
         
         For example:

         https://us.msg.mcafee-cloud.com/mwg/api/reporting/forensic/<customer ID>

         Use these country and region codes: 

         ae  — United Arab Emirates   
         de  — Europe
         gb  — United Kingdom
         sg  — Singapore
         us  — North America
        
  •      Under Secure Web Gateway Cloud Service (Secure WGCS), use a URL that includes msg.mcafeesaas.com as the domain name.

2.   Enter a command to download data for your report. Use an HTTP client tool for this, such as curl or wget. Include the required parameters and
      optional parameters as needed. Important required parameters are:

  • Version header — Determines the data fields that are downloaded, for example, user_id, source_ip, or http_action

    For a list of all available version headers with their data fields, see Reporting Fields.

  • Timestamp filters — Specify the time range during which data is downloaded

    For more information about these filters, see Reporting Filters and Reporting Timestamp.

A complete download command looks like this:

curl --insecure --verbose --header 'Accept: text/csv' --header 'x-mwg-api-version: 3' --compressed
--user <user name>:<password> https://msg.mcafeesaas.com/mwg/api/reporting/forensic/12345678
?filter.requestTimestampFrom=1527279524&filter.requestTimestampTo=1527283124&order.0.requestTimestamp=asc

For more information about this command and the output it returns, see Reporting Example

When the report has been run, you can review the downloaded data and analyze them.

  • Was this article helpful?