One of the most impactful aspects of a mobile deployment is successfully on-boarding users. The easier it is for users to download and access content, even with strict privacy levels like invite-only, the higher the chances are of getting the app into everyone’s hands.
To this end, we’re excited to announce login links that enable users to more securely onboard to invite-only guides in fewer steps without needing to enter a temporary password. This is made possible by using the security of a user’s email inbox for authentication rather than a temporary password written in plain text. This eliminates common issues like incorrectly entering the temporary password, forgetting an existing password, having to complete the password reset procedure, users writing down their passwords, etc.
Using Login Links
A login link is currently available in two scenarios:
- When a user taps on a hyperlink to download an invite-only guide from their invitation email
- When a user taps a link to open an invite-only guide from the Cover Page
Upon opening the app, the user will be prompted to enter the email address to which they received the invitation. This will initiate an authentication email and prompt them to check their inbox.
They will find a new email with a button that leads them back into the app and automatically logs them into their account. For an existing user, that’s the final step.
If prompted to select an app with which to open the link, make sure to select Guidebook.
If they’re a first-time Guidebook user, they’ll see two more account set up screens.
To start, login links will be available for invite-only privacy guides accessed through the Guidebook app.
How are login links more secure than temporary passwords?
Login links eliminate many of the hurdles of on-boarding—many of which can cause security vulnerabilities. With login links, users no longer need to be provided a temporary password in plain text, worry about accurately entering passwords on their device, or remember a complex account password they have set for the account.
Login links delegate authentication to a user’s email account. The current state of email account security and anti-phishing protection for major email providers is much safer than a simple password written in plain text. In order to ensure additional security, a login link is valid for only 30 minutes after request and can only be used once.
What if a user opens the login link on their computer?
The login link will only work from a mobile device. If a user opens it on a computer, they’ll see a message instructing them to tap on it from their mobile device instead.
When tapping on a login link I’m asked where I should open the link. Which is the correct option?
Make sure to choose to open the link in the Guidebook app. If a browser, such as Google Chrome, is selected, you’ll see a message indicating that the login link must be opened from a mobile device. See the Troubleshooting section below for more information.
On my Android device, I selected to “Always Open” the login link using my mobile browser. How do I correct this setting?
Open your device’s Settings menu, select the Apps folder, and then select Guidebook. Expand the Advanced options and then tap on Open by default. Under Opening links, choose the option to Open in this app for supported links.
Why is the login link saying it’s expired?
Login links expire after 30 minutes. Simply return to the app and request another email to complete the process.
What if a user enters a different email than the one to which they received the invitation email?
The user would see an error that says “The email address you entered does not match any on our list”. With invite-only privacy, only whitelisted email addresses will have access to the guide. The list of users can be managed within Audience Management on the Users tab.
Is it still possible to log in with a password?
Yes, returning users can enter their existing password by tapping the Log in with a password instead button after entering their email address. New users may also use the temporary password in their invitation email if preferred.
Troubleshooting for Android Users
If the link opened in a mobile browser rather than Guidebook
Android users will be prompted to select which app to open when the login link is tapped from their email. It is important that the link is opened using the Guidebook app.
If a mobile browser rather than Guidebook is selected, the following error will be displayed:
To correct this, the user can go back to the Guidebook app and select the option to send a new login link.
Make sure to open the new link using Guidebook.
If the mobile browser is set to “Always Open” login links
If a user selects to “Always Open” the login link with their mobile browser, they will need to adjust that setting on their device.
To do this, open the device’s Settings menu, select the Apps folder, and then open Guidebook. Expand the Advanced options and then tap on Open by default. Under Opening Links, choose the option to Open in this app for supported links.
Once this change is made, the user can request a new login link from the Guidebook app and tap on it to log in.
Troubleshooting for iOS Users
If the link opened in Safari rather than Guidebook
If a user accidentally long taps on the link in their invitation email and selects to open Safari instead of Guidebook, they will need to repeat the same steps but select Guidebook.
- Long tap on the invitation email link and choose Open in Guidebook
- When the Guidebook app opens, tap the Resend It button to request a new login link.
- Open the new email and tap the login link to log in to Guidebook