Не так давно у Microsoft был (хотя он попрежнему есть ) целый набор модулей PowerShell для многих её облачных сервисов: Azure AD, Exchange Online, Skype for Business Online, SharePoint Online и т.д. Однако, время не стоит на месте и число облачных сервисов в Azure неуклонно растет. Вместе с ростом количества сервисов растет и потребность в инструментах управления.
Разработчики так же вынуждены были использовать API каждого продукта в отдельности. Именно потребность в единой точке управления всеми облачными сервисами и призван закрыть сервис Microsoft Graph. Он позволяет через свои API методы получить доступ ко многим сервисам и объектам в Azure – будь то пользователь Azure AD или его календарь в почтовом ящике Exchange Online.
Graph довольно сильно облегчил жизнь не только разработчикам, но и администраторам Azure.
Ниже мы кратко поговорим об общей архитектуре сервиса, а также какие инструменты есть в нашем распоряжении для работы с сервисом Microsoft Graph.
Общее описание сервиса Microsoft Graph
В этом разделе мы познакомимся с кратким описание сервиса Graph. С подробным описанием сервиса можно ознакомится в документации на сайте Microsoft.
Check required permissions for Microsoft Graph in the Graph Explorer
Сам по себе сервис Graph выступает в роли единой точкой входя для работы со многими объектами Azure: пользователи, устройства, календари, почта и т.д. Основные компоненты сервиса приведены ниже:
- Microsoft Graph API. Именно через API мы можем получить доступ к управлению большим количеством разнообразных объектов – от чтения атрибутов пользователя в Azure AD до отправки писем через Exchange Online.
- Microsoft Graph connectors. Позволяет еще больше расширить сервис Microsoft Graph через подключение дополнительные источников данных к нему.
- Microsoft Graph Data Connect. Этот сервис также позволяет работать с объектами, как и Graph API, но с более расширенными возможностями.
Далее мы будем говорить только о первом компоненте – Microsoft Graph API : как к нему можно подключиться и рассмотрим пару примеров с запросами на выборку данных.
Инструменты работы с Microsoft Graph
Для работы с Microsoft Graph API существует несколько инструментов. Каждый из них имеет свои достоинства и недостатки. Лично мне, если нужно что-то быстро посмотреть (и без сложных условий фильтрации) вполне нравится Graph Explorer. Для более сложных случаев использую Postman, но его требуется устанавливать отдельно. Однако, если у вас под рукой только PowerShell, то через него тоже можно работать с Graph API .
Graph API доступен для очень многих языков программирования. Полный перечень приведен в документации.
Graph Explorer
Пожалуй, наиболее простой способ. Из преимуществ этого способа стоит отметить, что не требуется устанавливать дополнительные приложения или регистрировать приложение в Azure AD (чтобы получить токен доступа).
Retrieve a signed-in user’s profile using Microsoft Graph
Из минусов – вам необходим браузер и в Graph Explorere вы можете работать только с Graph API .
Развернутая документация по использованию Graph Explorer доступна по этой ссылке.
Для того, чтобы запустить Graph Explorer нужно:
2. Аутентифицироваться под вашей учетной записью.
Либо вы можете работать под “синтетической” учетной записью. Для данной записи настроен некий набор объектов, к которым вы можете получать доступ выполняя соответствующие запросы.
Пример 1. Получение данных своего профиля пользователя
В левом нижнем углу вам доступен перечень запросов, которые вы можете отправить к Graph API.
Когда вы выберите соответствующий запрос, то его преднастроенные значения перенесутся в основную обасть Graph Explorer.
Использование диаграммы Microsoft Graph в текстовом процессоре Microsoft Word
Диаграммы широко применяются в научно-технической документации. Рассмотрим два метода вставки диаграмм в документ. Первый метод состоит в том, что сначала вставляется произвольная диаграмма, с которой связана произвольная базовая таблица данных.
Затем базовая таблица редактируется путем заполнения нужными данными и производится соответствующая настройка параметров диаграммы. Второй метод основан на том, что диаграмма создается на базе конкретной таблицы, имеющейся в документе. В этом случае необходимо выполнить только настройку внешнего вида.
Создать диаграмму можно командой Вставка -> Объект…. В открывшемся диалоговом окне Вставка объекта выбрать пункт Диаграмма Microsoft Graph 97, после чего в документ вставляется диаграмма.
Динамический обмен данными
DDE предоставляет Windows-приложениям возможность обмена данными друг с другом. Этот интерфейс позволяет использовать многие возможности одного приложения из другого приложения Windows, например, из текстового процессора Microsoft Word можно получить доступ к средствам Microsoft Excel. Приложение (текстовый процессор Microsoft Word), из которого вызывается Microsoft Excel, называется OLE-клиентом. Microsoft Excel в этой ситуации становится OLE- сервером.
Использование DDE может понадобиться, например, для проведения вычислений, которые трудно осуществить в приложении-клиенте. Например, вычислить данные по формулам легче в электронной таблице Microsoft Excel, а оформить отчеты с этими таблицами в текстовом процессоре Microsoft Word.
Некоторые примеры внедрения и связывания объектов и обмена данными между программами в операционной системе Windows
Пример создания внедренного или связанного объекта из существующего файла
В качестве внедренного или связанного объекта выберем файл, содержащий таблицу Microsoft Excel, а в качестве конечного файла — документ Microsoft Word.
Для создания внедренного или связанного объекта из существующего файла необходимо:
— создать документ Microsoft Word;
— выбрать команду Объект… в меню Вставка, а затем вкладку Создание из файла;
— нажать кнопку Обзор… для выбора файла, содержащего таблицу Microsoft Excel из списка;
— установить флажок Связь с файлом для создания связанного объекта, если флажок Связь с файлом не установить, будет создан внедренный объект.
Пример создания нового внедренного объекта
Для создания нового внедренного объекта необходимо:
— выбрать в документе место, куда следует поместить внедренный объект;
— выбрать команду Объект… в меню Вставка, а затем вкладку Создание;
— выбрать тип создаваемого объекта в списке Тип объекта (например, Microsoft Equation 3.0, диаграмма Microsoft Graph 97 и др.).
Пример создания связанного или внедренного объекта на основе данных из открытого документа для обмена данными между программами
Для создания связанного или внедренного объекта на основе данных из открытого документа необходимо:
— выделить данные для связанного или внедренного объекта (например, данные в таблице Excel);
— нажать кнопку Копировать;
— перейти к файлу, в который будут помещены данные (например, к файлу с документом Microsoft Word);
— выбрать команду Специальная вставка в меню Правка;
— для создания связанного объекта выбрать Связать, а для создания внедренного объекта выбрать Вставить;
— в списке Как: выбрать значение, содержащее слово объект.
Пример создания приглашения с картинкой
Уважаемый господин Иванов Иван Иванович!
| Приглашаем Вас на собрание общества «Союз студентов России». |
Будем рады видеть Вас и Ваших друзей.
| На вечере Вы можете посмотреть студенческое шоу и посетить студенческий бар. |
| Президент общества «Союз студентов России» Голубев И.К. 30 ноября 2001 года |
Задания и порядок выполнения
Варианты для заданий № 1, 2, 3, 4 определяются преподавателем.
Задание № 1
1. Создать таблицу Microsoft Excel в соответствии с вариантом и сохранить на диске.
2. Внедрить исходный документ с таблицей Microsoft Excel в конечный документ Microsoft Word. Отредактировать исходный документ с таблицей и посмотреть внеслись ли сделанные изменения в конечном документе.
3. Связать исходный документ с таблицей Microsoft Excel и конечный документ Microsoft Word (в качестве связанного объекта выбрать документ с таблицей). Отредактировать исходный документ с таблицей Microsoft Excel и убедиться в изменении объекта конечного документа.
Задание № 2
1. Изучить возможности математического редактора формул.
2. Создать математическую формулу с использованием Microsoft Equation 3.0 в документе Microsoft Word в соответствии с вариантом.
Задание № 3
1. Изучить возможности Microsoft Graph 97, используемого для создания диаграмм в текстовом процессоре Microsoft Word.
2. Cоздать диаграмму с помощью Microsoft Graph 97 в документе Microsoft Word, используя данные, полученные в электронной таблице Microsoft Excel (см. пункт 1 в задании № 1).
Задание № 4
1. Создать связанный и внедренный объект в текстовом процессоре Microsoft Word на основе данных из существующего документа Microsoft Excel (предварительно необходимо его создать в соответствии с заданием).
2. Отредактировать данные в исходном документе.
3. Убедиться в изменении объекта конечного документа.
Задание № 5
Взаимно расположите текст и объект на странице с обтеканием этого текста (на примере картинок). Творческое задание: самостоятельно создать рекламное объявление или приглашение, содержащее одну или несколько картинок.
Контрольные вопросы
1. Перечислите основные способы обмена данными между программами в операционной системе Windows.
2. Как осуществить внедрение и связывание объектов из существующего файла?
3. Каким образом можно внедрить новый объект?
4. Сравните методы внедрения и связывания объектов.
5. Какие приложения называют OLE-серверами и OLE-клиентами?
6. Как осуществить ввод формул и установить настройки для редактирования формул?
7. Какие два метода вставки диаграмм в документ известны?
8. Что означает динамический обмен данными?
Рекомендуемая литература
1. Информатика. Базовый курс / Симонович С.В. и др. — СПб: Питер, 2001.
2. Фигурнов В.Э. IBM PC для пользователя. Краткий курс.- М.: ИНФРА-М, 1999.
Источник: poisk-ru.ru
Что Microsoft известно о вас, и как эту информацию можно использовать для получения полезных знаний
Значительная часть моих ежедневных действий на компьютере и смартфоне выполняется с помощью приложений Microsoft. Отправить электронную почту, создать заметку в календаре, просмотреть файлы в облачном хранилище, обменяться сообщениям в рабочих группах — все эти операции так или иначе выполняются приложениями Microsoft. Нравится мне это или нет, все мои данные хранятся в Microsoft Cloud. У Microsoft имеется полезный инструмент — API-интерфейс, предоставляющий доступ к большей части таких данных и позволяющий управлять ими, так почему бы им не воспользоваться для получения полезной информации?
В этой статье представлено полное руководство по созданию собственного приложения Dashboard с использованием API Microsoft Graph и Django для анализа данных платформ OneDrive, Outlook и др.
Чтобы понять, о чём пойдет речь в этой статье, взгляните на следующий скриншот. Из статьи вы узнаете:
- о моём опыте работы с API, о том, как самому создавать запросы для доступа к данным;
- о том, как работает процесс аутентификации, предоставляющий приложениям необходимые разрешения;
- о том, как осуществляются обработка и визуализация данных в Django.
Оглавление
- Краткое руководство по Microsoft Graph — быстрый способ начать работу с API Microsoft Graph.
- OAuth 2.0 — как работает процесс регистрации в системе.
- Запрос данных с использованием Graph API.
- Анализ и визуализация данных с помощью Plotly.
- Выводы.
Краткое руководство по Microsoft Graph — быстрый способ начать работу с API Microsoft Graph
Несколько лет назад Microsoft перешла с Live SDK на Microsoft Graph. Теперь в качестве API для доступа ко всем данным и информации платформы Microsoft 365 выступает Microsoft Graph [1, 2].
Начать работу в API Microsoft Graph можно несколькими способами. Самый простой из них — использовать Краткое руководство по Microsoft Graph, с помощью которого создаются новый App ID и App Secret для процесса аутентификации, и в итоге будет создан типовой проект.
(1) На первом шаге нужно определить язык программирования, который будет использоваться для создания приложения. Поскольку я предпочитаю Python, для создания примера приложения я воспользуюсь простым приложением Django.
Если Вы не знакомы с Django, можете прочитать одну из моих предыдущих статей, в которых максимально простым языком поясняются принципы работы Django. Если приложение будет создаваться с нуля, за необходимой справкой обратитесь к соответствующему руководству в Microsoft Docs.
(2) После выбора языка создаётся новый App ID с App Secret — они понадобятся позже для процесса авторизации.
Просмотреть список зарегистрированных приложений можно на портале Azure в каталоге Azure Active Directory.
(3) После выполнения команд, описанных в Кратком руководстве по Microsoft Graph, будет создано типовое приложение с готовой основной структурой и процессом аутентификации. Загрузите пример кода и сохраните его в словаре проекта.
Структура примера кода аналогична структуре обычного приложения Django. Файл oauth_settings.yml содержит настройки для аутентификации — требуемые конечные точки, App ID и App Secret.
Требования к установке
(4) До первого запуска приложения необходимо установить необходимые пакеты Python.
Простой способ установки всей среды определён в файле requirements.txt [3]. Поскольку для работы приложений иногда требуются определённые версии библиотеки, имеет смысл создать Виртуальную среду [4]. Для этого перейдите в каталог проекта и запустите следующую команду: virtualenv_graph. Будет создана Виртуальная среда.
python -m venv virtualenv_graph
В папке проекта появится новый каталог virtualenv_graph с копией интерпретатора Python. Для работы с только что созданной средой graph-tutorial её необходимо активировать, запустив пакетный файл activate:
graph-tutorialScriptsactivate.bat
После активации в начале командной строки появится имя вашей Виртуальной среды (в скобках). Так вы поймёте, что среда активирована. Все необходимые пакеты Python устанавливаются в среде следующей командой:
Migrate — распространение изменений на базу данных
(5) Следующая команда отображает используемую в приложении структуру модели на базу данных:
python manage.py migrate
В результате будут созданы определённые таблицы по умолчанию для используемых приложений Django: django.contrib.auth и django.contrib.session.
(6) Команда python manage.py runserver запускает облегчённый веб-сервер на локальной машине. Если не будет указано иное, локальный веб-сервер использует порт 8000 и имеет адрес 127.0.0.1.
Теперь можно входить в систему, используя регистрационные данные учётной записи на портале Office365.
OAuth 2.0 — как работает процесс регистрации
Для понимания того, что делает данный пример кода, нужно представлять, какие функции выполняет протокол OAuth 2.0.OAuth 2.0 — стандартный отраслевой протокол аутентификации, позволяющий пользователям предоставлять сторонним приложениям доступ к ресурсам пользователей без предоставления таким приложениям доступа к вашим постоянным учётным данным [5, 6].
Такую функциональность можно реализовать, так как уровень авторизации протокола OAuth отделяет роль клиента от роли владельца ресурса. Не очень понятно? Постараюсь объяснить, какие роли задействуются в потоке рабочих операций протокола OAuth и как они связаны друг с другом [5].
- Владелец ресурса: лицо, предоставляющее доступ к ресурсу. В нашем случае доступ к данным Microsoft Cloud через вашу учётную запись на платформе Microsoft 365 предоставляете приложению вы, то есть владельцем ресурса являетесь вы.
- Сервер ресурсов: место, в котором размещаются защищённые ресурсы.
- Клиент: приложение, запрашивающее доступ к ресурсу, в данном случае — только что скачанное нами приложение Django.
- Сервер авторизации: этот сервер предоставляет конечному пользователю (Владельцу ресурса) возможность аутентифицироваться. После правильно осуществленной авторизации Сервер авторизации создает маркер доступа к приложению.
Теперь рассмотрим, как в Python запускается рабочий поток авторизации с помощью приложения Template.
Запрос маркера доступа с Платформы удостоверений Microsoft
Как я уже сказал, вначале приложение должно отправить запрос на Сервер аутентификации. Поэтому нам нужно использовать версию протокола OAuth 2.0. для Платформы удостоверений Microsoft [7].
Нажатие кнопки Sign-in вызывает функцию sign_in в tutorial.views.py, которая для формирования URL-запроса, в свою очередь, вызывает функцию get_sign_in_url.На первом шаге потока операций авторизации клиентское приложение направляет пользователей к конечной точке /authorize. В запросе указываются [7]:
- ID приложения, назначенное вашему приложению в процессе регистрации;
- переменная scope, в которой определяются разрешения, запрашиваемые приложением у пользователя;
- URI перенаправления — расположение, в котором Сервер авторизации отправляет пользователя после успешной авторизации приложения и предоставления ему кода авторизации или маркера доступа.
Все параметры, необходимые для выполнения процесса авторизации, хранятся в YAML-файле oauth_settings.yml.
(3) После того как пользователь аутентифицируется и, соответственно, предоставит доступ приложению, Сервер аутентификации сформирует ответ с Кодом авторизации и перенаправит пользователя на указанный URI перенаправления.
(4) Имея App ID и App Secret, вы можете запросить у Сервера авторизации Маркер доступа и Маркер обновления.
(5) Маркер доступа разрешает доступ к API по крайней мере в той части, в которой требуемые разрешения были определены в переменной scope.
Таким образом, мы получили доступ к запрашиваемым ресурсам. Теперь надо понять, как извлечь интересующие нас данные.
Запрос данных с использованием Graph API
Для поиска соответствующих конечных точек данных используется Обозреватель Graph. В этом средстве разработчика уже реализован ряд запросов, связанных с вашей учётной записью и различными приложениями Microsoft. Если нужно найти информацию, не охватываемую такими запросами, обратитесь к соответствующим документам (например, для OneDrive).
Меня, в частности, интересуют данные, хранящиеся на моём облачном диске One Drive. Но общая концепция извлечения данных одинакова для SharePoint, OneNote, Outlook, Teams и многих других платформ.
При работе с другими платформами к переменной scope в файле oauth_settings.yml нужно добавить соответствующие разрешения. Процедура добавления разрешений описана здесь: Справка по разрешениям в Microsoft Graph. Для того чтобы можно было считывать и записывать файлы в One Drive, добавьте к переменной scope параметр Files.ReadWrite.All. Приведу пример: мне нужно получить информацию по всем файлам в папке /Bilder/Eigene Aufnahmen. Вместе с только что сгенерированным Маркером доступа я отправляю запрос GET на /drive/root:/:/children и получаю данные по всем файлам указанного пути.
И последнее, что делает функция просмотра one_drive, — формирует HTML-файл one_drive.html для распечатки только что полученных данных из API. Структура файла one_drive.html аналогична структуре файла calendar.html, уже имеющегося в типовом приложении.
Pictures uploaded to One Drive
Теперь нужно добавить функцию просмотра one_drive к модулю прокладки маршрута urls.py.
# from django.urls import path from . import views urlpatterns = [ . path(‘calendar’, views.calendar, name=’calendar’), path(‘one_drive’, views.one_drive, name=’one_drive’), ]
Теперь по адресу http://localhost:8000/one_drive выводится HTML-таблица со всеми файлами в папке /Bilder/Eigene Aufnahme.
Анализ и визуализация данных с помощью Plotly.
Для визуализации данных я использовал библиотеку Plotly. Если эта библиотека не установлена, установите Plotly, используя команду pip:
pip install plotly
Меня интересует время, когда были сделаны фотографии.Чтобы результат стал более наглядным, я сгруппирую фотографии по неделям, когда они были сделаны.
Для этого я добавляю новую пару «ключ — значение» в словарь files[‘values’], определяемый как календарная неделя даты создания. После этого я передаю значения словаря в кадр данных Pandas. В Pandas реализовано несколько методов управления кадрами данных, я воспользуюсь одним из них. Операция groupby группирует все записи по атрибуту CreationWeek, метод .count() осуществляет подсчёт количества всех вхождений записей.
Результат выводится в виде столбчатой диаграммы. Мы рассмотрели простой пример поэтапного создания собственного приложения для информационной панели (дашборда), в котором демонстрируется способ доступа к службам Microsoft.
Выводы
В этой статье я поделился опытом работы с API-интерфейсом Microsoft Graph. Мы узнали, как выполняются:
1) процесс аутентификации с использованием Платформы удостоверений Microsoft;
2) запрос данных через Graph API;
3) визуализация данных с использованием Plotly.
Помимо извлечения данных в интерфейсе Graph реализован широкий спектр функций POST. Добавление записей в календарь, загрузка файлов, создание нового канала Microsoft Team — все эти операции можно осуществлять через HTTP-запросы. Надеюсь, эта статья поможет вам в автоматизации процессов.
- Обзор Microsoft Graph
- Миграция с Live SDK на Microsoft Graph
- Установка Pip
- Виртуальная среда и пакеты
- Платформа авторизации OAuth 2.0
- Поток рабочих операций OAuth 2.0
- Платформа удостоверений Microsoft и последовательность кодов авторизации в OAuth 2.0
- Вызов защищенного API с веб-серверного приложения
Узнайте, как прокачаться в других специальностях или освоить их с нуля:
- Профессия Data Scientist
- Профессия Data Analyst
- Курс по Data Engineering
ПРОФЕССИИ
- Профессия Fullstack-разработчик на Python
- Профессия Java-разработчик
- Профессия QA-инженер на JAVA
- Профессия Frontend-разработчик
- Профессия Этичный хакер
- Профессия C++ разработчик
- Профессия Разработчик игр на Unity
- Профессия Веб-разработчик
- Профессия iOS-разработчик с нуля
- Профессия Android-разработчик с нуля
КУРСЫ
- Курс по Machine Learning
- Курс «Machine Learning и Deep Learning»
- Курс «Математика для Data Science»
- Курс «Математика и Machine Learning для Data Science»
- Курс «Python для веб-разработки»
- Курс «Алгоритмы и структуры данных»
- Курс по аналитике данных
- Курс по DevOps
Источник: habr.com