Aprimorando a segurança com alterações nas APIs do Bloco de Anotações de Classe do OneNote

Aplica-se a
Microsoft Teams Microsoft Teams para Educação

Importante

Agora você pode provisionar notebooks e classes em escala usando métodos alternativos descritos aqui: Provisionando classes em escala usando o PowerShell e o Microsoft Graph.

De acordo com a Microsoft Secure Future Initiative e para lidar com o crescente número de ameaças cibernéticas, estamos fazendo uma alteração na API pública para Blocos de Anotações de Classe do OneNote.  

O que é a atualização?

A partir de 31 de março de 2025, substituiremos o suporte para tokens de autenticação com permissões de aplicativo na API pública para Blocos de Anotações de Classe do OneNote não conectados a Grupos Unificados (também conhecidos como Grupos do Microsoft 365). 

Embora esses tokens somente de aplicativo sejam fáceis de usar, eles podem ser explorados mais facilmente quando comparados a métodos de autorização mais sofisticados. 

Como fazer saber se essa atualização afeta meu serviço?

  1. Seu serviço não será afetado por essas alterações se você não usar um aplicativo interno personalizado ou de terceiros (um "aplicativo") para executar operações nos Blocos de Anotações de Classe do OneNote (por exemplo, criação, provisionamento, backup) em sua escola ou distrito. 

  2. Seu serviço não será afetado por essas alterações se você usar um "aplicativo", mas ele executa operações somente usando permissões "delegadas" (também conhecidas como aplicativo+usuário).  

  3. Seu serviço não será afetado por essas alterações se você usar um "aplicativo", mas ele executa operações somente em blocos de anotações do Grupo Unificado conectados às classes no Microsoft Teams. 

  4. Seu serviço poderá ser afetado se você usar um "aplicativo" que executa operações em Blocos de Anotações de Classe do OneNote que não são blocos de anotações de Grupo Unificado conectados ao Teams. Como exemplo:

    1. Seu serviço será afetado se você tiver um aplicativo interno personalizado que aproveite as URLs raiz de serviço para blocos de anotações no OneDrive for Business e nos blocos de anotações do site do SharePoint, conforme documentado aqui. 

    2. Seu serviço será afetado se você tiver um aplicativo interno personalizado que execute operações em Blocos de Anotações de Classe do OneNote que não sejam blocos de anotações de Grupo Unificado conectados ao Teams e use tokens associados a qualquer um dos seguintes escopos (permissões):

      1. Notes.Read.All e Notes.ReadWrite.All conforme documentado aqui.
      2. Notes.ReadWrite.CreatedByApp conforme documentado aqui.

Que ação é necessária de minha parte?

Antes de 31 de março de 2025, os aplicativos de terceiros que usam tokens somente de aplicativo precisarão migrar para usar uma forma mais segura de autorização. Essa atualização é necessária para aumentar a segurança de seus dados. 

Aqui estão as etapas que você pode seguir para introduzir uma forma mais segura de autorização:

  1. Se você depender de um parceiro integrador de sistemas ou de outra solução de terceiros para executar operações em Blocos de Anotações de Classe do OneNote que não são do Teams em seu locatário, compartilhe este boletim de suporte com eles para que possam tomar outras medidas. 
  2. Se você tiver seu próprio aplicativo interno personalizado que executa operações em Blocos de Anotações de Classe do OneNote, que não são blocos de anotações de Grupo Unificado conectados ao Teams e usam tokens somente de aplicativo, você precisará fazer a transição para usar contas de usuário de Administrador de Locatário Global ou Proprietário do OneDrive para autorização para seu aplicativo. 
  3. Se você for um parceiro integrador de sistemas, o aplicativo exato que você executou anteriormente como somente aplicativo agora pode ser executado por uma conta de usuário de Administrador de Locatário Global. Para fazer isso, você pode precisar de uma conta de usuário de Administrador de Locatário Global provisionada pelo locatário que usa o aplicativo. 

O que acontecerá se eu não tomar medidas?

As solicitações para os notebooks no OneDrive for Business e nos pontos de extremidade dos notebooks do site do SharePoint que usam tokens com permissões de aplicativo retornarão erros 401 não autorizados no final de março. 

Agradecemos sua cooperação em fazer essas alterações necessárias para garantir a segurança de seus dados. Quaisquer dúvidas ou preocupações podem ser enviadas para apponly-cnb@microsoft.com.