Custom Domain

Given below are the steps to create your custom domain using AWS CloudFront.

The following are mandatory requirements to start creating the domain:

  1. User must have AWS account.

  2. User must have registered custom domain.

Preparations

  1. The app’s non-custom domain must be obtained when deploying and noted down. The URL can be copied from the tip under the custom domain field in publish.

    a. Go to your design console, Xooa.com/blockchain, and choose the application for which you want to create custom domain.

    Preparations

    b. Click Design to open the application’s design console -> Publish -> click Modify on the Custom Domain and Email tile -> Copy the URL.

    Preparations
  1. Decide the custom domain name.

  2. Request AWS certificate.

How to create custom domain

Step 1: Go to https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html to create Hosted Zones.

If the customer has an existing registered domain with a domain name service provider other than AWS then, following steps must be performed after the AWS CloudFront instance is created as mentioned in step 2 below:

a) A subdomain entry must be added in the current domain name service provider DNS to point to AWS cloud front instance URL

b) The subdomain must be added as ‘Alternate domain name (CNAME) - optional’ in the AWS cloud front instance.

Step 2: Go to Create distribution page in CloudFront

  • Paste the non-custom domain URL that you copied as step 1 in Preparations, in the Origin domain field.
    Preparations
  • Scroll down to Cache key and origin requests section.

    • Legacy cache settings -> None.

    • Object caching -> Customize -> set Maximum TTL and Default TTL to 0.

Preparations
  • Click Create distribution. The page navigates to the Distributions home page.

Step 2: In the distributions page, click Origins tab -> Create origin.

Preparations

Step 3: In the Settings page:

  • In the Origin domain field, select: dashboardapi.Xooa.com.

  • In the Origin path field, enter: /blockchain.

  • Click Create Origin.

Preparations

Step 4: In the distributions page, go to Behaviors tab -> Create behavior.

Preparations

Step 5: In the Settings page.

  • In the Path pattern field, enter: /api/config.

  • In the origin and origin groups field, select: dashboardapi.Xooa.com.

Preparations
  • Scroll to Legacy cache settings.

    • Headers -> select Include the following headers -> select ‘Origin’ and ‘Referer’.
Preparations
  • Object caching -> Customize -> set Maximum TTL and Default TTL to 0.
  • Click Create Behavior.

Step 6: In the distributions page, click the Edit button to point your custom domain.

  • In the Alternate domain name field, enter your custom domain name. Refer below screenshot.
Preparations
  • In the Custom SSL certificate field, in the dropdown, select your certificate to associate. If you cannot find your certificate, request certificate using ACM.
Preparations
  • Click Save changes.

Step 7: Go to Route 53 -> Hosted Zones -> click your domain name in the hosted zone -> Create record. Refer below screenshot.

Preparations

Step 8: In the Quick create record page:

  • Enable Alias.

  • Select your distribution endpoint in Route traffic to drop-down list.

  • Select your distribution. Refer below screenshot.

Preparations
  • Click Create records. The custom log domain is created.

Step 9: In a new browser tab, enter the custom log domain name -> copy the domain name from the URL field.

Step 10: Go to your application console -> click Modify on Custom Domain tile.

Step 11: In the popup window, enter the domain name -> click Save. Refer below screenshot.

Preparations

Step 12: Go back to the newly opened tab with your domain name and reload the page.

Your application will be available in the newly created custom domain name.

Preparations