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 HEC format. Cortex Data Lake forwards individual logs through HTTPS in JSON format, but the complete payload (stacked JSON log messages) is in HEC format. Example:
    { "time": 1437522387, "host": "stream-logfwd20-141065047-01261326-z3ho-harness-8gmw", "source": "Palo Alto Networks FLS LF", "event": { "LogType": "THREAT", "Severity": "Critical", ... } } { "time": 1437522387, "host": "stream-logfwd20-141065047-01261326-z3ho-harness-8gmw", "source": "Palo Alto Networks FLS LF", "event": { "LogType": "THREAT", "Severity": "Info", ... } }
    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.
Cortex Data Lake communicates with the receiver using TLS, and upon connection Cortex Data Lake validates that the receiver has a certificate signed by a trusted root CA or a private CA. To complete the TLS handshake and establish the connection, the receiver must present all the certificates from the chain of trust.
  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 either a certificate from a well-known, public CA or a self-signed certificate and install it on your receiver. Please make sure that if you are using a certificate signed by a private CA, it contains CRL or OCSP information needed for certificate revocation checks.
      Because Cortex Data Lake validates the server certificate to establish a connection, you must verify that the receiver is configured to properly send the TLS certificate 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. (
    Optional
    )
    Upload
    the private Root CA and intermediate CAs (If an intermediate CA exists). Do not upload the certificate issued for the syslog server—only CA certificates are needed to verify the chain from the syslog server.
    Only do this if you installed a private CA-signed or self-signed certificate on your receiver. The file containing the certificates must be in PEM format.
  10. Click
    Next
    .
  11. 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.
  12. Enter a unique PROFILE TOKEN if your receiver needs to distinguish logs coming from different tenants.
  13. 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.
  14. Save
    your changes.
  15. 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.
  16. 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