DeTor

🙊 A simple REST API to identify requests made from TOR network.

DeTor uses TorDNSEL inside, not a static list of TOR exit nodes.

DeTor API call

GET http://detor.ambar.cloud/

Parameters

Call Example

The Simple One

Just open http://detor.ambar.cloud/ in your browser and look at the found field, it its value us true - you're using TOR. Also you can use our smart TOR-detecting badge <img src="http://detor.ambar.cloud/badge"/> on your site.

The Right One

Image you have a web service running on 1.2.3.4 public IP address and 8080 port. You register an incoming request to your service from 2.3.4.5 IP address and want to check whether this request is made from TOR network or not.

In this case the call would be:

CURL

curl -X GET 'http://detor.ambar.cloud/?sourceIp=2.3.4.5&destIp=1.2.3.4&destPort=8080'

Node.js

var request = require("request");

var options = { method: 'GET',
  url: 'http://detor.ambar.cloud/',
  qs: { sourceIp: '2.3.4.5', destIp: '1.2.3.4', destPort: '8080' }
  };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

Success Response

HTTP/1.1 200

JSON object, fields:

Example:

{
    "sourceIp": "104.200.20.46",
    "destIp": "89.207.89.82",
    "destPort": "8080",
    "found": true
}

Error Response

HTTP/1.1 500

JSON object, fields:

Example:

{
    "error": "Error: Source IP (256.10.10.10) is invalid"
}

Running Your Own Instance

Use Docker image: docker run -p 80:80 -e port=80 -d --name=detor rd17/detor