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.

  • For North America:
    https://us.msg.mcafeesaas.com/mwg/ap...ting/forensic/<customer ID>

  • For Europe:
    https://eu.msg.mcafeesaas.com/mwg/ap...ting/forensic/<customer ID>
    
    Provide the customer ID here that you received when you purchased the product, but leave out the initial c before the string of numbers,
    for example, 1234567. 

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.