Skip to content

Configure Sub Domain

You only need to change current DNS record of the asset you intend to protect.

Sub Domain Registration #

In the ‘Domain Info’ menu, click ‘Add Domain’ to register a new protected domain.

After clicking ‘Add Domain’, you will be directed to below page then select ‘Sub domain

Fill in domain information in fields described below:

  • Domain type: Sub domain for protecting “https://subdomain.website.com”    
  • Domain: Enter domain name and click the ‘Domain Check’ button to lookup the domain.
  • Protocol & Port: Protocol is either HTTP or HTTPS whilst Port is any port from 1 to 65535. Adds the protocol and port information that you are using on the actual backend server. For example, if you access your website on http://mysite.com:888 and https://mysite.com:999 then you need to add the following pairs: {http and 888} and {https and 999}, Then press ‘Add’.
  • Use SLB: This feature is short for ‘Server-side load balancing’. If you have multiple public IP addresses for your website, then you may want to configure the WAF to distribute the workload across these addresses.
  • Address type: You can add the origin address information of protected server whether IP type or CNAME type.
  • Address: Add origin server address.
  • Certificate: For HTTP, no certificate is needed whilst if you use HTTPS for your web server, you need to upload the certificate file you are currently use to Jalmoud WAF in order to be able to inspect encrypted traffic. However, when selecting JALMOUD certificates, you will use a self-signed certificate generated by Jalmoud WAF in order to be able to inspect encrypted traffic.

When finish configuring the protected web server, click ‘Apply’ to commit the changes. If it’s added successfully, you will see the protected domain as in the below screenshot.

If you expand the row of the added server, you can see its attributes along with some statistics:

Server Load Balance (SLB) #

If you want to activate SLB, you need to configure below parameters.

  • Health Check URL: Provide the URL information to be used for checking the health of the primary server. You must click the ‘Test’ button to verify that it is checked properly.
  • Sorry Page Type: Select the type of ‘Sorry page’ that will be served to the client in the event of a failed health check on all servers. You can type the page directly into HTML or redirect it to another URL.
  • Sorry page: You can select either an HTML page or a URL to redirect the client upon failure.

Add CNAME Record #

After configuring the protected web server correctly, we need to change the DNS information to redirect we requests to Jalmoud WAF. Below are the steps needed for this task.

  1. Navigate to ‘Doman Info’ tab
  2. Expand the sub domain row
  3. Click on ‘magnifiergreen icon
  4. You will be presented the details of the sub domain for CNAME. In below screenshot: s1-305-bee–testwebapp—xyz[.]jalmoudwaf[.]com
  1. Write down the ‘A record’ which is needed to build needed CNAME record in below format:
Record TypeHost NameAddress
CNAMEsubdomainA record from previous step

Example for above information:

Record TypeHost NameAddress
CNAMEbees1-305-bee–testwebapp—xyz.jalmoudwaf.com
  1. Changing Name Servers differs based on the hosting service. Below are some references for most common hosting providers:

Verify DNS Changes #

Method #1 #

Open ‘Command Prompt’ on Windows or ‘Terminal’ on Linux.

  1. Type the command nslookup and press ‘Enter
  2. Type the command set type=cname and press ‘Enter
  3. You should see the ‘CNAME’ record you have changed in the command output.

Method #2 #

Navigate to DNS Lookup website: https://dnslookup.online/

  1. Select DNS Server type: Authoritative Name Server
  2. DNS Server IP or Hostname field will be disabled
  3. Select DNS Record type: CNAME
  4. Type your Sub domain in the ‘Domain Name or Hostname’ field
  5. Click the button: DNS Lookup
  6. You will find the new CNAME record in the Answer section.

To confirm, refresh in the domain list, expand the domain and you will see ‘DNS Status’ changed from ‘Not changed’ to ‘Healthy’.

Powered by BetterDocs