Не так давно у 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.
Криптовалюта The Graph обзор. Токен GRT обзор и какие перспективы?
Сам по себе сервис 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 (чтобы получить токен доступа).
Introducing the Knowledge Graph
Из минусов – вам необходим браузер и в Graph Explorere вы можете работать только с Graph API .
Развернутая документация по использованию Graph Explorer доступна по этой ссылке.
Для того, чтобы запустить Graph Explorer нужно:
2. Аутентифицироваться под вашей учетной записью.
Либо вы можете работать под “синтетической” учетной записью. Для данной записи настроен некий набор объектов, к которым вы можете получать доступ выполняя соответствующие запросы.
Пример 1. Получение данных своего профиля пользователя
В левом нижнем углу вам доступен перечень запросов, которые вы можете отправить к Graph API.
Когда вы выберите соответствующий запрос, то его преднастроенные значения перенесутся в основную обасть Graph Explorer.
Что 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
Источник: temofeev.ru
Graph 4.4.2.543
Отдельного внимания достойна возможность экспорта системы координат для продолжения работы с ней в других программах. На выбор пользователя она может быть экспортирована в формате OLE-объекта или в качестве изображения. Бесплатная утилита Graph 4.4.2.543 позволяет также отображать таблицы с расчётными значениями для каждой из математических функций, вносить на графики небольшие текстовые комментарии, строить собственные функции, делать анимационные графики и массу других действий. Программа способна рисовать не только стандартные функции, но также параметрические функции и полярные функции, касательные, точечные серии, штриховки и связи. Также в ней пользователь может оценить функцию для данной точки, нарисовать график с помощью мыши и многое другое.
Несколько слов об интерфейсе приложения Graph. Когда программа запустится, вы увидите её главное окно. В этом окне отображается графическая область с системой координат, в которой будут находиться выстраиваемые пользователем графики.
Вы можете использовать меню или кнопки на панели инструментов для отображения различных диалоговых окон для вставки функции, редактирования функции, удаления функции и т.д. В справочной информации пользователь может найти описание всех пунктов меню. Панель инструментов можно настроить на усмотрение пользователя, щелкнув правой кнопкой мыши и выбрав «Настроить панель инструментов». После вы сможете добавить на панель инструментов некоторые функции и команды. Строка состояния внизу окна отображает различные всплывающие подсказки или другую информацию.
Вы можете добавлять новые элементы в систему координат из меню «Функция». Например, если вы хотите добавить новую функцию, вам необходимо использовать меню Функция → Вставить функцию. «Список функций» слева отображает перечень функций, касательных, точечных рядов, штриховок и отношений, которые добавлены пользователем.
Если вы хотите изменить что-либо в данном списке, просто выберите необходимый пункт или воспользуйтесь меню «Функции». Вы также можете щелкнуть правой кнопкой мыши по элементу в списке, чтобы открыть контекстное меню с доступными командами. Элемент может редактироваться двойным щелчком по нему. Более подробную информацию вы можете получить в справочной документации к программе Graph. Предлагаем ознакомиться основными особенностями данного приложения.
Особенности Graph 4.4.2.543
- Простая и бесплатная программа для построения графиков функций.
- Мультиязычный интерфейс с возможностью выбора русского языка отображения меню.
- Приложение дает возможность составлять самостоятельно графики различных функций.
- Возможность дополнить графики дополнительными точками, пунктирными линиями, касательными и другими элементами.
- Созданный график пользователь может сопроводить произвольными комментариями, которые размещаются рядом.
- Графики можно копировать, экспортировать в другие приложения и сохранять как изображения или документы pdf.
Подводя итоги, можно сказать, что утилита Graph 4.4.2.543 – это отличный инструмент, освоить который может каждый желающий за несколько минут. Здесь есть всё необходимое для комфортной работы пользователя и легкого построения графиков функций. Эта программа будет полезна для учеников школ и вузов, а также для самих преподавателей.шаблоны для dle 11.2
Источник: 4creates.com