Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dsferruzza/clever-cloud-detector

A web extension to detect if websites you browse are hosted by Clever Cloud.
https://github.com/dsferruzza/clever-cloud-detector

Last synced: 5 days ago
JSON representation

A web extension to detect if websites you browse are hosted by Clever Cloud.

Host: GitHub
URL: https://github.com/dsferruzza/clever-cloud-detector
Owner: dsferruzza
License: mit
Created: 2023-07-24T08:24:37.000Z (over 1 year ago)
Default Branch: master
Last Pushed: 2024-04-16T11:04:33.000Z (7 months ago)
Last Synced: 2024-04-17T14:27:22.672Z (7 months ago)
Language: TypeScript
Homepage:
Size: 275 KB
Stars: 2
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Clever Cloud Detector

[![LICENSE](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Mozilla Add-on](https://img.shields.io/amo/v/clever-cloud-detector)](https://addons.mozilla.org/firefox/addon/clever-cloud-detector/)

A web extension to detect if websites you browse are hosted by [Clever Cloud](https://www.clever-cloud.com).

## What is the point?

I wanted to learn making a Web Extension and as a proud user of [Clever Cloud](https://www.clever-cloud.com) I though this would be fun to randomly discover other Clever Cloud users while browsing.

## How does it looks like?

It adds an icon inside the browser's address bar.
If you visit a website hosted by Clever Cloud, the icon is colored.

![](screenshots/screenshot-yes.png)

![](screenshots/screenshot-no.png)

## How does it works?

A script activates every time you navigate to a new page.
It extracts the page's hostname and checks if it is hosted by Clever Cloud using the following heuristics:

- hostname has a domain name that is publicly known to be owned by Clever Cloud (for example: `*.clever-cloud.com`)
- hostname is a CNAME to one of Clever Cloud's frontal domains (for example: `domain.par.clever-cloud.com`) or to one of its owned domains
- hostname is a A to one of Clever Cloud's frontal domains (a public endpoint on Clever Cloud's API is used to get the list of their zones, then the extension gets the corresponding IPs of every zone using DNS resolution)

_Note: IPs of Clever Cloud's frontal web server are cached in session storage to avoid getting them too often, as they are not supposed to change by the hour._

### Limitations

If a website is hosted by Clever Cloud by is behind a proxy (such as Cloudflare), this extension will not able to flag it as hosted by Clever Cloud.

## How to get it?

- manual install from extension file (get it from the _Releases_ section or build it yourself)
- [Firefox](https://addons.mozilla.org/firefox/addon/clever-cloud-detector/)

## How to build it?

This requires a ~recent installation of [Node.js](https://nodejs.org).

- install dependencies: `npm install`
- build extension: `npm run package`
- extension can then be found in the `web-ext-artifacts` directory

## License