Skip to main content

Find cloudflare DNS records using fuzzy search.

Project description

CloudFlare Fuzzy Finder

Build Status Downloads Latest version Format Status License Support version

cloudflare-fuzzy-finder aims at checking DNS record more easily. It will connect to CloudFlare's API and get all DNS records from your account, and allow to search on fuzzy finder. Once pressing Enter on highlighted record, it will popup to the CloudFlare website for you to manage the record on that domain.

asciicast

It is inspired by pmazurek/aws-fuzzy-finder and built on top of fzf binaries and python-cloudflare.

Installation

To install use the following command:

pip install cloudflare-fuzzy-finder

This package uses cloudflare-python to authenticate, so if you haven't used before, you have to get the api key from your profile and put into following files like:

$ cat ~/.cloudflare/cloudflare.cfg
[CloudFlare]
email = user@example.com
token = 00000000000000000000000000000000
certtoken = v1.0-...
extras =

More information on alternative ways of configuring your CF_API_EMAIL, CF_API_KEY and CF_API_CERTKEY variables can be found here: https://github.com/cloudflare/python-cloudflare#providing-cloudflare-username-and-api-key

Settings

The loading time on records list highly dependent on the API calls to CloudFlare to fetch all the DNS records across the domain belongs to you.

The cache on DNS records is turn on by default and keep for 1 hour.

If you want to fine tune the duration on keeping the record locally, you can update by CF_FUZZ_CACHE_EXPIRY.

Or if you want to perform the search without using the cache, cau use cf-fuzzy --no-cache.

Or you can append this to your ~/.bashrc to make the settings permamant:

export CF_FUZZ_USE_CACHE=true
export CF_FUZZ_CACHE_EXPIRY=3600 # in terms of seconds
export CF_RECORD_TYPES=cname,a

Remeber that every change to ~/.bashrc requires you to re-load it: source ~/.bashrc or restart terminal.

Usage

To run, use the following command:

cf-fuzzy

To search any records other than CNAME & A, use the following command:

cf-fuzzy --record-types mx,txt

Cache

If you are managing lots of domains and downloading the data takes too long, you can use the built in cache. To enable it set the following variables in your .bashrc:

export CF_FUZZ_USE_CACHE=true
export CF_FUZZ_CACHE_EXPIRY=3600 # in terms of seconds

To invalidate cache and refresh data, run with --no-cache param Cache will be stored as a file in ~/.cloudflare_fuzzy_finder.cache.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for cloudflare-fuzzy-finder, version 0.1.4
Filename, size File type Python version Upload date Hashes
Filename, size cloudflare_fuzzy_finder-0.1.4-py3-none-any.whl (3.5 MB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size cloudflare-fuzzy-finder-0.1.4.tar.gz (3.5 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page