Create a Custom Login Module for Laserfiche Web Access
Why would I need a custom login module?
By default, with Laserfiche Web Access 8.1 and higher, you can configure the Web Access Login Page to support the following methods of authentication to a Laserfiche repository:
- Prompt the user to manually specify a user name and password.
- Automatically log in using a specified Laserfiche user account.
- Automatically log in using the user’s current Windows credentials.
But, what if you want users to automatically log in using a different set of credentials?
Example: Your organization has a secure Web portal that is only accessible to registered users. In order to gain access to this portal, users must log in with a user name and password. Within this secure portal, you would like these registered users to also have access to certain folders and documents through Laserfiche Web Access, yet you do not want them to have to specify another set of log in credentials to view this information.
This is where creating a custom login module becomes useful.
What are the required Laserfiche products?
- Laserfiche Server 8.1 or higher
- Laserfiche SDK 8 or higher
- Laserfiche Web Access 8.1 or higher
What else should I keep in mind before creating a custom login module?
- One instance of Web Access can only be associated with one custom login module.
- In order to create and modify user accounts, the module must be able to log in to the desired Laserfiche repository with an account that has the “Manage Trustees” privilege. Not all custom login modules necessarily have to create/modify accounts in the Laserfiche repository.
How do I create a custom login module?
Very detailed step-by-step instructions on creating a custom login module can be found in “Creating a Custom Login Module for Web Access 8”.
In addition, you can download a sample project here. This project is written in C# using Visual Studio 2008, and there is some necessary configuration that needs to be performed beforehand. The required configuration information is found on the same page.
*A Support Site account is required to download both the whitepaper and the sample project.*
If you are running Web Access 8.3, you will need to change the project from referencing LFSO82 to reference LFSO83.