Microsoft가 모든 제품 및 서비스에서 보안 태세를 강화함에 따라 이전에 API를 사용하여 수업용 전자 필기장을 프로비전하기 위해 앱 전용 권한에 의존했던 고객에게 영향을 미칠 수 있는 API 기능에 대한 최근 변경 사항이 있습니다.
지원되는 대체 방법에 따라 Microsoft Graph API를 사용하여 사이트 및 Notebook을 대규모로 프로비전할 수 있습니다. 이 문서에서는 단계를 간략하게 설명하고 관련 설명서에 대한 링크를 제공합니다.
개요
수업용 전자 필기장 및 SharePoint 사이트를 대규모로 계속 프로비전하려면 다음을 수행합니다.
- 새 사이트를 만들 때 CreateEducationClass API 사용(클래스당 하나의 그룹/사이트)
- 기존 사이트의 경우 SharePoint CreatePermission API 를 사용하여 해당 사이트에 OneNote 수업용 전자 필기장 AppId 권한을 부여합니다.
- 위의 단계가 완료되면 기존 수업용 전자 필기장 기능이 복원되고 GetClassNotebooks, AddTeacher 및 addStudent 와 같은 API 호출이 예상대로 작동해야 합니다.
단계별 지침
1. CreateEducationClass를 사용하여 새 사이트 만들기
CreateEducationClass API를 사용하여 각 수업에 대해 새 Microsoft 365 그룹 및 연결된 SharePoint 사이트를 만듭니다.
- 이 API는 한 번의 호출로 그룹, 사이트 및 관련 리소스를 프로비전합니다.
- 사이트를 만든 후 기존 API를 사용하여 Notebook 및 권한을 관리할 수 있습니다.
참조: CreateEducationClass API 설명서
2. 기존 사이트에 사용 권한 부여
기존 그룹 또는 사이트의 경우 Sites.Selected 권한 모델을 사용하여 수업용 전자 필기장 앱에 액세스 권한을 명시적으로 부여해야 합니다.
필요한 권한
- Sites.Selected scope를 사용한 앱 전용 액세스입니다.
- EDU OneNote 앱에 사이트에 대한 모든 권한을 부여합니다.
샘플 요청
| POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Content-Type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", //대상 응용 프로그램의 클라이언트 ID "displayName": "EDU OneNote" //대상 응용 프로그램의 표시 이름 } }] } |
|---|
참조:
SPO 사이트에 대한 Sites.Selected 권한을 사용하는 애플리케이션을 개발합니다.
Microsoft 365 개발자 블로그: 이제 Microsoft Graph에서 특정 SharePoint 사이트 모음에서 앱 액세스 제어 기능을 사용할 수 있습니다.
3. Notebook 관리에 기존 API 사용
사용 권한이 올바르게 구성되면 다음 API와 같은 기존 수업용 전자 필기장 기능이 이전과 같이 계속 작동해야 합니다.
GetClassNotebooks
AddTeacher
AddStudent
CreateClassNotebook
- 참고: 위에서 설명한 대로 새 그룹/사이트의 경우 CreateEducationClass 를 대신 사용합니다.