Miradore has moved to single domain URL structure to be more compliant with the requirements of certain browsers, to improve security, and to provide better service for our customers in the future.
Important: The single domain URL structure change is effective immediately; therefore, to ensure the correct operation, implement the changes described in this article as soon as possible. We have redirected the old URLs to the new URLs, but the redirection might not work with specific browsers. The URLs are planned to be redirected only for two months.
The new URL structure of Miradore
The URL of Miradore was changed to single domain architecture, meaning that all customer sites are now under a single domain: https://online.miradore.com. The <sitename> in the new structure is defined as a subdirectory, as in https://online.miradore.com/<sitename>.
Check the following examples to see how the URLs change in the new, single domain structure:
Old URL: https://<sitename>.online.miradore.com
New URL: https://online.miradore.com/<sitename>
In the following example, <sitename> is 'mysitename'.
Old URL: https://mysitename.online.miradore.com
New URL: https://online.miradore.com/mysitename
What do I need to update?
To continue using Miradore, update the following as soon as possible:
- Update browser bookmarks for Miradore to use the new URLs.
- If you use API, update the URLs in the API requests.
- If you use our Active Directory (AD) integration, replace the old AD connector with the latest version.
For more information, read the subsections in this article.
Updating bookmarks with the new URLs
In your browsers, update the Miradore bookmarks by replacing the old URLs with the new ones.
Important: To ensure the correct operation, update your Miradore bookmarks to the new URLs as soon as possible. We have redirected the old URLs to the new URLs, but the redirection might not work with specific browsers. The URLs are planned to be redirected only for two months.
Updating the URLs in API requests
Select one of the following options to update the URLs in your API requests:
- Include <sitename> in the new URL as a subdirectory.
- Include <sitename> in the HTTP header.
Learn more about the Miradore API.
Including <sitename> in the URL as a subdirectory
Move <sitename> from the old base URL to be a subdirectory in the new URL.
Old URL: https://<sitename>.online.miradore.com/api/v2/<endpoint>
New URL: https://online.miradore.com/<sitename>/api/v2/<endpoint>
API request example
In the following API v2 example, <sitename> is mysitename and the Device endpoint is called to post the lock request on the device identified by {id} in the URL.
Old:
POST https://mysitename.online.miradore.com/api/v2/Device/{id}/Lock
New:
POST https://online.miradore.com/mysitename/api/v2/Device/{id}/Lock
Including <sitename> in the HTTP header
Use https://online.miradore.com (without <sitename>) as the base URL and provide <sitename> in the X-Instance-Name header.
API request example with CURL
In the following CURL command example, <sitename> is mysitename and the Device endpoint is called to post the lock request on the device identified by {id} in the URL.
Old:
curl -X POST https://mysitename.online.miradore.com/api/v2/Device/{id}/Lock
New:
curl -X POST -H "X-Instance-Name: mysitename" https://online.miradore.com/api/v2/Device/{id}/Lock
Updating the AD connector
Note: If you use the AD connector, update it to the latest version as soon as possible. The scheduled user import settings are not affected if the connector is updated to the new version.
In Miradore, navigate to: Company > Users > Import > Import users from Microsoft Active Directory. To update the AD connector, download the new version (1.5.0.0) and overwrite the old .exe and configuration files with it. To check the version number of the connector, right click the .exe file, select Properties and check the Details tab.
If you need assistance with updating the AD connector, contact the Miradore Support Team.
Learn more about importing users from active directory.