...
Expand | ||
---|---|---|
| ||
CAM App RegistrationThis process allows adding the CAM App (by Litera) via the Azure Active Directory. User/organization can be imported to the Teams app once the registration completes. For iManage M365 App Proxy, see iManage Note: The following details are required when configuring M365 in CAM using External System Configuration:
|
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Microsoft Graph Permissions in M365The following permissions will need to be enabled in the Azure Portal.
Required Permissions to Create or Manage Teams
Optional PermissionsThese permissions are optional and can be added based on your firm’s usage of CAM. | Permission | Type |
Permission | Type | Operation | Description |
---|
Region. |
Application
Used to get custom app detail from app store
Used to display the iManage Teams application in Teams for example inside a tab in a team
Calendars.Read
Application
Read Calendar
Used for reading and visualizing the Calendar tab in the CAM Teams App.
Files.Read.All
Delegated
Read Documents
Used for reading and visualizing the Documents tab in the CAM Teams App.
Mail.Read
Application
Read Mail
ReadWrite | Delegated | Read or write user region | This is an API permission found under ‘Request API Permissions’ and the purpose of this permission is not strictly for private channel creation, but rather to read and write users’ regions in their profiles. A dependency for private channel creation in CAM. Find the permission under APIs my Organization uses->Search for Microsoft Teams Services and add this permission. |
User_impersonation | Delegated | Have full access to the Team service. | Needed for private channel creation. Follow the Manifest instructions below in Step 3 to add. The Sharepoint site won’t get created without this. Add this by APIs my Organization uses->Search for User_impersonation and add this permission. |
Optional Permissions
These permissions are optional and can be added based on your firm’s usage of CAM.
Permission | Type | Operation | Description |
AppCatalog.Read.All | Application | Used to get custom app detail from app store | Used to display the iManage Teams application in Teams for example inside a tab in a team |
Calendars.Read | Application | Read Calendar | Used for reading and visualizing the Calendar tab in the CAM Teams App. |
Files.Read.All | Delegated | Read Documents | Used for reading and visualizing the Documents tab in the CAM Teams App. |
Mail.Read | Application | Read Mail | Used for reading mail and visualizing the Calendar tab in the CAM Teams App. |
Notes.ReadWrite.All | Application | OneNote | Read and write all OneNote notebooks and use OneNote in Teams. |
TasksSharepoint.ReadWrite.All | Delegated | Sharepoint access | Allows to use sharepoint. Set as Write access. |
Tasks.ReadWrite | Application | Create, read, update, and delete user’s planner tasks and task lists. | Allows creating, reading and updating planner tasks and lists. |
TeamMember.Read. All | Application | Read Team Members within the CAM Teams app | Read the members of all teams so they can be shown in the CAM Teams app. |
TeamsAppInstallation.ReadForTeam.All | Application | Read the app name | Get the name of app in the app store of Teams. Sets it as a custom tab.
|
User.invite.All | Application | Adding/Inviting external users to team and channel | Invite guest/external users to the Teams organization. |
User.Read.All | Application | Read Directory | Used for reading and visualizing the Directory (Person) tab in the CAM Teams App. |
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Private ChannelCAM uses Azure AD - Microsoft Graph API - to access resources in M365 to create Groups and Teams. When you create a private channel, it has its own SharePoint site collection. The separate site collection is to ensure access to that private channel files are restricted to only members of the private channel compared to the team site where team owners have access to all the assets within the site collection. The site collection created using private channels as per Microsoft documentation is not visible in the SharePoint admin center unless someone manually clicks on the Files tab in teams once the SharePoint site will be available in 1-2 min or almost instantly. To trigger the click event on the Files tab, CAM needs the Microsoft native API permission which can be added by following the steps -
10. Click Save. 11. Now click on API permissions on the left bar. 12. On the right side, scroll down till the end. 13. Under "Microsoft Teams Services (1)", it will list user_impersonation under Microsoft Teams Services, status as Not granted for <global admin user>. 14. In order to provide admin consent, scroll to the top of the page and click on select Grant admin consent for <global admin user>. 15. Confirmation message pop up displays, select “Yes”, add other granted permissions to configured permissions.
Snapshot of Manifest |
Expand | ||||
---|---|---|---|---|
| ||||
Service Account Permission - Use Planner in TeamsNote: If you would like to have Microsoft's Planner app within MS Teams, refer to Microsoft’s Planner app documentation. To be able to create the Planner tab in Team Channels, Microsoft requires that delegated / service account users be created and is a member of the team. However, to build a team, there must be an appointed owner. Because of this requirement, you need an additional service account so that you can switch to it to create a planner.
Configuration in CAM PlannerFollow the steps to create a Planner inside a Channel. Follow these steps to create a Planner.
Note: Microsoft has a restriction, only group members can access Planners. As group owners cannot access Planners, you need an additional service account (group member) to create a Planner. Token roles can be assigned to group members while creating a planner. After a group member creates the Planner, the token role can be reassigned to the owner. A token role is assigned to a group member so that the group member is able to receive the token and approve the creation of planners.
|
Note |
---|
Warning: Ensure the Additional Service Account is set in the External System configuration. |
Expand | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
Connecting M365 with the CAM PlatformTo add a New M365 Connection to the CAM Platform
Click Save. If you have not gathered the clientid/client secret already, please follow the step below. Anchor | | ClientReg | ClientReg | immediately, go to your site in the following format: https://contoso.sharepoint.com/_layouts/15/appregnew.aspx|||||||||||||||||||||
Field | Description | Name | Enter a name for the M365 configuration. This is a required field. The preferred
Field | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Name | Enter a name for the M365 configuration. This is a required field. The preferred default name is: M365 SharePoint Online Application ID | ||||||||
Auth URL | The URL of the M365 portal. This is a required field. By default this is: Multi-tenant - https://login.This is based on your firm’s implementation of tenants. If you have two tenants (e.g. production and staging or two different CAM instances), select multi-tenant. By default, this is: Multi-tenant - https://login.microsoftonline.com/common/oauth2/v2.0/authorize Single tenant - https://login.microsoftonline.com/(Directory(Tenant) Id)/oauth2/v2.0/authorize Note: Based on the your selection of singletenant or multitenant the Auth URL will change. Do note these URLs are using OAuth2 authentication. | ||||||||
Directory(Tenant) Id | Enter the Directory Id from the Azure Active Directory Portal. Please see Step 1: CAM App Registration in M365 for instructions | ||||||||
Application Id
| Enter the Application (client) ID from the Azure Active Directory Portal. Please see Step 1: CAM App Registration in M365 for instructions | ||||||||
Application Password
| Enter the application password. Please see Step 1: CAM App Registration in M365 for instructions. This is the Client Secret that you saved in Step 1. | ||||||||
SharePoint URL (applicable if connecting sharepoint) | Enter the SharePoint URL to access. For e.g. https://<sitename>.sharepoint.com | SharePoint Resource | This string is used to connect CAM directly | ||||||
Is Sharepoint Permissions on Entra Enabled EntraId Settings | If using Entra ID for Sharepoint, and confirm EntraId is configured in the client Office365, click Yes. The options update where the client secret, key and name disappear as these are not needed. Set No if you are using the Azure AD or the old methods of authentication. Do note the old Azure ACS authentication method is retired, per Microsoft A benefit of using Entra is you don’t need to re-register the client application each year to prevent token expiry. Steps to enable EntraId
| ||||||||
SharePoint Resource (applicable if connecting sharepoint) |
The SharePoint Resource is comprised of three values:
Note the resource string is the same for all systems.
The information must be entered in the format 00000003-0000-0ff1-ce00-000000000000/M365TenantId.sharepoint.com@Directory (Tenant) Id | ||||||||
SharePoint Client Id (applicable if connecting sharepoint) |
Format: 2f1af3fc-74b2-4825-b355-591f0abcd3fd | ||||||||
SharePoint Client Secret (applicable if connecting sharepoint) | Enter the Application Password (entered earlier in the Application Password field above). Application password=client secretearlier in the Application Password field above). Application password=client secret | ||||||||
App Domain (applicable if connecting sharepoint) | This is the following format replacing tenant name with your tenant: | ||||||||
Redirect URl (applicable if connecting sharepoint) | This is in the following format: https://tenantname.sharepoint.com/default.aspx | ||||||||
Additional Service Account | For the Microsoft Planner tab, create a new user at M365 and provide an email addressIf you are using Planner, and you haven’t created a planner user yet, follow this step: https://pdocs.atlassian.net/wiki/spaces/CCAM/pages/30244896/M365+with+CAM+configuration#Service-Account-Permission---Use-Planner-in-Teams . This should be listed here. This account should be any account other than the Token user. It can be any user with no specific requirement. | ||||||||
App Permissions (applicable if connecting sharepoint) | This will set permissions for Sharepoint to work with CAM using an app principal.
| ||||||||
Get Token
| Click the Get Token button, to log in to the M365 URL specified above. On successful login, the token is displayed here.
| ||||||||
Is Default | Select Yes to set as the default external system. | ||||||||
Last Refreshed | The last updated date and time when changed. | ||||||||
Dynamic Group | Select Yes to create a dynamic group in the M365 workspace. Selecting this option will allow you to add multiple users to the to the security list of the workspace. Read dynamic groups for more details to create and add users to the group. | ||||||||
Default Matter Container | Select the value from the drop down list. The accepted values are -
|
M365 Role Mapping
Click Edit Configuration in the Office 365 external System Configuration.
At the bottom, select the CAM Roles. Map them to the Office 365 role permissions.
Member
Owner
Click Save.
The configured O365 Authentication(s) displayed in the M365 tab is as follows:
To set up Group Name Rules, see the section below.
To set up Metadata Mapping section, see the section below.
Editing an Existing Configuration
Click the Edit button in the Action column for the section to be edited (Authentication, Group Name Rules, Metadata Mapping).
Make the changes necessary.
Click Save.
Expand | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
Group Name RulesDefine the M365 group names rules and format to be applied.
The configured group name rule(s) display in the table with the following columns:
|
Expand | |||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||
Metadata MappingMap the metadata for M365 group with these steps.
The completed metadata displays in the following columns in the table:
|
Expand | ||
---|---|---|
| ||
M365 - Add Guest AccountGuest Accounts can be created in CAM for M365. If creating guest accounts externally, there are no password requirements, but a password can be set, as the user is created temporarily without a profile. Invite Guest Users from Request Workflow -> Default Security Or upload CSV. |
Expand | ||
---|---|---|
| ||
M365 - User Default PasswordWhen creating users, a default password can be set. How to create a default password:
|
...