Configuring Cloudflare Connectors

This connector allows you to use the Cloudlfare Logpull API to ingest retained log files to the Stellar Cyber data lake.

For the available permissions for tokens and roles as they relate to logs, refer to Get started > Permissions.

This connector is improved to use less memory. Under certain scenarios if there is an error reaching the third-party API, some duplicate messages may be sent.

Connector Overview: Cloudflare

               Let us know if you find the above overview useful.

Adding a Cloudflare Connector

To add a Cloudflare connector:

1. Obtain the required credentials
2. Add the connector in Stellar Cyber
3. Test the connector
4. Verify ingestion

Obtaining the Required Credentials

To configure this connector in Stellar Cyber, you will need the following information from your Cloudflare deployment:

• Zone ID: Specify the Zone ID, Cloudflare's unique identifier for each domain in your account. You will be using this ID to configure the connector.

• API Token: You will need to create an API token for use by the Stellar Cyber connector.

• Field list: Review whether you want to collect the Default fields according to how the defaults are set in your Cloudflare deployment, or whether you want All fields that are applicable to the dataset you have associated with that Zone. (Refer to the Cloudflare documentation for a description of the log fields available per dataset.)

Note that the applicable logs are not retained by default. To support the retrieval of logs with the Logpull API, you must enable log retention. If enabling log retention does not work according to Cloudflare's documentation, you may need to modify the API call using the curl command below.

1. Log into the Cloudflare dashboard using a user with the Administrator Read only role.

   

2. Select the account and the domain for which you want to collect data. This step ensures you save the correct Zone ID.

3. From the Overview page, locate the section titled API and the field for Zone ID, then click the link Click to copy. For example: 

   

4. Paste that value in a file to use when you configure the connector below.

5. Click the link for Get your API Token.

6. Follow Cloudflare's guidance to Create an API token. You can create an API from a template or you can create a custom token.

   Specify the following permissions: Zone, desired dataset, Edit. (See note below about Edit versus Read permissions).

   For example, below is a custom token, with the permissions for Zone, Logs, and Edit specified:

   

   The Edit permission is needed for the API token so that this connector can turn on log retention. If you can turn on log retention, only Read permission is needed for the API token.

   Use the following command to turn on log retention:

   curl -i -H "Authorization: Bearer <API TOKEN>" POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/logs/control/retention/flag" -d '{"flag":true}'

   where <API TOKEN> and <ZONE ID> are your API token and Zone ID.

7. Save the API token in the same file in which you saved the Zone ID, then proceed to the next section.

Adding the Connector in Stellar Cyber

With the Zone ID and API token handy, you can add the Cloudflare connector in Stellar Cyber:

1. Log in to Stellar Cyber.

2. Click System | Integration | Connectors. The Connector Overview appears.

   

3. Click Create. The General tab of the Add Connector screen appears. The information on this tab cannot be changed after you add the connector.

   

   The asterisk (*) indicates a required field.

4. Choose Web Security from the Category drop-down.

5. Choose Cloudflare from the Type drop-down.

6. For this connector, the supported Function is Collect, which is enabled already.

7. Enter a Name.

   This field does not accept multibyte characters.

8. Choose a Tenant Name. The Interflow records created by this connector include this tenant name.

9. Choose the device on which to run the connector.

10. (Optional) When the Function is Collect, you can create Log Filters. For information, see Managing Log Filters.

11. Click Next. The Configuration tab appears.

    

    The asterisk (*) indicates a required field.

12. Enter the Zone ID you copied earlier.

13. Enter the API Token you copied earlier.

14. Choose the Interval (min). This is how often the logs are collected.

15. Select the Log Fields you want to collect:

    • All Fields: all fields applicable to the dataset associated with the Zone

    • Default Fields: default fields set in your Cloudflare deployment

16. Click Next. The final confirmation tab appears.

    

17. Click Submit.

    To pull data, a connector must be added to a Data Analyzer profile if it is running on the Data Processor.

The new connector is immediately active.

Testing the Connector

When you add (or edit) a connector, we recommend that you run a test to validate the connectivity parameters you entered. (The test validates only the authentication / connectivity; it does not validate data flow).

For connectors running on a sensor, Stellar Cyber recommends that you allow 30-60 seconds for new or modified configuration details to be propagated to the sensor before performing a test.

1. Click System | Integrations | Connectors. The Connector Overview appears.

   

2. Locate the connector that you added, or modified, or that you want to test.

3. Click Test at the right side of that row. The test runs immediately.

   Note that you may run only one test at a time.

Display sample messages...

Success !

Failure with summary of issue: Show More example detail:

 

Verifying Ingestion

To verify ingestion:

1. Click Investigate | Threat Hunting. The Interflow Search tab appears.
2. Change the Indices to Syslog. The table immediately updates to show ingested Interflow records.