Forward Logs from Cortex Data Lake to an HTTPS Server

Learn how to forward logs from Cortex Data Lake to an HTTPS server.
To meet your long-term storage, reporting and monitoring, or legal and compliance needs, you can configure Cortex Data Lake to forward logs to an HTTPS server or to services that receive events through HTTPS, such as Splunk HTTP Event Collector (HEC).
For successful log transmission to an HTTPS receiver, ensure that the receiver
  • Accepts and parses JSON. Cortex Data Lake forwards logs through HTTPS in JSON format. For more information about HTTPS log format, see the Log Forwarding Schema Reference.
  • Accepts and decompresses GZIP HTTPS payloads. Cortex Data Lake compresses the JSON data using GZIP when forwarding through HTTPS.
  • Accepts a batch size of 500 logs, or 2.25 MB (500 logs x 4500B/log = 2.25MB).
For each instance of Cortex Data Lake, you can forward logs to ten destinations.
The communication between Cortex Data Lake and the HTTPS receiver uses TLS, and upon connection Cortex Data Lake validates that the HTTPS server has a certificate signed by a trusted root CA. To complete the TLS handshake and establish the connection, the HTTPS receiver must present all the certificates from the chain of trust.
Cortex Data Lake does not support self-signed certificates.
  1. Enable communication between Cortex Data Lake and your HTTPS receiver. 
    Ensure that your HTTPS receiver can connect to Cortex Data Lake and can present a valid certificate to complete the connection request.
    • Allow an inbound TLS feed to your HTTPS receiver from the following IP address ranges:
      United States - Americas
      34.67.106.64/28
      Netherlands - Europe
      34.90.138.80/28
      United Kingdom
      35.246.51.240/28
      SG (Singapore)
      34.87.142.80/28
      CA (Canada)
      34.95.59.80/28
      JP (Japan)
      34.84.94.80/28
      AU (Australia)
      35.244.108.240/28
      United States - Government
      34.87.142.80/28
      If you have allowed specific IP addresses for inbound traffic, you must also allow the above IP address ranges to forward logs to your HTTPS receiver.
    • Obtain a certificate from a well-known, public CA, and install it on your HTTPS receiver.
      Because Cortex Data Lake validates the server certificate to establish a connection,
      you must verify that the HTTPS receiver is configured to properly send the complete certificate trust chain to Cortex Data Lake. If the app cannot verify that the certificate of the receiver and all CAs in the chain are trustworthy, the connection cannot be established. See the list of trusted certificates.
  2. Sign In
    to the hub at https://apps.paloaltonetworks.com/.
  3. Select the Cortex Data Lake instance that you want to configure for HTTPS forwarding.
    If you have multiple Cortex Data Lake instances, click the Cortex Data Lake tile and select an instance from the list of those available.
  4. Select
    Log Forwarding
    Add
    to add a new HTTPS forwarding profile.
  5. Enter a descriptive
    Name
    for the profile.
  6. Enter the
    URL
    for the HTTPS receiver.
    The URL entered must begin with
    https
    . At the end of the top-level domain, you can specify a port number. If no port is specified, the default is 443.
  7. (
    Optional
    ) Enable Client Authentication.
    Do this if you are forwarding logs to Splunk HEC, or if your HTTPS receiver requires a username and password.
    1. If you are forwarding logs to HEC, leave Splunk Basic Authentication selected and enter your HEC token.
    2. If you are configuring client authentication for an HTTPS server, select Basic Authentication and specify a username and password.
  8. Test Connection
    to ensure that Cortex Data Lake can communicate with the receiver.
    This sends an empty log to the configured destination to verify that transmission is possible. If the test fails, you will not be able to proceed.
  9. Click
    Next
    .
  10. In STATUS NOTIFICATION, enter an email address where you will be notified of any changes in log transmission status, such as if log forwarding stops.
  11. Enter a unique PROFILE TOKEN if your receiver needs to distinguish logs coming from different tenants.
  12. Select the logs you want to forward.
    1. Add
      a new log filter.
    2. Select the log type.
      The Threat log type does not include URL logs or Data logs. If you wish to forward these log types, you must add them individually.
    3. (Optional)
      Create a log filter to forward only the logs that are most critical to you.
      You can either write your own queries from scratch or use the query builder. You can also select the query field to choose from among a set of common predefined queries.
      Log filters function like queries in Explore. However, double quotes (
      “”
      ) are not supported.
      If you want to forward all logs of the type you selected, do not enter a query. Instead, proceed to the next step.
    4. Save
      your changes.
  13. Save
    your changes.
  14. Verify that the
    Status
    of your HTTPS forwarding profile is
    Running
    ( ).
    Immediately after creating or editing your profile, the
    Status
    may be
    Provisioning
    for up to 10 minutes.
  15. Verify that you can view logs on the HTTPS receiver.
    For Splunk Common Information Model (CIM) fields and Enterprise Security, follow the guide at https://splunk.paloaltonetworks.com to install the PANW Splunk Addon and create a Splunk HEC input.

Recommended For You