MSGraphPermissions: Difference between revisions

From UmsWiki
Jump to navigation Jump to search
Kia (talk | contribs)
Kia (talk | contribs)
Line 82: Line 82:
Click "Add a permission"
Click "Add a permission"
[[File:Graph8.png|none|thumb|780x780px]]
[[File:Graph8.png|none|thumb|780x780px]]
======API og tilladelser======
'''SharePoint'''
{| class="wikitable"
|-
|Sites.FullControl.All
|Application
|Have full control of all site collections
|-
|Sites.Manage.All
|Application
|Read and write items and lists in all site collections
|-
|Sites.ReadWrite.All
|Application
|Read and write items in all site collections
|-
|User.ReadWrite.All
|Application
|Read and write user profiles
|}


==Setup UMS to use Application just Created==
==Setup UMS to use Application just Created==
Line 218: Line 197:
|}
|}
{| class="wikitable sortable"
{| class="wikitable sortable"
|+Teams sync permissions
|+SharePoint sync permissions
!Permission name
!Permission name
!Permission type
!Permission type
Line 225: Line 204:
!Used by
!Used by
|-
|-
|EduRoster.ReadWrite.All
|Sites.FullControl.All
|Application
|Application
|Microsoft Graph
|Microsoft Graph
|Allows the UMS to handle users on roster
|Have full control of all site collections
|Live_at_edu.exe
|Office365_SP_OneNote.exe
|-
|-
|Member.Read.Hidden
|Sites.Manage.All
|Application
|Application
|Microsoft Graph
|Microsoft Graph
|Allows the UMS to handle users on roster
|Read and write items and lists in all site collections
|Live_at_edu.exe
|Office365_SP_OneNote.exe
|-
|-
|TeamMember.ReadWrite.All
|Sites.ReadWrite.All
|Application
|Application
|Microsoft Graph
|Microsoft Graph
|Used to add or remove users from Team
|Read and write items in all site collections
|Live_at_edu.exe
|Office365_SP_OneNote.exe
|-
|-
|TeamsTab.ReadWrite.All
|User.ReadWrite.All
|Application
|Application
|Microsoft Graph
|Microsoft Graph
|Used to create tabs in teams
|Read and write user profiles
|Live_at_edu.exe
|Office365_SP_OneNote.exe
|-
|TeamsAppInstallation.ReadForTeam.All
|Application
|Microsoft Graph
|Used to install app in teams
|Live_at_edu.exe
|-
|Team.Create
|Application
|Microsoft Graph
|Used to create Teams
|Live_at_edu.exe
|-
|Team.ReadBasic.All
|Application
|Microsoft Graph
|Used to read teams
|Live_at_edu.exe
|}
|}
{| class="wikitable sortable"
{| class="wikitable sortable"
|+Teams sync permissions
|+OneNote sync permissions
!Permission name
!Permission name
!Permission type
!Permission type
Line 275: Line 236:
!Used by
!Used by
|-
|-
|EduRoster.ReadWrite.All
|
|Application
|Microsoft Graph
|Allows the UMS to handle users on roster
|Live_at_edu.exe
|-
|Member.Read.Hidden
|Application
|Microsoft Graph
|Allows the UMS to handle users on roster
|Live_at_edu.exe
|-
|TeamMember.ReadWrite.All
|Application
|Microsoft Graph
|Used to add or remove users from Team
|Live_at_edu.exe
|-
|TeamsTab.ReadWrite.All
|Application
|Microsoft Graph
|Used to create tabs in teams
|Live_at_edu.exe
|-
|TeamsAppInstallation.ReadForTeam.All
|Application
|Microsoft Graph
|Used to install app in teams
|Live_at_edu.exe
|-
|Team.Create
|Application
|Microsoft Graph
|Used to create Teams
|Live_at_edu.exe
|-
|Team.ReadBasic.All
|Application
|Application
|Microsoft Graph
|Microsoft Graph
|Used to read teams
|
|Live_at_edu.exe
|Office365_SP_OneNote.exe
|}
|}

Revision as of 08:27, 24 June 2021

MS graph permissions is a UMS backend requirement from version 8.5.203 which was released in June 2021"

MS graph permissions are required by these UMS modules (LiveAtEdu,OneNote, Sharepoint and MS Teams)


Creating App Registration

Go to Azure Portal and login with you admin account( the same UMS uses).

!!! ATTENTION !!! use service account that UMS uses

When logged in go to Azure Active Directory:













Go to App registrations


Click on New application registration


Give the new App a name ex. "UMSGraph", Choose "Web app / API" in Application type, set "Sign-on URL" to "http://localhost". After setting Application Permission values click "Create"

You will return to previous screen, here click "your new app"


Click "Certificates & secrets"

Click "New Client Secret"

Enter a "Description" and set "Expires" to the interval that suits your needs.

Click "Add"


Copy "Value ID" We will use this later

!!! ATTENTION !!! the key value will never be visible again so ensure to copy it.


Copy the "VALUE Key into "UMS Configurator" field Client Secret


Copy the "Directory Tenant ID " into "UMS Configurator" Field Tenant ID

Copy the "Appplication Client ID " into "UMS Configurator" Field Client ID


Click "Api permissions"

Click "Add a permission"

Setup UMS to use Application just Created

In the UMS Configurator go to Modules->Office 365 and click "SharePoint organization settings"

Choose your SharePoint organization setting and click "Edit..."

Input your "Tenant Name" ex. "cortenso.onmicrosoft.com", paste the previously copied Application ID into "Client ID" field and paste previously copied KEY into "Client secret" and click "Ok"

File:UMSConfiguratorSharepointOrganizationSettingsEditWindow.png

You are now all set to use the new MS Graph integration.

Permissions overview


Default permissions
Permission name Permission type API Used for Used by
User.ReadWrite.All Application Microsoft Graph Setting attributes on the user in Office 365 Live_at_edu.exe
Group.ReadWrite.All Application Microsoft Graph Setting group attributes on Office 365 groups Live_at_edu.exe
GroupMember.ReadWrite.All Application Microsoft Graph Manage GroupMembers in Office 365 Live_at_edu.exe
Directory.ReadWrite.All Application Microsoft Graph Setting attributes on the user in Azure Active Directory Live_at_edu.exe
MailboxSettings.ReadWrite Application Microsoft Graph Used to set mailbox settings in Office 365.

Used to get/create categories

Live_at_edu.exe

Skemabrikker.exe

Calendars.ReadWrite Application Microsoft Graph Used to allow UMS to sync calendar events to Office 365 Skemabrikker.exe
Files.ReadWrite.All Application Microsoft Graph Used to provision OneDrive for users Live_at_edu.exe
Teams sync permissions
Permission name Permission type API Used for Used by
EduRoster.ReadWrite.All Application Microsoft Graph Allows the UMS to handle users on roster Live_at_edu.exe
Member.Read.Hidden Application Microsoft Graph Allows the UMS to handle users on roster Live_at_edu.exe
TeamMember.ReadWrite.All Application Microsoft Graph Used to add or remove users from Team Live_at_edu.exe
TeamsTab.ReadWrite.All Application Microsoft Graph Used to create tabs in teams Live_at_edu.exe
TeamsAppInstallation.ReadForTeam.All Application Microsoft Graph Used to install app in teams Live_at_edu.exe
Team.Create Application Microsoft Graph Used to create Teams Live_at_edu.exe
Team.ReadBasic.All Application Microsoft Graph Used to read teams Live_at_edu.exe
SharePoint sync permissions
Permission name Permission type API Used for Used by
Sites.FullControl.All Application Microsoft Graph Have full control of all site collections Office365_SP_OneNote.exe
Sites.Manage.All Application Microsoft Graph Read and write items and lists in all site collections Office365_SP_OneNote.exe
Sites.ReadWrite.All Application Microsoft Graph Read and write items in all site collections Office365_SP_OneNote.exe
User.ReadWrite.All Application Microsoft Graph Read and write user profiles Office365_SP_OneNote.exe
OneNote sync permissions
Permission name Permission type API Used for Used by
Application Microsoft Graph Office365_SP_OneNote.exe