aOS Moscow - R5 - Extend Microsoft graph to fit your business

1. 1
aOS Moscow
9/7/2019
Расширение
Microsoft Graph
Vitaly Zhukov

2. ◦ THANKS TO OUR SPONSORS
2
WebDiamond

3. Привет!
Меня зовут Виталий Жуков
Я давно занимаюсь Office 365/SharePoint
и мне есть что рассказать
office365moscow.ru
3

4. 5
Microsoft 365

5. Windows 10
Device Management (Intune) + SecurityE5E1 E3
Microsoft 365
Phone System
Audio Conferencing
Advanced Threat Protection
Cloud App Security
Advanced eDiscovery
Customer Lockbox
Advanced Data Governance
Service Encryption
Mobile Device Management
Mobile Application Management
Windows Defender SmartScreen
Conditional Access
Information Protection
Threat Protection

6. 7
Microsoft Graph

7. Без Microsoft Graph

8. Microsoft Graph
Microsoft Graph

9. Microsoft Graph
Microsoft Graph

10. Microsoft Graph. API
https://graph.microsoft.com/{version}/{resource}/{id}/{query}?{parameters}
https://graph.microsoft.com/1.0/users/v.zhukov@contoso.com/events
Список событий пользователя
https://graph.microsoft.com/1.0/me/joinedTeams
Список групп Teams текущего пользователя
https://graph.microsoft.com/1.0/users/v.zhukov@contoso.com/planner/tasks
Задачи пользователя в Planner
Формат запроса (GET|POST|PATCH|DELETE)

11. 12
Приложения и Права

12. Microsoft Graph. Приложения
Приложение доступно в рамках одного тенанта
Роли, Права, Политики
Доступно как для Azure AD, так и для персональных Microsoft account
Multi-tenant
Single-tenant

13. Microsoft Graph. Права
{Resource}.{Action}.{Scope}
AppCatalog.ReadWrite.All
Чтение и запись во всех каталогах приложений
Именование прав
Bookings.Manage
Чтение и запись сведений о встречах, компаниях, клиентах, службах и персонале
Calendars.Read
Чтение пользовательских календарей

14. Microsoft Graph. Права
Delegated Permissions Application Permissions
Delegated
permissions
User
privileges
Application
permissions
Effective Permissions

15. 16
Open Extension

16. Microsoft Graph. Создание расширения
{
"@odata.type“: "microsoft.graph.openTypeExtension",
"extensionName": "Com.VitalyZhukov.Social",
"Facebook": "http://www.facebook.com/zhukovv",
"Linkedin": "http://ru.linkedin.com/in/zhukovvitaly",
"Twitter": "https://twitter.com/vzhukov86",
"UpdateDate": "2019-07-20T00:00:00.000Z"
}
POST: https://graph.microsoft.com/v1.0/users/user@ms365.tech/extensions

17. Microsoft Graph. Обновление расширения
{
"@odata.type“: "microsoft.graph.openTypeExtension",
"extensionName": "Com.VitalyZhukov.Social",
"Facebook": "http://www.facebook.com/zhukovv",
"Linkedin": "http://ru.linkedin.com/in/zhukovvitaly",
"Twitter": "https://twitter.com/vzhukov86",
"UpdateDate": "2019-07-20T00:00:00.000Z"
}
PATCH:
https://graph.microsoft.com/v1.0/users/user@ms365.tech/extensions/Com.VitalyZhukov.Social

18. Microsoft Graph. Чтение расширения
{
"@odata.type“: "microsoft.graph.openTypeExtension",
"extensionName": "Com.VitalyZhukov.Social",
"Facebook": "http://www.facebook.com/zhukovv",
"Linkedin": "http://ru.linkedin.com/in/zhukovvitaly",
"Twitter": "https://twitter.com/vzhukov86",
"UpdateDate": "2019-07-20T00:00:00.000Z"
}
GET: https://graph.microsoft.com/v1.0/users/user@ms365.tech/extensions/Com.VitalyZhukov.Social

19. Microsoft Graph. Чтение расширения
{
"displayName": "Vitaly Zhukov",
"surname": "Zhukov",
"extensions": [{
"@odata.type": "#microsoft.graph.openTypeExtension",
"extensionName": "Com.VitalyZhukov.Social",
"Facebook": "http://www.facebook.com/zhukovv",
"Linkedin": "http://ru.linkedin.com/in/zhukovvitaly",
"Twitter": "https://twitter.com/vzhukov86",
"UpdateDate@odata.type": "#DateTimeOffset",
"UpdateDate": "2019-07-21T00:00:00Z",
"id": "Com.VitalyZhukov.Social"
}]
}
GET: https://graph.microsoft.com/v1.0/users/
?$filter=surname eq 'Zhukov’
&$expand=extensions($filter=id eq 'Com.VitalyZhukov.Social')

20. 21
Schema Extension

21. Graph. Создание расширения схемы
{
"id": "aosextensions",
"description": "Demo extension",
"targetTypes": ["User"],
"owner" : "e41aa88d-385e-4973-9211-7f66bd8930bb",
"properties": [
{"name": "ticketid", "type": "String"},
{"name": "trackid", "type": "Integer"}
]
}
POST: https://graph.microsoft.com/v1.0/schemaExtensions

22. Graph. Активация расширения схемы
{
"status": "Available",
"owner" : "e41aa88d-385e-4973-9211-7f66bd8930bb"
}
PATCH: https://graph.microsoft.com/v1.0/schemaExtensions/ext3doh72f4_aosextensions

23. Graph. Редактирование расширения схемы
{
"displayName": "Vitaly Zhukov",
"ext3doh72f4_aosextensions":{
"ticketid": "001",
"trackid": 1
}
}
PATCH: https://graph.microsoft.com/v1.0/users/v.zhukov@ms365.tech

24. Graph. Чтение расширения схемы
{
"id": "d7be6981-f700-4528-9180-9be5276f7a14",
"ext3doh72f4_aosextensions": {
"@odata.type": "#microsoft.graph.ComplexExtensionValue",
"trackid": 1,
"ticketid": "001"
}
}
GET: https://graph.microsoft.com/v1.0/users/v.zhukov@ms365.tech
?$filter=surname eq 'Zhukov'
&$select=ext3doh72f4_aosextensions

25. 26
Выводы

26. Microsoft Graph. Права
Delegated Permissions
• Получение доступа к данным от имени пользователя
• Web-приложения, приложения для мобильных девайсов
Application Permissions
• Получение доступа ко всем данным
• Только для IT-администраторов

27. Open Extension vs Schema Extension
Open Extension
• Нет типизации свойств
• Не требует приложения
• Не имеет статуса
Schema Extension
• Явная типизация и перечень
свойств
• Требуется приложение
владелец
• Статус расширения
• InDevelopment
• Active

28. Microsoft Graph. Throttling
HTTP 429 Too Many Requests
• Повторный запрос только после времени, указанного в заголовке
Retry-After
• При массовых операциях, 429 статус может быть выдан на
конкретную операцию, а не на весь batch

29. 30
Спасибо за внимание!