.png?height=120&name=Libryo_Small_Use_Green%20(1).png)
Ensuring that you have everything in place to successfully make use of the Libryo platform.
The App
The Libryo platform is a browser-based javascript application. Users interact with the front-end client which is hosted at https://my.libryo.com/, and this client makes requests to our own API at https://api.libryo.com/. Libryo.com is our primary domain, and users will need full access to all urls and subdomains under this. If your organisation makes use of any firewall or network security software, please ensure that our domains are whitelisted to prevent any issues.
We also integrate with a Customer Relationship Management system provided by HubSpot, and our applications needs to make requests to their api to for user interaction and analytics purposes. As such, please allow the following urls to be accepted by your network:
Browser support
We work hard to ensure that the Libryo app provides the same experience across all major internet browsers. While we encourage the use of modern browsers such as Google Chrome and Mozilla Firefox, we understand that for security reasons many organisations need to make use of more conservative browsers such as Internet Explorer and provide support for it.
Regardless of which internet browser your organisation is making use of, please ensure that it is set to always receive the latest updates. If you are having trouble displaying the app in the browser that you are using, please contact our support team and let them know which browser version you are using and we can try debug the issue together.
Please visit the following link to determine if the browser you are using is updated to the latest version.
File/Content Types
As the Libryo app is rendered inside a browser, it requires access to various file types to ensure that it is displayed correctly. Primarily, the app makes use of Javascript (.js) and Cascading Style Sheets (.css), however there are a couple of other types, such as images and fonts, that we use to ensure that the app looks really great.
We’ve found that the main culprit with regards to the app not being displayed correctly is the blocking of font files, as this prevents icons within the app from being rendered correctly.
Along with fonts, please ensure that the browser can access and make use of all the following content types:
- text/html
- text/css
- application/javascript
- application/json
- application/octet-stream
- application/font-woff
- image/png
- image/gif
- image/jpeg
- font/woff2
External Services
The Libryo app makes use of external API’s to provide dynamic content within the app. Specifically, this refers to pulling in Javascript (.js) files from other domains. As such, if any of these services are blocked, it will prevent users from accessing the features and compromise the user experience.
All services used by Libryo are trusted and secured with HTTPS. Currently, we make use of these to provide users with access to geolocation services through the Google Maps, as well as a live chat widget and access to dynamic interactions through our Customer Relationship Management system provided by HubSpot.
Access to the following urls will need to be allowed by the network/browser in order for users to have access to these services:
https://js.hubspotfeedback.com/
Emails and Links
User accounts are linked to their email addresses, and our primary means of communication with our users is through email. Users will require access to email from the Libryo platform in order to receive their legal update notifications, as well as to manage details relating to their account, such as resetting their password. It is very important that these emails land up in the inbox, and not junk mail.
Emails coming from the Libryo platform will be sent from my@libryo.com, and other related communications will be sent from info@libryo.com. We recommend that the entire libryo.com domain be whitelisted through your email service or firewall provider to ensure that our emails successfully reach your inboxes.
You can expect users to receive all of the following emails from the platform:
- Welcome email
- Password reset
- Change of legislation notification
Within our emails are links that direct the user to various parts of the app. There can be a lot of confusion for users if they click on a link in an email and it doesn’t work as intended. As such, if you are using any software to block or alter email links, we recommend whitelisting our emails to ensure that your users may have the most optimal experience with Libryo.
File Downloads/Uploads
We allow our users to export their Online Legal Register, as well as their full Notification History. To ensure that users may make use of this feature, your internal network must allow for browsers to download and save files to the computer. We currently support exporting to pdf (.pdf) and Microsoft Excel (.xlsx).
Libryo also provides a comprehensive document management system, allowing users to upload and download files directly from within the application. As with the exporting feature, downloading and uploading of files will need to be enabled at the browser/network level.
The following file types are currently supported by the app for uploading and downloading, please ensure that none of these are blocked by your internal network:
- image/jpeg
- image/png
- application/pdf
- application/vnd.ms-excel
- application/vnd.ms-excel.sheet.macroEnabled
- application/vnd.ms-excel.sheet.macroenabled.12
- application/msword
- application/vnd.ms-powerpoint
- application/vnd.openxmlformats-officedocument.presentationml.presentation application/vnd.visio application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
- application/vnd.openxmlformats-officedocument.wordprocessingml.document
- application/zip
- application/octet-stream
- application/x-rar-compressed
- text/plain
Service Worker
Libryo is a Progressive Web Application, and makes use of a Service Worker to cache the app, allowing users to browse previously-viewed content when not connected to the internet, as well as improving performance, data-usage and load times. However, not all browsers support the use of a Service Worker, and though it is not a requirement, we encourage the use of such browsers for an optimal user experience. As of July 2018, Chrome and Firefox are the only browsers that currently support Service Workers, with Safari making recent strides to add support in the future. Internet Explorer does not yet provide support.
Please view the following link to determine if the browser that your organisation is using can make use of the Service Worker provided by the Libryo app.
https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API#Browser_compatibility
Checklist
- Libryo urls and emails whitelisted
- Browser updated
- Content-types allowed
- File upload and download permitted
- External Javascript allowed
- Email links not blocked
If you are receiving any errors that could be relating to your internal network not accounting for any of the above, we encourage you to please forward this article along to your IT department so that Libryo can be fully supported for you to use.
If you are still receiving errors after checking this with your IT department, please reach out to us so that we can work together to fix this issue.
Have any questions?
At Libryo, we really want all our users to get the most from our system. We hope that this article was useful. If you still have some questions, please contact us.