Tutorial: Domain Forwarding

How to implement MB™ using Domain Forwarding?

The simplest way to implement MB™ on your site or IoT device is to use domain forwarding. That is provided that your domain registry provides this feature for you to use in your DNS configuration. An example of this feature is provided by GoDaddy or Google Domains. It is as simple as cutting and pasting your MB™ redirection URL into the URL field of your domain forwarding interface in your domain name provider settings. It should take only 1 minute to complete this entire tutorial.
 
After you have successfully signed in to MB™, you need to first verify that the ‘Web Address’ + ‘Content Path’ works properly. By that, we meant that the URL that is formed by these 2 elements will land properly on your website content. You can test this quickly by clicking on the ‘Profile’ tab (See 1 below) followed by clicking on the Redirection Link (See 2 below).

Step 1:

If you have done everything correctly, clicking on the Redirection Link will open up a new tab on your browser showing your website content without any errors. If however, you fail to configure everything correctly, you should see an error message explaining the root problem when you click on the ‘Traffic’ tab.

Step 2:

Sign in to the MB™ web application using the digital key file send to you during our registration process. If you do not have a digital key file yet, then you must first register with MB™. See here for details.
 
 Once you have successfully signed in, click on the ‘Embed My Code’ link to get a copy of the code to be inserted or embedded into your website. This code will allow MB™ to provide you with a real time web traffic spam report. When you click on the link, it will bring you to the ‘My Code’ section of the MB™ web application.

At the ‘My Code’ section of the MB™ web application, select the code in ‘Redirection Web Address’. Once you selected the code block, it will be highlighted in yellow. See below:

Step 3:

Simply cut and paste to replace the URL used for your domain name provider to do the domain redirection. You should use a temporary HTTP 302 setting for this new domain redirection. You should also note that you cannot use masking for this forwarded domain.
 
Your web content also cannot be hosted on the same top level domain as the one that you are using for the domain forwarding. The reason is because hosting the content on the same top level domain will result in an infinite loop in the redirection. Below are some correct example configurations for your domain to be able to properly support the domain forwarding feature.
 
 Example 1:
 Domain: example.com
 Forwarding URL: http://mbte.site/id/5xxxxxxxxxxxxxxx3
 Web Address + Content Path: my.example.com/
 
 Example 2:
 Domain: example.com
 Forwarding URL: http://mbte.site/id/5xxxxxxxxxxxxxxx3
 Web Address + Content Path: sample.com/page.html
 
 That is it! You are done. Just wait for MB™ to start collecting data on your web visitors and you will start to see MB™ in action. MB™ will report each incoming web traffic to you for review on the ‘Traffic’ tab of the MB™ web application.

Review your web traffic regularly and teach MB™ how to deal with each type of web traffic specific to your website. Over time, MB™ will learn from you and the data collected. With enough feedback from you, MB™ will slowly take over the web traffic management of your website for you.
 
 Enjoy!
 
 Do not hesitate to email us if you have any questions, doubts or need any kind of support from us.
 
 For a more advance tutorial discussion, please refer here.


Originally published at blog.malleablebyte.org on August 29, 2016.