Installing the Laserfiche Office Integration add-in for Microsoft 365
Description
By using the Laserfiche Office Integration add-in for Microsoft 365, you can save Word, Excel, and PowerPoint documents directly to your Laserfiche repositories. Available for use with Microsoft 365 accounts, the Laserfiche Office Integration add-in can save documents along with their metadata for use with Laserfiche workflows or processes.
Requirements
- Microsoft 365 subscription desktop application or Office for the web using modern browsers.
- User mailbox in Exchange Online.
To learn more about these requirements see Requirements for centralized deployment of add-ins.
Configuration
Overview
Before users can access the Laserfiche Office Integration add-in for Microsoft 365, an administrator needs to do two things:
- Connect the add-in to Laserfiche: Configure repository-wide default options and enable API access to the Laserfiche Repository Server. This lets Office authenticate with Laserfiche.
- Deploy the add-in to users: In the Microsoft 365 admin center, install the add-in and assign it to the users who need it.
This page covers each of these steps.
Additional prerequisites
- Internet access
- Laserfiche 11 or later
- Laserfiche Repository Web Client
- Laserfiche API Server 2.0.2604.16 or later
- Laserfiche Directory Server STS
- HTTPS connectivity to Laserfiche Repository Web Client, Laserfiche API Server, Laserfiche Directory Server STS
Note: If Internet access is required from the Office client, it's recommended to install the above services in a DMZ.
Enable API access to the Laserfiche Repository Server and configure repository-wide default options
- Enable Access to the Laserfiche Repository Server
- Follow the documentation for Installing and Configuring the API Server to enable the "Laserfiche Directory Server (authorization_code) login flow".
- From the list below, select your regional data center, and add the URI for that center to WhitelistedRedirectUris:
- For the United States Data Center: https://app.laserfiche.com/officeapps/office/v1/#/oauthloginwrapper
- For the Canadian Data Center: https://app.laserfiche.ca/officeapps/office/v1/#/oauthloginwrapper
- For the European Data Center: https://app.eu.laserfiche.com/officeapps/office/v1/#/oauthloginwrapper
- [Optional] Configure repository-wide default options
- Administrators can configure a default template.
- If you are not already in the repository administration section of Laserfiche, click your user name in the upper right corner and select Repository Administration.
- On the left, select Everyone.
Note: You must have the Manage Repository Configuration privilege to access this page.
- Select tab Attributes
- Add an Attribute
[Settings]ImportTemplateNameand set the name of the template in Data
Deploy the add-in in the Microsoft 365 admin center
Next, add the Laserfiche Office Integration add-in to the Microsoft 365 admin center and assign it to the users who will connect to Laserfiche. Choose the deployment that fits your organization. See Microsoft's documentation for more information about deploying an add-in through the Microsoft 365 admin center.
Regional deployment steps
- Navigate to the manifest generation page for the region closest to most of your users.

- Select Show options for self-hosted repository installations. Complete the fields according to your installation of Laserfiche.

Note: You may add additional repositories if needed.
- Click Generate manifest to download a .xml manifest file.
- Go to the Microsoft 365 admin center and from the left navigation bar, select ... Show all, and then select Settings > Integrated apps.
- Select the Add-ins link near the top of the Integrated apps page.
- Select Deploy Add-in at the top of the page.
- Select Next on the Deploy a new add-in wizard.
- Select Upload custom apps.
- In the Choose how to upload app section, select the Choose file button.
- Navigate to the Laserfiche Office add-in manifest file you generated earlier.
- Select Upload.
- On the Assign users page, select who the add-in will be deployed to: All users or Specific users or groups.
- Select Deploy.
Troubleshooting
Note: Any configuration changes with the add-ins can take up to 72 hours to be available to users, as Microsoft 365 admin center caches add-in configuration information.
Issue: When deploying a custom add-in to Everyone from the Microsoft 365 admin center, Integrated apps page, deployment fails with the message "The requested action failed." This is a Microsoft admin center bug (issue 7025) that is tracked on the OfficeDev/office-js GitHub.
Workaround:
- On the Assign users step, select Just me or Specific users or groups with yourself included, then proceed to deploy.
- Return to the Installed Add-ins page, and open the Laserfiche Office Integration add-in.
- Under Assign Users, select Everyone and save your changes.
Issue: A user does not see the add-in in their Office app ribbon
Resolution:
- Verify that the user is using either the Microsoft 365 desktop application or Office for the web.
- Verify that the add-in has been deployed to the correct user or user group.