Choosing a routing option

🎥 Hint: you can also watch DataUnlocker setup tutorial video.

Adding DataUnlocker to your website consists of 3 steps: choosing a routing option, adding a script and running a health check to ensure that you have set things up properly.

In the first step, you will be asked to choose a routing option, which can be either:

  • DNS-based (default and preferred)
  • Path-based (for extraordinary cases when you want to use your own servers)

Choosing a routing option for DataUnlocker to be used on the website

Choose a DNS-based option if you have an access to your domain, as it is the easiest option available. The second option requires you to set up a reverse proxy on your own, which will forward all traffic to our proxy servers with a few additional headers.

Setting up DNS-based routing (default, preferred)

After choosing DNS routing option, the setup will suggest a new DNS records you will need to add to your domain. This is usually done on the website where you have purchased your domain. The exact steps for adding a DNS record vary between domain registrars, but we suggest looking at some common cases.

Add DNS records exactly as the setup guide suggests:

Configuring DNS records for DataUnlocker

Note the following:

Setting up path-based routing (alternative)

The path-based routing option can be used when your (website hosting) provider doesn't give you access to manage your domain's DNS records. However, you will need to run proxy servers on your own, following the UI instructions.

The path-based routing option can also bring you a benefit of having same-origin proxied requests, however, this is not necessary, as all third-party requests normally already have all appropriate CORS headers.

If you decide to use the path-based routing option, you will need to run your own reverse proxy back end like this one. You also need to ensure that your reverse proxy server additionally pass X-Du-Token and X-Du-IP headers to all proxied requests, and it doesn't modify any existing headers.

DataUnlocker Logo
DataUnlocker
Content blockers are friends