Повышение безопасности путем изменения API записной книжки OneNote для занятий

Применяется к
Microsoft Teams Microsoft Teams для образования

Важно

Теперь можно предоставлять записные книжки и классы в большом масштабе с помощью альтернативных методов, описанных в статье Подготовка классов в масштабе с помощью PowerShell и Microsoft Graph.

В соответствии с инициативой Microsoft Secure Future и для борьбы с растущим числом киберугроз мы вносим изменения в общедоступный API записных книжек OneNote для занятий.  

Что представляет собой обновление?

С 31 марта 2025 г. мы прекращаем поддержку маркеров проверки подлинности с разрешениями приложений в общедоступном API для записных книжек OneNote для занятий, не подключенных к единым группам (также известным как группы Microsoft 365). 

Хотя эти токены только для приложений просты в использовании, их может быть легче использовать по сравнению с более сложными методами авторизации. 

Разделы справки узнают, повлияет ли это обновление на мою службу?

  1. Эти изменения не повлияют на вашу службу , если вы не используете стороннее или пользовательское внутреннее приложение (далее — "приложение") для выполнения операций с записными книжками OneNote для занятий (например, создания, подготовки, резервного копирования) в учебном заведении или округе. 

  2. Эти изменения не повлияют на вашу службу , если вы используете "приложение", но она выполняет операции только с использованием "делегированных" (также известных как приложение+пользователь) разрешений.  

  3. Если вы используете "приложение", эти изменения не повлияют на вашу службу, но она выполняет операции только с записными книжками единой группы, подключенными к классам в Microsoft Teams. 

  4. Использование "приложения", выполняющего операции с записными книжками OneNote для занятий, которые не являются записными книжками единой группы, подключенными к Teams, могут повлиять на вашу службу. В качестве примера:

    1. Эта проблема повлияет на вашу службу, если у вас есть настраиваемое внутреннее приложение, использующее корневые URL-адреса службы для записных книжек в OneDrive для бизнеса и записных книжках на сайте SharePoint, как описано здесь

    2. Это повлияет на вашу службу, если у вас есть пользовательское внутреннее приложение, которое выполняет операции с записными книжками OneNote для занятий, которые не являются записными книжками единой группы, подключенными к Teams, и использует маркеры, связанные с любой из следующих областей (разрешений):

      1. Notes.Read.All и Notes.ReadWrite.All как описано здесь.
      2. Notes.ReadWrite.CreatedByApp как описано здесь.

Какие действия требуются с моей стороны?

До 31 марта 2025 г. сторонние приложения, использующие токены только для приложений, должны будут перейти на использование более безопасной формы авторизации. Это обновление необходимо для повышения безопасности ваших данных. 

Ниже приведены действия, которые можно предпринять для внедрения более безопасной формы авторизации.

  1. Если вы пользуетесь услугами партнера-системного интегратора или другого стороннего решения для выполнения операций с записными книжками OneNote для занятий, отличными от Teams, в своем клиенте, поделитесь с ними этим бюллетенем поддержки, чтобы они могли предпринять дальнейшие действия. 
  2. Если у вас есть собственное внутреннее приложение, которое выполняет операции с записными книжками OneNote для занятий, но не подключено к Teams и использует маркеры только для приложений, вам потребуется перейти к использованию учетных записей глобального администратора клиента или владельца OneDrive для авторизации в приложении. 
  3. Если вы являетесь партнером-системным интегратором, то приложение, которое вы ранее запускали только в виде приложения, теперь может запускать учетная запись глобального администратора клиента. Для этого может потребоваться учетная запись глобального администратора клиента, подготовленная клиентом с помощью приложения. 

Что произойдет, если не предпринять никаких действий?

Запросы к записным книжкам в OneDrive для бизнеса и на сайте SharePoint Конечные точки записных книжек с использованием маркеров с разрешениями приложений вернут 401 несанкционированную ошибку в конце марта. 

Мы ценим вашу помощь в внесении этих необходимых изменений для обеспечения безопасности ваших данных. Любые вопросы или проблемы можно отправлять по адресу apponly-cnb@microsoft.com.