This is CloudFront Function that maps subdomain and redirects it into a specific path. For example, if the user access https://about.mysite.com it will automatically redirect to https://mysite.com/about.

Here's another example that this function support:

• contact.mysite.com -> mysite.com/contact
• career.mysite.com/latest -> mysite.com/career/latest
• skills.mysite.com/programming?sort=name&foo=bar -> mysite.com/skills/programming?sort=name&foo=bar

Note: The function associated with a CloudFront distribution with viewer request as the event type.

This function will look up at request object. Get all necesarry properties such as uri, query string, and host headers. Manipulate them into new URL and return HTTP status code 301 which will redirect to the new URL.

1. Compile index.ts in this repository to js or you can copy this index.js that ready to use.

2. Create CloudFront function. Paste index.js that you copied before in function code section.

   Follow this guide to create CloudFront Functions.

3. Associate and publish CloudFront function that you create before with the following settings:

   • Distribution: <select distribution that you want to associate with the function>

   • Event Type: Viewer request

     Note Make sure you choose Viewer request or the function won't work.

   • Cache behavior: <select a cache behaviour that you use or you can use Default (*) instead>

     For more detail step how to associate function please visit this guide.

Yes, you can. Make sure you use ECMAScript (ES) v5.1 because when this code was written, CloudFront Functions had many limitations.

Yes. It is possible use www as main/base domain (for example: www.mysite.com). Simply change variable baseUrl inside handler function:

function handler(event) { ... var baseUrl = 'www.' + fullDomainName.slice(fullDomainName.length - 2).join('.'); ... }

No. This functions only support third level domain.

Use what can be used and supported.

If you have any ideas/questions/found any problem or want to improve this code let me know by opening PR/issue - your feedback and contributions are welcome!