About
The Emaillogin module lets users log in with an authentication link sent to their email with no need for a password. To use it, you need to have an email service configured and an email template with the {MAGICLINK} token. Once set up, the authentication link can be used in registration, invite, and login processes. Each magic link can only be used once. If you need your magic link to be used more than once, please contact your Kaltura representative.
This module requires the Theming module to be enabled. The general login page settings are set on the Login module.
This module is available by default for Events, but can be enabled for non-Events sessions upon request. Contact Kaltura to activate it.
Ensure the password field is hidden or removed from the registration form in the Basesiteregistration module.
Configure
1. Go to your Configuration Management console and click on the Emaillogin module. You can also navigate directly using a link: https://{your_KMS_URL}/admin/config/tab/emaillogin.
The Emaillogin page displays.
2. Configure the following:
enabled - Set to 'Yes' to enable the module.
loginEmailTemplate - Select from the drop-down the email that will be sent to the user once login is requested (as shown in the example below). The email must first be prepared in the emailTemplates module, and must contain the {magicLink} token to allow entrance to the site.
linkExpiration - Set how long the email link should be available (in seconds). The default is 900 seconds (15 minutes).
emailSentPageTitle - Enter the title text that you want to appear on the page after the login link is requested (as shown in the image below).
emailSentPageText - Enter the text that you want to appear on the page after the login link is requested (as shown in the image below).
showAlternativeLogin - Set to 'Yes' if you want to display a button for users to log in with their user ID and password as an alternative login method, as shown in the image below:
clickToLogin - Set to 'Yes' if you want users to manually click an Enter site button after using the magic link in the email (as shown in the image below). This feature helps prevent robots and security features, like those in Outlook, from invalidating the magic link.
AdditionalLink
You can add an additional link as follows:
- linkText - Enter the text for the link.
- linkURL - Enter the URL of the link.
- newTab - Select from the drop-down whether you want the link to open in a new tab or the same tab.
The additional link displays on the page, as shown in the image below:
3. Click Save.
Once you have configured the module settings, navigate to the Auth module and make sure you select Loginbyemail in the auth type drop-down options.
Generate login links
After the module has been configured, you can distribute login links to users.
Please note that each magic link can only be used once. If you need your magic link to be used more than once, please contact your Kaltura representative.
Single user
- Go to the Manage Users tab in the Configuration Management console.
- Navigate to the desired user and on the far right click the Actions button.
- From the Actions drop-down options, select Copy Login Link.
- Click Close. The link is copied
The User Login Link window displays.
In bulk
- At the top of the module page, click the Generate links button.
- Click the Upload emails CSV file button.
- You have the option to download a CSV template, or upload your own using the Upload File button.
The Login links generator page displays.
The Generate Links window displays.
