Skip to main content

LawVu for Outlook Add-in - Admin Guide

Chinmayee avatar
Written by Chinmayee
Updated this week

In this article:


Deployment

The Outlook Add-in requires two steps to be completed to enable users to sign in and start using the Add-in.

  • Install the Add-in: provisions the LawVu for Outlook Add-in in the Outlook toolbar for users

  • Consent Permissions: ensures all permissions required by the Add-in are setup.

Install the Add-in

If LawVu users are unable to install the LawVu for Outlook Add-in themselves, then it can be deployed using the Microsoft 365 admin center.

In the Microsoft 365 Admin Centre, go to Settings, then Integrated Apps. Click on Get Apps:

Search for LawVu and select the add in:

Select the target user, user groups or entire organization:

This will automatically deploy the Add-in to the selected users and will make it available in Outlook.

Consent Permissions

Consent for the permissions is requested dynamically when a user signs into the Add-in for the first time.

In order to streamline the installation and first use of the LawVu for Outlook add-in by your users, we recommend pre-emptively consenting to the required API permissions on behalf of all users who will require this add-in.

The following link can be used to admin consent all users:

Alternative Options

Depending on your Microsoft 365 configuration, there are also other options to consent:

  • Allow users to consent to the permissions when prompted (more information)

  • Allow users to request consent from an admin (more information)

  • Grant consent on behalf of a single user (more information)

    • Required details

      • Application ID: 2103a01c-3dfc-4ed1-af75-2721adca75d9

      • Permissions:

        • User.Read

        • Mail.ReadWrite

        • offline_access

      • Resource ID (Microsoft Graph): 00000003-0000-0000-c000-000000000000

Consenting the Add-in to use optional shared mailbox features

When a user attempts to use the Add-in with a shared mailbox message, they are dynamically asked for further consent to API permissions required for the Add-in to access the shared mailbox.

The following link can be used to admin consent all users for shared mailbox permissions:

Alternative Options

  • Allow users to consent to the permissions when prompted (more information)

  • Allow users to request consent from an admin (more information)

  • Grant consent on behalf of a single user (more information)

    • Required details

      • Application ID: 2103a01c-3dfc-4ed1-af75-2721adca75d9

      • Permissions:

        • User.ReadBasic.All

        • Mail.ReadWrite.Shared

      • Resource ID (Microsoft Graph): 00000003-0000-0000-c000-000000000000


Permissions Reference

The following Microsoft Graph API permissions are used by the LawVu for Outlook Add-in.

Permission

Purpose

User.Read (delegated)

Sign in and read user profile

Used to sign in the user to the LawVu for Outlook

Mail.ReadWrite (delegated)

Read and write access to user mail

Used to read mail to support uploading of content, attachments and metadata (subject, sender, recipients) to LawVu and to add categories to emails that have been tracked or saved

offline_access (delegated)

Maintain access to data you have given it access to

Used to allow background email tracking to run when the user is not actively using their Outlook

Optional Permissions for Shared Mailbox support

The LawVu for Outlook add-in supports shared mailboxes without the email tracking features. However, additional permissions must be consented to before using the add-in with a shared mailbox.

Permission

Purpose

User.ReadBasic.All (delegated)

Used to read basic information about the shared mailbox when processing messages

Mail.ReadWrite.Shared (delegated)

Used to read mail to support uploading of content, attachments and metadata (subject, sender, recipients) to LawVu and to add categories to emails that have been tracked or saved for shared mailboxes

Please note that LawVu's mail tracking features are not supported in shared mailboxes.

Did this answer your question?