Skip to content
/ Locked Public

The great companion to your ControlD for easily blocking and unblocking your domains.

License

Notifications You must be signed in to change notification settings

afi-dev/Locked

Repository files navigation

Locked

Locked

Locked is a web application designed as a practical add-on for ControlD users. It makes it easy to manage access to sites blocked or unblocked by ControlD DNS, while providing additional security information for each domain. To use this project you need a ControlD subscription.

Preview

Image1 Image 2
Image 3 Image 4

Features

  • Fast domain blocking and unblocking: add or remove domains from your ControlD block lists with a single click.
  • ControlD subscription overview: quickly view the number of days remaining on your ControlD subscription.
  • Security information: view domain security information directly from the block/unblock page. This information is provided by VirusTotal via a personal API key.

How does it work?

When ControlD blocks a site, a customised blocking page is displayed (if this option is enabled in ControlD). Locked integrates directly with this page to provide a simplified management experience:

  • Instant unblocking: Locked interacts with the ControlD API to unblock the site instantly. This feature enables access to be restored quickly while maintaining visibility of the site's security information.

  • Fast blocking: as well as unblocking, the Locked application can also block a site in a matter of seconds. Simply enter the URL of a domain in the Locked interface to add it to the ControlD blocking lists.

  • ControlD subscription tracking: in Locked, users can quickly see information about their ControlD subscription, including the number of days remaining.

Locked transforms the management of blocked and unblocked sites into a simple, secure and efficient process.

Requirements

Important

To use Locked, you will need :

  • A ControlD subscription in Some Control or Full Control.
  • A VirusTotal API key to access domain security information (optional but recommended).
  • An active ControlD API key.

Installation

Follow the steps below to install the development repo and start Locked :

  1. Clone the repository :
git clone https://github.com/Afi-dev/locked.git
  1. Install the dependencies :
cd locked
pnpm install or npm install

Here's an improved version:

  1. Configuring the .env file

Copy the .env.example file and rename it to .env.

  • ControlD API Key (required) :

Important

Make sure you configure a ControlD API key with write permissions.

Paste your ControlD API key into the .env file to activate the blocking and unblocking functions.

  • VirusTotal API Key (optional) :

To display domain security information, also paste your VirusTotal API key to the .env file.

  1. Run Locked
npx next dev
pnpx next dev

License

Copyright © 2024 Kaelian BAUDELET and contributors.

Code published under the MIT licence.

About

The great companion to your ControlD for easily blocking and unblocking your domains.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published