SHIELDRM SharePoint 연동 방식 마이그레이션 안내
본 문서는 SHIELDRM 서비스의 Microsoft 365 환경에서 사용 중인 SharePoint 연동 방식 변경에 대한 내용을 안내하기 위해 작성되었습니다. Microsoft의 기술 정책 변경에 따라, 기존의 Add-In 방식은 더 이상 지원되지 않으며, 이에 따라 SHIELDRM 서비스도 이벤트 리시버 기반의 새로운 방식으로 전환됩니다.
기존 Add-In 방식 및 이벤트 리시버 방식의 개요
SHIELDRM은 그동안 SharePoint와의 연동을 위해 Microsoft 365의 Add-In 방식을 사용해왔습니다.
이 방식은 .app
형태의 애드인을 각 SharePoint 사이트에 개별적으로 설치하고, 이를 통해 문서 생성·편집 등의 이벤트를 감지하는 구조입니다.
반면, 이벤트 리시버(Event Receiver) 방식은 Azure 기반의 중앙 수신 서버를 통해 이벤트를 직접 감지하며, 개별 사이트 설치 없이 통합적인 이벤트 관리를 지원합니다.
- 비교 도표
항목 | 기존 (종료 예정) | 변경 후 (표준 방식) |
---|---|---|
연동 방식 | Add-In (.app 설치 필요) | Event Receiver (중앙 수신 방식) |
설치 대상 | 각 SharePoint 사이트별 | 중앙 연동 |
종료 일자 | 2026년 4월 2일 | 해당 이전까지 전환 필요 |
Microsoft 정책 변경 및 SHIELDRM 서비스 방향
Microsoft는 2026년 4월 2일부로 Azure Access Control Service(ACS) 및 SharePoint Add-In 방식을 공식 종료한다고 공지하였습니다.
이에 따라 SHIELDRM은 다음과 같은 정책을 수립하였습니다:
- 기존 Add-In 방식을 사용하는 Microsoft365 메뉴는 순차적으로 종료됩니다.
- 모든 SHIELDRM 사용자 및 고객사는 이벤트 리시버 방식으로의 전환이 필요합니다.
- SHIELDRM 관리자 페이지 내 이벤트 리시버 메뉴가 신규로 제공되며, 기존 정책 및 사이트 정보는 해당 메뉴로 마이그레이션이 진행됩니다.
해당 전환 작업은 2026년 3월까지 완료되어야 하며, 이후 Add-In 방식의 정책은 작동하지 않습니다.
이벤트 리시버 방식으로의 마이그레이션 방법
이벤트 리시버 방식으로의 전환은 SHIELDRM 관리자 페이지에서 간단히 진행하실 수 있습니다.
1. 마이그레이션 메뉴 접근
- SHIELDRM 관리자 페이지에 로그인 후, [연동 관리 > Microsoft365] 메뉴로 진입합니다.
- 메뉴 상단에 "이벤트 리시버로 마이그레이션" 버튼 또는 안내 배너가 노출됩니다.
2. 유효성 검사 및 앱 동의 확인
- 마이그레이션 진행 전, 시스템은 자동으로 이벤트 리시버 지원 여부 및 사전 조건을 확인합니다.
- 앱 동의가 필요한 경우, 관리자에게 Microsoft 앱 권한 동의 URL이 제공됩니다.
3. 마이그레이션 실행
- 안내 팝업에서 마이그레이션 설명을 확인한 후, [확인] 버튼을 클릭하면 마이그레이션이 진행됩니다.
- 마이그레이션 중에는 기존 메뉴 일부 기능이 제한될 수 있으며, 완료 후 이벤트 리시버 메뉴만 표시됩니다.
4. 실패 시 대응
- 일부 사이트가 마이그레이션에 실패할 수 있으며, 이에 대한 재시도 및 실패 목록 확인 UI가 제공됩니다.
- 실패 사유는 상세 로그로 확인 가능하며, 필요 시 SHIELDRM 운영팀에 문의해주시기 바랍니다.