How to transition to subdomained URLs?
As part of our ongoing efforts to improve the Documoto platform, we have introduced subdomained URLs.
Article Topics
- What Changed?
- Benefits of Subdomained URLs
- How to Transition to Subdomained URLs
- Important Considerations for Transitioning to Subdomain URL
- Subdomain Change Management Implications for Existing URLs
- Subdomain Support
- Attachments
What Changed?
Documoto now supports subdomains URLs for each tenant, using your tenant key:
- Production Subdomain URL: [tenantkey]
- Integration Subdomain URL: [tenantkey]
If you do not know you Tenant Key, please reach out to your Customer Success Manager for verification.
Documoto will provide backwards compatibility for the following primary domain URLs:
- Production Primary Domain URL: https://documoto.digabit.com
- Integration Primary Domain URL: https://integration.digabit.com
In the future, we plan to phase out the use of primary domain URLs gradually. We will keep you updated on this transition.
Benefits of Subdomained URLs
- Personalized and Branded URL: your Documoto web address will align with your brand, making it easier for your users to remember and identify with your organization.
- Improved User Experience and Efficiency: users can access one, or multiple, Documoto tenants at the same time, in separate browser tabs, as well as use a single username to access one, or multiple, Documoto tenants.
- Enhanced Security: subdomained URLs provide an added layer of security, ensuring your sensitive data remains isolated and protected.
How to Transition to Subdomained URLs
To embrace these benefits, you have the option to transition all existing primary domain URLs to the new subdomained URLs. Below are the steps to transition:
- Inventory and Document Existing URLs: perform an internal assessment to identify and document all URLs that currently direct to the Documoto Production environment using the primary domain URL. This assessment should encompass all embedded links found within websites, internal systems, or external applications.
- Document Respective, Future Subdomained URLs: after compiling the list of URLs, record the respective, future subdomained URL using the attached worksheet.
- Update URLs to Subdomained URLs: use the worksheet as a reference to update all URLs to their corresponding subdomained versions.
For example, if you have an a link or button on your company website pointing to the Documoto login page:
-
- Primary Domain URL: [tenantkey]
- Subdomained URL: [tenantkey]
Important Considerations for Transitioning to Subdomain URL
As part of the subdomain release (deployed on October 9, 2023), a new SSL certificate has been implemented for the newly introduced .app.documoto.com domain.
To ensure a seamless experience for your users, please consider the following:
- Device and Browser Compatibility: ensure that your users’ devices and browsers meet Documoto’s Library hardware & software requirements. You can find these requirements outlined in detail in this article: Documoto Library Hardware and Software Requirements.
- Whitelist Domains: If your or your users’ IT teams maintain domain whitelists, ensure they add *.app.documoto.com to their list of whitelisted domains.
Subdomain Change Management Implications for Existing URLs
Consult the table below for change management implications for existing primary domain URLs following the introduction of subdomains:
URL Type |
Change Management Implications |
Primary Domain URL Example |
Subdomain URL Example |
| Primary Domain URL |
Requires user to enter Tenant Key on login page |
https://iec-model.app.documoto.com | |
|
Primary Domain URL with tk (tenant key) parameter |
Option to update to subdomained URL |
||
|
Primary Domain URL with ok (organization key) parameter |
Requires user to enter Tenant Key on login page |
https://documoto.digabit.com/?ok=3ad358 |
https://iec-model.app.documoto.com/?ok=3ad358 |
|
Primary Domain URL with tek (tenant encrypted key) parameter and user parameter |
Contact your Customer Success Manager |
Contact Customer Success Manager | Contact Customer Success Manager |
| SSO Redirect URL |
Option to update to subdomained URL |
https://documoto.digabit.com/ui/login/?tk=IEC-MODEL&sso=true | https://iec-model.app.documoto.com/ui/login?sso=true |
|
Portal SSO Redirect URL |
Subdomaining is not supported using this URL |
https://documoto.digabit.com/Portal/saml/?tk=IEC-MODEL&sso=true | Contact your Customer Success Manager |
| Username/Password URL Authentication |
Must transition to subdomained URL or add tk parameter to primary domain URL |
https://documoto.digabit.com/ui/login?username=user123&password=ghijk |
https://iec-model.app.documoto.com/?username=user123&password=ghijk |
| Existing System Generated URL |
Requires user to enter Tenant Key on login page |
The following continue to be supported with subdomained URLs:
- Integration URL parameters
- Open to Search Results Direct URLs
- Open to Content Viewer Direct URLs
- Filter Direct URLs
Subdomain Support
If you have any questions or require further assistance, don't hesitate to reach out to your designated Customer Success Manager or the Documoto Support Team at support@documoto.com.