MSGraphPermissions: Difference between revisions
No edit summary |
|||
Line 5: | Line 5: | ||
When logged in goto Azure Active Directory: | When logged in goto Azure Active Directory: | ||
[[File:MSGraph1.png|thumb|none]] | [[File:MSGraph1.png|thumb|none|900x900px]] | ||
Go to App registrations | Go to App registrations | ||
[[File:MSGraph2.png|thumb|none]] | [[File:MSGraph2.png|thumb|none|900x900px]] | ||
Click on New application registration | Click on New application registration | ||
[[File:MSGraph3.png|thumb|none]] | [[File:MSGraph3.png|thumb|none|900x900px]] | ||
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" | 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" | ||
[[File:MSGraph4.png|thumb|none]] | [[File:MSGraph4.png|thumb|none|900x900px]] | ||
You will return to previous screen, here click "your new app" | You will return to previous screen, here click "your new app" | ||
[[File:MSGraph5.png|thumb|none]] | [[File:MSGraph5.png|thumb|none|900x900px]] | ||
Click "Required permissions" | Click "Required permissions" | ||
[[File:MSGraph6.png|thumb|none]] | [[File:MSGraph6.png|thumb|none|900x900px]] | ||
Click "Add" | Click "Add" | ||
[[File:MSGraph7.png|thumb|none]] | [[File:MSGraph7.png|thumb|none|900x900px]] | ||
Click "Select an API" | Click "Select an API" | ||
[[File:MSGraph8.png|thumb|none]] | [[File:MSGraph8.png|thumb|none|900x900px]] | ||
Click "Microsoft Graph" | Click "Microsoft Graph" | ||
[[File:MSGraph9.png|thumb|none]] | [[File:MSGraph9.png|thumb|none|900x900px]] | ||
Click "Select" | Click "Select" | ||
[[File:MSGraph10.png|thumb|none]] | [[File:MSGraph10.png|thumb|none|900x900px]] | ||
Click the left topmost checkbox next to "APPLICATION PERMISSIONS", and scroll down to next section. | Click the left topmost checkbox next to "APPLICATION PERMISSIONS", and scroll down to next section. | ||
[[File:MSGraph11.png|thumb|none]] | [[File:MSGraph11.png|thumb|none|900x900px]] | ||
Click the checkbox next to "DELEGATED PERMISSIONS" | Click the checkbox next to "DELEGATED PERMISSIONS" | ||
[[File:MSGraph13.png|thumb|none]] | [[File:MSGraph13.png|thumb|none|900x900px]] | ||
Click "Select" | Click "Select" | ||
[[File:MSGraph15.png|thumb|none]] | [[File:MSGraph15.png|thumb|none|900x900px]] | ||
Click "Done" | Click "Done" | ||
[[File:MSGraph16.png|thumb|none]] | [[File:MSGraph16.png|thumb|none|900x900px]] | ||
Click "Add" again | Click "Add" again | ||
Line 51: | Line 51: | ||
Click "Office 365 SharePoint Online" | Click "Office 365 SharePoint Online" | ||
[[File:MSGraph17.png|thumb|none]] | [[File:MSGraph17.png|thumb|none|900x900px]] | ||
Click "Select", as before - click the checkbox next to "APPLICATION PERMISSIONS" and "DELEGATED PERMISSIONS" and click Select. | Click "Select", as before - click the checkbox next to "APPLICATION PERMISSIONS" and "DELEGATED PERMISSIONS" and click Select. | ||
Line 60: | Line 60: | ||
Click "OneNote" | Click "OneNote" | ||
[[File:MSGraph18.png|thumb|none]] | [[File:MSGraph18.png|thumb|none|900x900px]] | ||
Click "Select", as before - click the checkbox next to "APPLICATION PERMISSIONS" and "DELEGATED PERMISSIONS" and click Select. | Click "Select", as before - click the checkbox next to "APPLICATION PERMISSIONS" and "DELEGATED PERMISSIONS" and click Select. | ||
Line 71: | Line 71: | ||
Now click "Grant Permissions" | Now click "Grant Permissions" | ||
[[File:MSGraph19.png|none|thumb]] | [[File:MSGraph19.png|none|thumb|900x900px]] | ||
Click "Yes" | Click "Yes" | ||
[[File:MSGraph20.png|none|thumb]] | [[File:MSGraph20.png|none|thumb|900x900px]] | ||
Permissions are now set. | Permissions are now set. | ||
Click "Properties" | Click "Properties" | ||
[[File:MSGraph21.png|none|thumb]] | [[File:MSGraph21.png|none|thumb|900x900px]] | ||
Copy "Application ID" into Configurator ([[#SharePointOrganizationSettings|see last Picture]]) . | Copy "Application ID" into Configurator ([[#SharePointOrganizationSettings|see last Picture]]) . | ||
[[File:MSGraph22.png|none|thumb]] | [[File:MSGraph22.png|none|thumb|900x900px]] | ||
Click "Keys" | Click "Keys" | ||
[[File:MSGraph23.png|none|thumb]] | [[File:MSGraph23.png|none|thumb|900x900px]] | ||
Set "DESCRIPTION" to ex. "UMS1" and choose "Never expires" in the "EXPIRES" Setup dropdown | Set "DESCRIPTION" to ex. "UMS1" and choose "Never expires" in the "EXPIRES" Setup dropdown | ||
[[File:MSGraph24.png|none|thumb]] | [[File:MSGraph24.png|none|thumb|900x900px]] | ||
Click "Save" | Click "Save" | ||
[[File:MSGraph25.png|none|thumb]] | [[File:MSGraph25.png|none|thumb|900x900px]] | ||
Copy the Key in the "VALUE" into Configurator ([[MSGraphPermissions#SharePointOrganizationSettings|see last Picture]]) !!! ATTENTION !!! the key value will never be visible again so ensure to copy it. | Copy the Key in the "VALUE" into Configurator ([[MSGraphPermissions#SharePointOrganizationSettings|see last Picture]]) !!! ATTENTION !!! the key value will never be visible again so ensure to copy it. | ||
[[File:MSGraph26.png|none|thumb]] | [[File:MSGraph26.png|none|thumb|900x900px]] | ||
== Setup UMS to use Application just Created == | == Setup UMS to use Application just Created == | ||
In the UMS Configurator go to Modules->Office 365 and click "SharePoint organization settings" | In the UMS Configurator go to Modules->Office 365 and click "SharePoint organization settings" | ||
[[File:UMSConfiguratorSharepointOrganizationSettings.png|none|thumb]] | [[File:UMSConfiguratorSharepointOrganizationSettings.png|none|thumb|600x600px]] | ||
Choose your SharePoint organization setting and click "Edit..." | Choose your SharePoint organization setting and click "Edit..." | ||
[[File:UMSConfiguratorSharepointOrganizationSettingsEdit.png|none|thumb]] | [[File:UMSConfiguratorSharepointOrganizationSettingsEdit.png|none|thumb|600x600px]] | ||
<span id="SharePointOrganizationSettings">Input</span> 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" | <span id="SharePointOrganizationSettings">Input</span> 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|none|thumb]] | [[File:UMSConfiguratorSharepointOrganizationSettingsEditWindow.png|none|thumb|600x600px]] | ||
You are now all set to use the new MS Graph integration. | You are now all set to use the new MS Graph integration. | ||
__FORCETOC__ | __FORCETOC__ |
Revision as of 10:52, 5 December 2017
Setting MSGraph Permissions a long with Azure active directory, OneNote and SharePoint permissions is necessary for UMS to obtain access to the functions needed to create OneNote Class Notebooks and upcoming Teams integration.
Creating App Registration
Go to Azure Portal and login with you admin account( the same UMS uses).
When logged in goto 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 "Required permissions"
Click "Add"
Click "Select an API"
Click "Microsoft Graph"
Click "Select"
Click the left topmost checkbox next to "APPLICATION PERMISSIONS", and scroll down to next section.
Click the checkbox next to "DELEGATED PERMISSIONS"
Click "Select"
Click "Done"
Click "Add" again
Click "Select an API"
Click "Office 365 SharePoint Online"
Click "Select", as before - click the checkbox next to "APPLICATION PERMISSIONS" and "DELEGATED PERMISSIONS" and click Select.
Click "Done"
Click "Add" again and "Select an API"
Click "OneNote"
Click "Select", as before - click the checkbox next to "APPLICATION PERMISSIONS" and "DELEGATED PERMISSIONS" and click Select.
Click "Done"
Click "Windows Azure Active Directory" Permission.
Click the checkbox next to "APPLICATION PERMISSIONS" and "DELEGATED PERMISSIONS" and click "Save"
Now click "Grant Permissions"
Click "Yes"
Permissions are now set.
Click "Properties"
Copy "Application ID" into Configurator (see last Picture) .
Click "Keys"
Set "DESCRIPTION" to ex. "UMS1" and choose "Never expires" in the "EXPIRES" Setup dropdown
Click "Save"
Copy the Key in the "VALUE" into Configurator (see last Picture) !!! ATTENTION !!! the key value will never be visible again so ensure to copy it.
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..."
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"
You are now all set to use the new MS Graph integration.