Marcio Cunha

How to Find Out Who Changed a Setting in Cloudflare: Auditing and Logs

Learn how to track configuration changes in Cloudflare using audit logs and native tools to identify exactly who modified your DNS or security rules.

Marcio Cunha12 min
Also available in:EspañolPortuguês
Summary
  • Cloudflare audit logs record every configuration change made in the dashboard or via API by any account user.
  • Dashboard queries allow filtering events by date, IP address, and action type without requiring external tools.
  • Using the audit API enables exporting historical event data to centralized security monitoring systems.
  • Correlating user identifiers with active API keys prevents surprises in environments with active automations.
  • Configuring real-time alerts protects infrastructure against unauthorized modifications to critical security parameters.

The Challenge of Tracking Changes in Cloud Infrastructure

When an application experiences sudden downtime or unexpected behavior after a modification, any engineering team's first instinct is to figure out what changed. In modern infrastructure environments, where dozens of developers, automated tools, and API keys interact with the system, tracking the exact origin of a change can feel like a police investigation. Within the Cloudflare ecosystem, which acts as the gateway for a massive portion of global web traffic, knowing precisely who tweaked a firewall rule, a DNS record, or an SSL setting becomes a critical matter of security and operational stability.

In practice, this means having clear visibility into actions executed within the control panel or via application programming interfaces (APIs), preventing hours of precious debugging time. Cloudflare maintains a detailed record of all administrative activities, known as the Audit Log. This feature acts as an airplane black box for your web infrastructure, storing crucial information about every click and command sent to the platform's servers. Understanding how to access, filter, and interpret this data is the difference between resolving an incident quickly or continuing to grope in the dark.

Understanding Cloudflare Audit Logs

Audit logs record administrative events immutably, meaning the modification history cannot be erased by regular users, ensuring the integrity of any investigation. Each log entry contains a rich set of metadata, including the originating IP address of the request, the exact timestamp, the authenticated user's email, and the precise change made to account or zone parameters. When we mention a zone, we are referring to the specific managed domain, such as a website or web application hosted on the platform.

To access this information visually, the most direct path is to navigate to the main Cloudflare dashboard and locate the audit section in the sidebar or account settings. There, the interface presents a chronological table of all recent modifications. For those who prefer automating this search, the platform provides API endpoints that return this exact data in structured formats like JSON, allowing security teams to integrate Cloudflare history into corporate security event and incident management (SIEM) tools.

How to Query Modification History in the Dashboard

Navigating the Cloudflare control panel to find a specific change requires the smart use of filters. If you know the issue occurred within a specific timeframe, restricting the search by date eliminates the noise generated by routine modifications. Furthermore, you can filter results by action type, such as DNS record modifications, Web Application Firewall (WAF) rule adjustments, or changes to cache and SSL/TLS policies.

Expanding a specific event in the list reveals the previous and subsequent states of the modified parameter. This direct comparison, often called a diff, shows exactly which value was replaced. For instance, if someone altered the IP address pointing to a critical subdomain, the log will clearly display the old IP and the newly inserted IP. This clarity removes assumptions and points directly to the failure vector or the maintenance worker who forgot to document the change.

Identifying Compromised Users and API Keys

One of the greatest advantages of analyzing Cloudflare audit logs is the ability to distinguish between actions executed by human beings and those performed by bots, scripts, or software integrations. When a human makes a change, the log displays the email address associated with the personal account that logged in with a password and two-factor authentication. However, many modifications occur via API keys or personal access tokens, which are credentials used by external systems to interact with Cloudflare without direct human intervention.

In such cases, the audit record displays the name of the token or the key used, making it possible to track which system or automated service triggered the change. If an API key accidentally leaked into a public code repository, the logs will show unfamiliar IP addresses making modifications to your zone. This immediate discovery allows administrators to revoke compromised credentials before further damage is caused to the integrity of the web infrastructure.

Exporting and Automating Audit Log Collection

For medium and large organizations, relying exclusively on the Cloudflare web interface to monitor changes may prove insufficient. Default log retention in the dashboard has time limits, and reliability engineering teams frequently require centralizing all infrastructure logs into a single data repository. To meet this need, Cloudflare allows exporting audit data in real-time to cloud storage services or analytics tools.

Automating this process can be done using scripts in languages like Python or command-line utilities that periodically query the audit API. By programming a routine to collect these events and send them to a central database, the company creates a permanent, independent audit trail. This practice not only meets strict regulatory compliance requirements, such as CCPA or GDPR, but also drastically accelerates cybersecurity incident response.

Best Practices to Prevent Unauthorized Changes

Discovering who changed a setting is essential, but the ideal scenario is preventing unwanted modifications from happening without proper team alignment. The first step in this direction is the rigorous adoption of two-factor authentication (2FA) for all members who have administrative access to the Cloudflare dashboard. This prevents credentials leaked through phishing attacks or password breaches on other sites from resulting in total control over your DNS infrastructure.

Another essential practice is the principle of least privilege, which consists of granting each collaborator only the permissions strictly necessary to perform their duties. A junior developer or a content writer should not have write access to global security settings or core company DNS records. By restricting roles and continuously monitoring audit logs, the organization builds a resilient, transparent environment shielded against human error and malicious access.

Final Considerations

The ability to audit and track changes in cloud infrastructure platforms is no longer an operational luxury, but a core engineering requirement. Cloudflare offers robust and detailed tools through its audit logs, allowing technical teams to identify with pinpoint accuracy the authorship of any modification. By mastering these resources, administrators turn crisis situations into opportunities for learning and internal process refinement.

Maintaining governance over API keys, enforcing role-based access restrictions, and automating log collection are measures that guarantee the health and security of any modern application. Investing time in correctly configuring these visibility mechanisms protects the business against silent failures and ensures that web infrastructure remains under absolute control, regardless of team size or project complexity.