Handling Hostnames in Wijmo Licensing
Background:
When generating a Wijmo distribution key, the hostname you enter must match the domain where your application runs. However, the protocol (http:// or https://) and the www. prefix do not affect the license check.
For example:
- A license generated for myurl.com will work for both https://myurl.com and http://myurl.com.
- The same applies to www.myurl.com, if you add it once, it will work regardless of protocol.
The most common practice among Wijmo customers is to register hostnames without www. unless there’s a specific need for both.
Steps to Complete:
- Enter hostnames without http:// or https://.
- Exclude unnecessary prefixes, only the bare hostname is required.
Getting Started:
Enter hostnames without protocols
It is not required to include http:// or https:// when adding hostnames.
Correct: myurl.com
Incorrect: https://myurl.com
Example Scenarios
Scenario 1: Only myurl.com added
- License generated for: myurl.com
- Site accessed as: myurl.com
- Works
- Site accessed as: www.myurl.com
- Still works
Scenario 2: Both myurl.com and www.myurl.com added
- License generated for: myurl.com, www.myurl.com
- Site accessed as: either version
- Works in all cases
Regenerate your key if your hostname changes
If your site changes domains, or if your application will be deployed on new domains, you will need to regenerate your license to include the changed/new hostnames. Failing to do this will result in “invalid license” errors when running your application.
If you are using a wildcard license and you add more subdomains to the licensed domain, you will not need to regenerate your key; those new subdomains will be covered by the original key that you applied.
Summary:
For Wijmo licenses, protocols (http:// / https://) are ignored. Only the hostname matters, and myurl.com works the same as www.myurl.com. The most common practice is to add hostnames without the www. prefix but including it won’t hurt either.
Hope you find this article helpful. Happy coding!
Andrew Peterson